# 数据类型

> Facade 方法、快照、单元格和富文本使用的数据结构。

- Human documentation: [https://docs.univer.ai/zh-CN/reference/types](https://docs.univer.ai/zh-CN/reference/types)

- Agent Markdown: [https://docs.univer.ai/zh-CN/reference/types.md](https://docs.univer.ai/zh-CN/reference/types.md)

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.0.0-rc.0`

- Source: [types/index.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/types/index.zh-CN.mdx)

---

使用这些类型构造 API 参数、理解返回数据并保存编辑器快照。各类型页面包含导入方式、定义、字段和相关类型。

| 用途       | 类型                                                                                                                                                                                    |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 单元格内容    | [CellValue](https://docs.univer.ai/zh-CN/reference/types/cell-value.md) · [ICellData](https://docs.univer.ai/zh-CN/reference/types/cell-data.md)                                                                                                    |
| 单元格坐标与格式 | [IRange](https://docs.univer.ai/zh-CN/reference/types/range.md) · [IStyleData](https://docs.univer.ai/zh-CN/reference/types/style-data.md)                                                                                                          |
| 电子表格快照   | [IWorkbookData](https://docs.univer.ai/zh-CN/reference/types/workbook-data.md) · [IWorksheetData](https://docs.univer.ai/zh-CN/reference/types/worksheet-data.md)                                                                                   |
| 文档与富文本   | [IDocumentData](https://docs.univer.ai/zh-CN/reference/types/document-data.md) · [IDocumentBody](https://docs.univer.ai/zh-CN/reference/types/document-body.md) · [ITextRun](https://docs.univer.ai/zh-CN/reference/types/text-run.md) · [ITextStyle](https://docs.univer.ai/zh-CN/reference/types/text-style.md) |
| 演示文稿     | [ISlideData](https://docs.univer.ai/zh-CN/reference/types/slide-data.md) · [ISlidePage](https://docs.univer.ai/zh-CN/reference/types/slide-page.md)                                                                                                 |
| 画板       | [IBoardData](https://docs.univer.ai/zh-CN/reference/types/board-data.md)                                                                                                                                             |
| 多维表格     | [IBaseSnapshot](https://docs.univer.ai/zh-CN/reference/types/base-snapshot.md)                                                                                                                                       |
| PDF 单元   | [IPdfUnitData](https://docs.univer.ai/zh-CN/reference/types/pdf-unit-data.md)                                                                                                                                        |
| 应用外观     | [Theme](https://docs.univer.ai/zh-CN/reference/types/theme.md)                                                                                                                                                       |

`IRange` 使用从零开始的单元格坐标，起止位置均包含在范围内。`ICellData` 包含普通值、公式、富文本和样式引用。快照描述已保存的状态；修改编辑器中的实时内容，请使用 [Facade 方法](https://docs.univer.ai/zh-CN/reference/facade/univer.md)。

插件配置请查看对应的[功能包](https://docs.univer.ai/zh-CN/reference.md#configuration)。事件回调的数据结构见[事件](https://docs.univer.ai/zh-CN/reference/facade/events.md)。方法页面也会链接到所用的其他参数和返回值类型。