weboffice-js-sdk 2.0.5-beta.7 → 2.0.5-beta.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -162,6 +162,8 @@ export interface ClipboardPasteParams {
162
162
  }
163
163
  export type SheetAppendDataAxis = 'row' | 'column';
164
164
  export interface SheetSelection {
165
+ /** 当前 iframe runtime 内稳定的选区标识。 */
166
+ id: string;
165
167
  getRange: (value?: SheetRangeValue) => Promise<SheetRangeFacade | null>;
166
168
  setRange: (value: SheetRangeValue | null) => Promise<void>;
167
169
  }
@@ -627,6 +629,12 @@ export interface SheetRangeFacade {
627
629
  column: number;
628
630
  rowCount: number;
629
631
  columnCount: number;
632
+ getBounding: () => Promise<{
633
+ left: number;
634
+ top: number;
635
+ width: number;
636
+ height: number;
637
+ } | null>;
630
638
  getText: (format?: 'plain' | 'matrix') => Promise<string | string[][]>;
631
639
  setText: (text: SheetRangeText) => Promise<void>;
632
640
  getHtml: () => Promise<string>;
@@ -675,6 +683,7 @@ export interface SheetWorksheetFacade {
675
683
  sheet: string;
676
684
  ranges: SheetRangeValue[] | null;
677
685
  }) => void) => () => void;
686
+ /** @deprecated 先 await worksheet.getRange(range),再调用 range?.getBounding()。 */
678
687
  getBounding: (range: SheetRangeValue) => Promise<{
679
688
  left: number;
680
689
  top: number;
@@ -45,12 +45,19 @@ export type EditorFacadeContractAssertions = [
45
45
  Assert<IsAssignable<NonNullable<OfficeSDK['text']>['apply'], (format: Partial<EditorTextFormat>, range?: PresentationTextRangeValue) => Promise<Partial<EditorTextFormat>>>>,
46
46
  Assert<IsAssignable<NonNullable<OfficeSDK['activeSheet']>['getSelections'], () => Promise<SheetSelection[] | null>>>,
47
47
  Assert<IsAssignable<NonNullable<OfficeSDK['activeSheet']>['getRange'], (value: SheetRangeValue) => Promise<SheetRangeFacade | null>>>,
48
+ Assert<IsEqual<SheetRangeFacade['getBounding'], () => Promise<{
49
+ left: number;
50
+ top: number;
51
+ width: number;
52
+ height: number;
53
+ } | null>>>,
48
54
  Assert<IsAssignable<NonNullable<OfficeSDK['selections']>['getAll'], () => Promise<SheetRangeValue[]>>>,
49
55
  Assert<IsAssignable<NonNullable<OfficeSDK['charts']>['addChartFromSelection'], (params?: import('./OfficeSDK').AddChartFromSelectionParams) => Promise<AddChartFromSelectionResult | undefined>>>,
50
56
  Assert<IsAssignable<PresentationSelection['getSelectedShapes'], (ids?: string[]) => Promise<PresentationShape[] | null>>>,
51
57
  Assert<IsAssignable<NonNullable<OfficeSDK['zoom']>['setPercentage'], (percentage: number) => Promise<void>>>,
52
58
  Assert<IsAssignable<NonNullable<OfficeSDK['eventSubscription']>['addLoadedListener'], (listener: () => void) => () => void>>,
53
59
  Assert<IsEqual<SheetSelection['getRange'], (value?: SheetRangeValue) => Promise<SheetRangeFacade | null>>>,
60
+ Assert<IsEqual<SheetSelection['id'], string>>,
54
61
  Assert<IsEqual<PresentationShapeBase['setFill'], (fill: import('./OfficeSDK').PresentationShapeFill) => Promise<void>>>,
55
62
  Assert<IsEqual<PresentationShapeBase['remove'], () => Promise<void>>>,
56
63
  Assert<IsEqual<PresentationTableItem['getCell'], (row: number, column: number) => Promise<PresentationTableCell | null>>>,