视图

同一张表可以有多个视图。例如,在网格中录入任务,在看板中追踪任务状态。切换视图不会复制记录。

同一张表,多种视图

修改 Sheets 课程的状态,再切换视图。每个视图都使用同一组记录。

示例学习计划 · 2026 年 9 月

课程状态日期
Sheets未开始
Docs进行中
Slides已完成
Bases进行中

共享记录: 4 · Sheets: 未开始

视图适合的场景主要配置
网格 Grid按行编辑、筛选和排序冻结字段、行高、字段宽度
看板 Kanban按状态或负责人分组groupFieldId
日历 Calendar按日期安排记录startDateFieldId,可选结束日期
甘特图 Gantt规划工期与依赖开始和结束日期,以及可选进度和依赖字段
画廊 Gallery展示图片和内容卡片封面、标题和卡片字段
透视 Pivot汇总统计与图表需要仪表盘插件

以下示例假设已经取得 table。请将字段 ID 替换为真实字段 ID;日期或分组类字段需要先创建,再配置使用这些字段的视图。

创建视图

TypeScript
const grid = table.createView('All records', univerAPI.Enum.BaseViewType.Grid)const kanban = table.createView(  'By status',  univerAPI.Enum.BaseViewType.Kanban,  {    view: {      config: { groupFieldId: 'status' },    },  },)

在 UI 中激活视图

TypeScript
const baseUI = univerAPI.getBaseUI()await baseUI.activateTable(table.getId())await baseUI.activateView(kanban.getId())

配置视图规则

TypeScript
kanban.setGroup([  { fieldId: 'status', direction: univerAPI.Enum.BaseSortDirection.ASC },])kanban.setFilter({  conjunction: univerAPI.Enum.BaseFilterConjunction.AND,  conditions: [    { fieldId: 'archived', operator: univerAPI.Enum.BaseFilterOperator.IS, operand: false },  ],})

视图上的字段设置控制可见性、宽度和卡片展示方式,不会改变底层的表结构。

日历与日期字段

TypeScript
const calendar = table.createView('Schedule', univerAPI.Enum.BaseViewType.Calendar, {  view: {    config: { startDateFieldId: 'startDate', endDateFieldId: 'endDate', mode: 'month' },  },})

日历需要开始日期字段。甘特图还需要结束日期字段,并支持工作日、进度和依赖关系。画廊使用 card 配置标题,以及每张卡片展示的字段。

排序和字段显示

TypeScript
grid.setSort([{ fieldId: 'priority', direction: univerAPI.Enum.BaseSortDirection.DESC }])grid.setFieldVisible('internalNotes', false)grid.setFieldWidth('title', 280)

筛选、排序、分组和字段显示都属于当前视图,均不会删除底层的记录或字段。

条件着色

以下规则将分数高于 80 的记录标记出来:

TypeScript
const score = table.addField('Score', univerAPI.Enum.BaseFieldType.Number)grid.setConditionalColorRules([{  id: 'high-score',  target: univerAPI.Enum.BaseConditionalColorTarget.ROW,  fieldId: score.getId(),  operator: univerAPI.Enum.BaseConditionalColorOperator.GREATER_THAN,  operand: 80,  color: '#dcfce7',}])

规则按数组顺序决定优先级,传入 [] 可清空规则。目标可以是单元格、整行或整列;整列着色不判断条件。

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.