---
order: 3
navTitle: 单元格类型
---
# 单元格类型

**单元格类型**是Excel表单提供的各种单元格的输入方式。报表填报应用支持多种**单元格类型**，用于应对各种填报场景。选用合适的**单元格类型**，既能增强用户体验，又能控制数据输入的规范。

|默认类型单元格|日期类型单元格|
|---|---|
|![默认类型单元格](./images/2024-05-21-17-23-35.png)|![日期类型单元格](./images/2024-05-17-10-54-27.png)|

## 基本类型{#basic-type}

报表填报应用支持8种**基本类型**，分别为：文本、数值、下拉框、日期、时间、选择面板、勾选框和搜索框。在体验上与SuperPage的输入组件类似，属性配置可参考[输入组件](../../../app/superpage/components/input/textinput.md)。不同的是，在报表填报应用中无需手动建模和绑定字段，支持根据单元格的类型及属性自动生成模型和字段。

![单元格类型](./images/2024-05-21-18-40-25.png)

示例地址：[单元格类型](https://demo.succbi.com/v5/DEMO/app/ci.app?:id=cell-type&:sheet=BasicType)

## 其他类型{#other-type}

除基本类型外，报表填报应用还支持了一些特殊的**单元格类型**，比如**字格**和**进度条**等，可以在特定场景下满足用户需求。

### 链接{#link}

链接单元格用于需要在表格中添加操作的场景。通常在表格中放置一个操作按钮会使表格整体样式看起来不太协调，所以当需要在表格内部提供操作按钮时，建议使用链接单元格，体验如下图所示：

![链接单元格](./images/2024-12-04-10-00-00.png)

示例地址：[链接](https://demo.succbi.com/v5/DEMO/app/ci.app?:id=cell-type&:sheet=Link)

链接单元格的常见使用场景：

- **跳转外部链接或其他系统内部资源**：单元格中自带类似[打开链接](../../../app/superpage/design/action/linkto.md)交互的设置，可参考文档说明。
- **制作首页目录跳转到其他工作表**：效果类似Excel的超链接设置，点击后可以跳转到指定工作表的某个单元格上，支持导出Excel，导出后会自动转换成Excel中的超链接设置。
- **在单元格中添加业务操作**：如点击后总是下载一个文件供用户参考，点击后修改其他单元格的内容或是直接更新数据库中的数据等，类似的操作都可以通过链接单元格加交互的方式实现。

### 字格{#char-grid}

当需要上报一些财务数据时，数据位数较多，常规的输入方式容易导致错漏，在报表填报应用中提供了一种特有的**字格**输入方式，将单元格按照货币单位拆分为多个小格，方便用户对比数据，体验如下图所示：

![字格](./images/2024-05-14-17-19-02.png)

示例地址：[字格](https://demo.succbi.com/v5/DEMO/app/ci.app?:id=cell-type&:sheet=CharGrid)

### 进度条{#progress-bar}

当需要上报带有占比、进度等含义的百分比时。数值形式不便于比较和查看。使用**进度条**，能够将填入的数值自动显示为进度条，使数值间的对比更加明显，增强了易读性。

![进度条](./images/2024-05-21-10-28-34.png)

示例地址：[进度条](https://demo.succbi.com/v5/DEMO/app/ci.app?:id=cell-type&:sheet=ProcessBar)

## 单元格类型变化{#type-change}

报表填报应用会根据单元格类型自动生成模型。在[发布报表填报应用](https://docs.succapp.com/v5/ci/publish)前，所有内部生成的模型都是临时的，此时修改**单元格类型**，模型也会相应变化。更多详细说明可参考[数据存储](../data-storage.md)文档。

在[发布报表填报应用](https://docs.succapp.com/v5/ci/publish)后，临时模型才会实际生成。此后再次修改单元格类型，模型中的字段类型也不会自行调整，比如原本为**文本输入**的单元格，生成的字段是**字符型**的，发布后将单元格类型修改为**数值输入**，字段不会自动调整为**浮点型**。

报表填报应用针对上述情况做了一些兼容性处理，即便存储的字段是字符型，单元格类型为**数值输入**，报表填报应用也能自动将填写的数值以字符串的形式存储到数据表中，类似的兼容性处理还有在日期单元格中存储字符型、整型等。还存在一些无法兼容的情况，比如数值单元格存日期型，此时需要在[模型管理](../../../data-gov/model/README.md)手动调整字段类型。

::: tip
下拉框和选择面板中**可选项**的数据类型必须与存储字段类型保持一致。如果可选项主键为**字符型**，实际存储数据为**整型**，可能会导致两个结果：1、装载数据时无法匹配可选项；2、对于不兼容类型转换的数据库，查询表单时可能会报错。
:::