@univerjs-pro/sheets-pivot v0.5.1 • Docs
Class: FWorkbookSheetsPivotMixin
FBase
is a base class for all facade classes.
It provides a way to extend classes with static and instance methods.
The _initialize
as a special method that will be called after the constructor. You should never call it directly.
Extends
Implements
Constructors
new FWorkbookSheetsPivotMixin()
new FWorkbookSheetsPivotMixin(
_workbook,
_injector,
_resourceLoaderService,
_selectionManagerService,
_univerInstanceService,
_commandService,
_permissionService,
_logService): FWorkbookSheetsPivotMixin
Parameters
Parameter | Type |
---|---|
_workbook | Workbook |
_injector | Injector |
_resourceLoaderService | IResourceLoaderService |
_selectionManagerService | SheetsSelectionsService |
_univerInstanceService | IUniverInstanceService |
_commandService | ICommandService |
_permissionService | IPermissionService |
_logService | ILogService |
Returns
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:27
Properties
Property | Modifier | Type | Inherited from | Defined in |
---|---|---|---|---|
_commandService | readonly | ICommandService | FWorkbook ._commandService | submodules/univer/packages/sheets/src/facade/f-workbook.ts:33 |
_injector | readonly | Injector | FWorkbook ._injector | submodules/univer/packages/sheets/src/facade/f-workbook.ts:29 |
_logService | readonly | ILogService | FWorkbook ._logService | submodules/univer/packages/sheets/src/facade/f-workbook.ts:35 |
_permissionService | readonly | IPermissionService | FWorkbook ._permissionService | submodules/univer/packages/sheets/src/facade/f-workbook.ts:34 |
_resourceLoaderService | readonly | IResourceLoaderService | FWorkbook ._resourceLoaderService | submodules/univer/packages/sheets/src/facade/f-workbook.ts:30 |
_selectionManagerService | readonly | SheetsSelectionsService | FWorkbook ._selectionManagerService | submodules/univer/packages/sheets/src/facade/f-workbook.ts:31 |
_univerInstanceService | readonly | IUniverInstanceService | FWorkbook ._univerInstanceService | submodules/univer/packages/sheets/src/facade/f-workbook.ts:32 |
_workbook | readonly | Workbook | FWorkbook ._workbook | submodules/univer/packages/sheets/src/facade/f-workbook.ts:28 |
id | readonly | string | FWorkbook .id | submodules/univer/packages/sheets/src/facade/f-workbook.ts:25 |
Methods
_initialize()
_initialize(): void
Returns
void
Inherited from
Defined in
submodules/univer/packages/core/src/facade/f-base.ts:33
addPivotTable()
addPivotTable(
sourceInfo,
positionType,
anchorCellInfo): Promise<undefined | FPivotTable>
Parameters
Parameter | Type | Description |
---|---|---|
sourceInfo | IUnitRangeName & { subUnitId : string ; } | The source data range info of the pivot table. |
positionType | PositionType | whether new a sheet or insert a pivot table to the existing sheet. |
anchorCellInfo | IPivotCellPositionInfo | The target cell info of the pivot table. |
Returns
Promise
<undefined
| FPivotTable
>
The added pivot table id.
Description
Add a pivot table to the Workbook.
Example
// should ensure the sheet range {0,0,8,6} is not empty
const fWorkbook = univerAPI.getActiveWorkbook()
const unitId = fWorkbook.getId()
const fSheet = fWorkbook.getActiveSheet();
const subUnitId = fSheet.getSheetId()
const sheetName = fSheet.getSheetName();
const sourceInfo = {
unitId,
subUnitId,
sheetName,
range: {
startRow: 0,
endRow: 8,
startColumn: 0,
endColumn: 6
}
}
const anchorCellInfo = {
unitId,
subUnitId,
row: 0,
col: 8
}
const fp = await fWorkbook.addPivotTable(sourceInfo, 'exiting', anchorCellInfo)
// the addPivotTable is async, you can add pivot fields after the pivot table is added
// in the future, we will support pivot table added event, you can add pivot fields in the event handler
setTimeout(function() {
fp.addField(1, 2)
fp.addField(1, 3)
}, 1000)
Implementation of
IFWorkbookSheetsPivotMixin
.addPivotTable
Overrides
FWorkbook.addPivotTable
Defined in
packages/sheets-pivot/src/facade/f-workbook.ts:73
create()
create(
name,
rows,
column): FWorksheet
Create a new worksheet and returns a handle to it.
Parameters
Parameter | Type | Description |
---|---|---|
name | string | Name of the new sheet |
rows | number | How may rows would the new sheet have |
column | number | How many columns would the new sheet have |
Returns
The new created sheet
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:94
deleteSheet()
deleteSheet(sheet): void
Deletes the specified worksheet.
Parameters
Parameter | Type | Description |
---|---|---|
sheet | FWorksheet | The worksheet to delete. |
Returns
void
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:189
getActiveRange()
getActiveRange(): null | FRange
Returns the selected range in the active sheet, or null if there is no active range.
Returns
null
| FRange
the active range
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:303
getActiveSheet()
getActiveSheet(): FWorksheet
Get the active sheet of the workbook.
Returns
The active sheet of the workbook
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:72
getId()
getId(): string
Returns
string
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:42
getName()
getName(): string
Returns
string
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:46
getPivotTableByCell()
getPivotTableByCell(
unitId,
subUnitId,
row,
col): undefined | FPivotTable
Parameters
Parameter | Type | Description |
---|---|---|
unitId | string | The unit id of workbook. |
subUnitId | string | The sheet id, which pivot table belongs to. |
row | number | The checked row. |
col | number | The checked column. |
Returns
undefined
| FPivotTable
The pivot table id or undefined.
Description
Get the pivot table id by the cell.
Implementation of
IFWorkbookSheetsPivotMixin
.getPivotTableByCell
Overrides
FWorkbook.getPivotTableByCell
Defined in
packages/sheets-pivot/src/facade/f-workbook.ts:93
getSheetByName()
getSheetByName(name): null | FWorksheet
Get a worksheet by sheet name.
Parameters
Parameter | Type | Description |
---|---|---|
name | string | The name of the sheet to get. |
Returns
null
| FWorksheet
The worksheet with given sheet name
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:139
getSheetBySheetId()
getSheetBySheetId(sheetId): null | FWorksheet
Get a worksheet by sheet id.
Parameters
Parameter | Type | Description |
---|---|---|
sheetId | string | The id of the sheet to get. |
Returns
null
| FWorksheet
The worksheet with given sheet id
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:125
getSheets()
getSheets(): FWorksheet[]
Gets all the worksheets in this workbook
Returns
An array of all the worksheets in the workbook
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:81
getSnapshot()
getSnapshot(): IWorkbookData
Returns
{IWorkbookData}
Deprecated
use ‘save’ instead.
Memberof
FWorkbook
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:63
insertSheet()
insertSheet(): FWorksheet
Inserts a new worksheet into the workbook. Using a default sheet name. The new sheet becomes the active sheet
Returns
The new sheet
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:167
onBeforeCommandExecute()
onBeforeCommandExecute(callback): IDisposable
Register a callback that will be triggered before invoking a command targeting the Univer sheet.
Parameters
Parameter | Type | Description |
---|---|---|
callback | CommandListener | the callback. |
Returns
A function to dispose the listening.
Inherited from
FWorkbook
.onBeforeCommandExecute
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:215
onCommandExecuted()
onCommandExecuted(callback): IDisposable
Register a callback that will be triggered when a command is invoked targeting the Univer sheet.
Parameters
Parameter | Type | Description |
---|---|---|
callback | CommandListener | the callback. |
Returns
A function to dispose the listening.
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:230
onSelectionChange()
onSelectionChange(callback): IDisposable
Parameters
Parameter | Type |
---|---|
callback | (selections ) => void |
Returns
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:240
redo()
redo(): Promise<boolean>
Returns
Promise
<boolean
>
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:205
save()
save(): IWorkbookData
save workbook snapshot data, including conditional formatting, data validation, and other plugin data.
Returns
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:53
setActiveRange()
setActiveRange(range): void
Sets the active selection region for this sheet.
Parameters
Parameter | Type | Description |
---|---|---|
range | FRange | The range to set as the active selection. |
Returns
void
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:274
setActiveSheet()
setActiveSheet(sheet): FWorksheet
Sets the given worksheet to be the active worksheet in the workbook.
Parameters
Parameter | Type | Description |
---|---|---|
sheet | FWorksheet | The worksheet to set as the active worksheet. |
Returns
The active worksheet
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:153
setEditable()
setEditable(value): void
Used to modify the editing permissions of the workbook. When the value is false, editing is not allowed.
Parameters
Parameter | Type | Description |
---|---|---|
value | boolean | editable value want to set |
Returns
void
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:261
undo()
undo(): Promise<boolean>
Returns
Promise
<boolean
>
Inherited from
Defined in
submodules/univer/packages/sheets/src/facade/f-workbook.ts:200
extend()
static extend(source): void
Parameters
Parameter | Type |
---|---|
source | any |
Returns
void
Inherited from
Defined in
submodules/univer/packages/core/src/facade/f-base.ts:35