字段类型
SmartTable 提供 27 种字段类型，覆盖文本、数值、日期、选择、关联、计算、系统、地理位置等常见数据场景。选择合适的字段类型，可以让数据录入更规范、展示更直观、计算更高效。
字段类型一览
| 类别 | 字段类型 | 说明 |
|---|---|---|
| 文本类型 | 单行文本 | 短文本输入，支持验证规则。 |
| 文本类型 | 多行文本 | 长文本输入，支持多行编辑。 |
| 文本类型 | 富文本 | HTML 富文本编辑器，支持格式化内容。 |
| 数值类型 | 数字 | 整数/小数，支持数字/货币/百分比格式化。 |
| 日期类型 | 日期 | 日期选择器，支持多种日期格式。 |
| 日期类型 | 日期时间 | 日期时间选择器，精确到秒。 |
| 选择类型 | 单选 | 下拉单选，支持自定义选项和颜色。 |
| 选择类型 | 多选 | 标签式多选，支持自定义选项。 |
| 选择类型 | 复选框 | 布尔值开关。 |
| 人员类型 | 成员 | 用户选择，支持当前用户作为默认值。 |
| 联系方式 | 电话 | 电话号码输入和格式化显示。 |
| 联系方式 | 邮箱 | 邮箱地址输入和格式验证。 |
| 联系方式 | 链接（URL） | URL 链接，支持点击跳转。 |
| 媒体类型 | 附件 | 文件上传下载，支持图片预览和缩略图。 |
| 计算类型 | 公式 | 47 个内置函数，支持字段引用和嵌套计算。 |
| 关联类型 | 关联（Link） | 表间关联，支持一对一/一对多/多对多关系。 |
| 查找类型 | 查找（Lookup） | 跨表查询，支持聚合计算（求和/平均值/计数等）。 |
| 系统类型 | 创建人 | 自动记录记录创建者。 |
| 系统类型 | 创建时间 | 自动记录创建时间戳。 |
| 系统类型 | 更新人 | 自动记录最后修改者。 |
| 系统类型 | 更新时间 | 自动记录最后修改时间。 |
| 系统类型 | 自动编号 | 自增编号，支持前缀/后缀/日期格式/补零。 |
| 其他 | 评分 | 星级评分组件。 |
| 其他 | 进度 | 进度条/百分比显示。 |
| 地理位置 | 地理位置 | 结构化记录省/市/区、国家和地区或经纬度坐标，支持地图选点与多语言。 |
如何选择字段类型
- 需要输入简短内容时选择「单行文本」，长描述选择「多行文本」。
- 需要计算时选择「公式」，需要跨表取值时选择「查找」。
- 需要建立表间关系时选择「关联」。
- 创建人、创建时间等系统字段会自动生成，无需手动维护。
调整已创建字段的字段类型
字段创建后仍可修改其「字段类型」。系统会按该字段是否已存在数据自动判定可转换范围，并对已有数据做安全迁移，避免静默丢失信息。
一、字段暂无数据：自由转换
当字段尚未写入任何数据时，在通用限制范围内可自由调整为任意其他类型。
空值口径：
空（无值）、空字符串、空数组视为「暂无数据」；0、false视为有效业务数据。
二、字段已有数据：仅无损转换（唯一例外：日期 ↔ 日期时间）
已存在数据的字段只允许无损转换——目标类型能完整保留原值信息。在此之外仅放开一类有损转换：
日期→日期时间：无损，自动补全时间部分（如2023-05-01→2023-05-01T00:00:00Z）。日期时间→日期：有损，仅保留日期部分、丢弃时间部分，且不可恢复。提交前会弹出二次确认，明确提示「时间部分将被丢弃且不可恢复」，确认后方可执行。
除上述例外，其余有损转换一律禁止（如文本降级截断、多选转单选丢选项、引用型解析为名称等），以免数据异常而用户不知情。
三、无损转换规则（字段已有数据时）
| 原类型 | 可转为 | 数据处理方式 |
|---|---|---|
| 单行文本 | 多行文本、富文本 | 原值保留 |
| 多行文本 | 富文本 | 原值保留 |
| 单选 | 多选 | 单值包装为数组 [值] |
| 邮箱 / 电话 / 链接 / 条码 | 单行文本、多行文本、富文本 | 原字符串保留 |
| 数字 / 货币 / 百分比 / 评分 / 时长 | 彼此互转；或转文本类 | 数值保留，仅展示格式变化 |
| 百分比（进度） | 数字 | 数值保留 |
| 日期 | 日期时间（补 T00:00:00Z）；或转文本类 | 日期 / 原值保留 |
| 成员 | 单行文本、多行文本、富文本 | 保留成员 ID（不再关联成员） |
| 公式 | 其他类型（冻结为静态值） | 固化当前计算结果，不再自动重算 |
引用型（成员、单选 / 多选）转文本时保留原始 ID 字符串（严格无损），解析为姓名 / 选项名属有损，一律不做；系统会以告知条提示「将保留 ID，不再关联成员 / 选项」。
四、转换前的兼容性预检
即便规则白表放行，提交时仍会校验全部已有值是否能被目标类型承载。若某条数据无法被目标类型承载、无法无损迁移，系统会整字段拒绝本次转换，并返回无法转换的数据条数与样例，绝不会静默改写或置空。
五、禁止转换的类型
以下类型双向禁止转换，并在字段类型选择器中置灰、注明原因：
- 系统维护类型：创建人、创建时间、更新人、更新时间、自动编号；
- 引用 / 计算类型：关联、查找、汇总、按钮；
- 目标为公式：公式需要表达式，禁止将其他字段「转换」为公式；
- 主字段限制：作为记录标题的主字段，仅允许在文本类之间转换。例外：主字段为自动编号且已有数据时，允许降级为文本类（单行/多行/富文本）；反向（主字段文本转自动编号）仍禁止。
- 文本类 → 电话/邮箱/链接：单行/多行/富文本字段已存在数据时，禁止转为电话、邮箱、链接，否则既有文本可能不符合目标格式校验、产生非法数据。（空字段不受此限。）
完整的判定顺序、无损/有损白表与原因映射，请参见 字段类型转换规则。
文本类型
单行文本
用于存储较短的文本内容，如名称、标题、编号等。
配置选项：
- 最大长度限制
- 必填选项
- 正则表达式验证
多行文本
用于存储较长的文本内容，如描述、备注、会议纪要等。
特点：
- 支持多行输入
- 支持换行显示
富文本
基于 HTML 的富文本编辑器，适合需要格式化展示的内容。
特点：
- 支持加粗、斜体、列表、链接等格式
- 适合编辑说明文档、公告等
数值类型
数字
用于存储整数或小数，支持灵活的格式化：
- 普通数字
- 货币格式
- 百分比格式
配置选项：
- 小数位数
- 最小值/最大值
- 数值格式
日期类型
日期
日期选择器，支持多种日期格式：
YYYY-MM-DDYYYY/MM/DDMM/DD/YYYY
日期时间
精确到秒的日期时间选择器，适合需要记录具体时刻的场景。
选择类型
单选
从预设选项中选择一个值，适合状态、类别等场景。
配置选项：
- 自定义选项列表
- 为选项设置颜色标签
- 设置默认选项
多选
标签式多选，适合同时选择多个标签或分类。
复选框
简单的布尔值开关，常用于标记完成状态。
人员与联系方式
成员
关联系统用户或团队成员，支持单选或多选。
特点：
- 显示用户头像
- 支持将当前登录用户设为默认值
- 常用于任务负责人、项目成员等场景
电话 / 邮箱 / 链接
- 电话：电话号码输入，支持格式化显示。
- 邮箱：邮箱地址输入，自动校验格式。
- 链接（URL）：存储外部链接，支持点击跳转。
媒体与附件
附件
用于上传和管理文件：
- 支持图片、文档、压缩包等多种格式
- 支持图片预览和缩略图
- 文件大小受系统配置限制
PDF 预览
附件字段中的 PDF 文件支持内置预览，无需下载即可在表格内直接查看：
- 双击打开：在表格单元格中双击 PDF 类型的附件，弹窗会始终居中显示于浏览器视口，不受附件字段所在列是否被滚动隐藏的影响。
- 逐页渲染：多页 PDF 按页纵向堆叠展示，页面宽度自适应贴合预览区（标准 A4 比例），可上下滚动逐页浏览，效果对齐官方 pdf.js 预览器。
- 缩放与旋转：支持放大 / 缩小（±）与页面旋转，方便查看细节。
- 页面导航：支持上一页 / 下一页按钮及直接输入页码跳转，跳转时平滑滚动定位到目标页。
- 下载：预览窗口内提供下载入口，可把当前 PDF 保存到本地。
- 缩略图与图标：表格单元格中 PDF 附件以带「PDF」字样的图标展示，文字在图标内居中，便于一眼识别文件类型。
预览器基于 pdf.js 实现，可用于查看合同、扫描件、报表等文档类附件。
计算与关联
公式
通过公式自动计算字段值，支持 47 个内置函数。
示例：
// 计算总价
{单价} * {数量}
// 折扣计算
{原价} * (1 - {折扣})
// 条件判断
IF({成绩} >= 90, "优秀", IF({成绩} >= 60, "及格", "不及格"))
// 文本拼接
CONCAT({姓}, {名})
// 日期差
DATEDIF({开始日期}, {结束日期}, "D")更多函数说明请参考 README 中的「公式引擎」章节或后端 API 文档。
关联（Link）
建立数据表之间的关联关系，支持：
- 一对一
- 一对多
- 多对多
典型场景：
- 订单关联客户
- 任务关联项目
- 评论关联文章
查找（Lookup）
从另一张数据表跨表查询数据并支持聚合计算，常配合关联字段使用：
- 8 种计算方式：原值、去重、去重计数、求和、计数、平均值、最大值、最小值
- 支持最多 5 个筛选条件（AND / OR 组合），按「当前表字段 / 自定义值 / 当前记录」三种值类型取值
- 单元格只读，结果随源表数据实时重算
详细的使用方式、操作符适用范围、字段格式与示例，参见 查找字段详解。
系统字段
系统字段由系统自动维护，通常不可手动编辑：
| 字段 | 说明 |
|---|---|
| 创建人 | 自动记录记录的创建者。 |
| 创建时间 | 自动记录记录的创建时间。 |
| 更新人 | 自动记录最后修改者。 |
| 更新时间 | 自动记录最后修改时间。 |
| 自动编号 | 自增编号，支持配置前缀、后缀、日期格式和补零规则。 |
其他字段
评分
星级评分组件，适合满意度、优先级等评分场景。
进度
进度条或百分比显示，常用于任务完成度、项目进度等场景。
地理位置字段
用于结构化记录地理信息，支持中国省/市/区级联、国家和地区选择、详细地址、经纬度坐标以及地图选点等多种格式，并随界面语言切换中英文。
配置要点：
- 创建字段时选择「地址格式」：
省、省+市、省/市/区、省/市/区+详情、国家和地区、经纬度、地图选点。 - 数据以结构化 JSON 对象存储（含 province/city/district/detail/country/region/lng/lat 等字段），便于按层级筛选、统计与导出。
- 在表格视图中双击单元格即可就地编辑；省/市/区、国家和地区等格式选到最后一级自动提交。
详细的使用方式、各格式操作步骤、地址智能识别、多语言与地图选点等说明，参见 地理位置字段详解。
字段公共配置
所有字段都支持以下通用配置：
- 字段名称：显示名称。
- 字段描述：补充说明。
- 必填选项：是否必须填写。
- 默认值：新建记录时的默认值。
- 显示/隐藏：在视图中的显示控制。