API Reference

Sheets Table

Packages@univerjs/sheets-table

Facade APIs for working with Univer Sheets tables from FWorkbook and FWorksheet.

Import @univerjs/sheets-table/facade before using these APIs in plugin mode.

Overview

FWorkbook

MethodSignature
getTableInfogetTableInfo(tableId: string): ITableInfoWithUnitId | undefined
getTableListgetTableList(): ITableInfoWithUnitId[]
addTableaddTable(subUnitId: string, tableName: string, rangeInfo: ITableRange, tableId?: string, options?: ITableOptions): Promise<string | undefined>
removeTableremoveTable(tableId: string): Promise<boolean>
getTableInfoByNamegetTableInfoByName(tableName: string): ITableInfoWithUnitId | undefined
setTableFiltersetTableFilter(tableId: string, column: number, filter: ITableFilterItem | undefined): Promise<boolean>

FWorksheet

MethodSignature
addTableaddTable(tableName: string, rangeInfo: ITableRange, tableId?: string, options?: ITableOptions): Promise<boolean> | boolean
setTableFiltersetTableFilter(tableId: string, column: number, filter: ITableFilterItem): Promise<boolean>
removeTableremoveTable(tableId: string): Promise<boolean>
setTableRangesetTableRange(tableId: string, rangeInfo: ITableRange): Promise<boolean>
setTableNamesetTableName(tableId: string, tableName: string): Promise<boolean> | boolean
getSubTableInfosgetSubTableInfos(): ITableInfoWithUnitId[]
resetFilterresetFilter(tableId: string, column: number): Promise<boolean>
getTableByCellgetTableByCell(row: number, column: number): ITableInfoWithUnitId | undefined
addTableThemeaddTableTheme(tableId: string, themeStyleJSON: IRangeThemeStyleJSON): Promise<boolean>

Examples

TypeScript
const fWorkbook = univerAPI.getActiveWorkbook()const fWorksheet = fWorkbook?.getActiveSheet()await fWorksheet?.addTable('SalesTable', {  startRow: 0,  startColumn: 0,  endRow: 10,  endColumn: 4,})const table = fWorksheet?.getTableByCell(0, 0)
Source: @univerjs/sheets-table

How is this guide?

© 2026 DreamNum Co., Ltd.