📚 表格参数说明

📚 表格参数说明 📚 表格参数说明 Modified August 29, 2025 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） DateColumn 📌 对应数据的 VALUE 配置类型：number，从 1970 1 1 00:00:00 UTC+0 开始到现在所经过的毫秒数 属性 类型 必填 默认值 说明 type date 是 name string 是 displayName string 否 如果没有，直接用 name 来展示 format string 否 YYYY MM DD 时间戳的格式化 可参考 dayjs width string 否 auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） OptionsColumn 📌 对应数据的 VALUE 配置类型：string | string[] 属性 类型 必填 默认值 说明 type options 是 name string 是 displayName string 否 如果没有，直接用 name 来展示 options (string | { label?: string, value: string })[] 否 选项定义，单 string 可以理解为是语法糖，比如定义 options: 'opt'，与下面的写法是等效的 Code block JSON { label: 'opt', value: 'opt', } label 表示实际渲染的内容，value 表示在数据源里写的值 label 不写时默认为 value width string 否 auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） PersonsColumn 📌 对应数据的 VALUE 配置类型：string | string[]，字符串内容应为 userId（Aily 数据中用户表的 id，说明文档） 属性 类型 必填 默认值 说明 type persons 是 name string 是 displayName string 否 如果没有，直接用 name 来展示 width string 否 auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） MarkdownColumn 📌 对应数据的 VALUE 配置类型：string 属性 类型 必填 默认值 说明 type markdown 是 name string 是 displayName string 否 如果没有，直接用 name 来展示 width string 否 auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 注意事项 1. 表格组件目前最多支持配置 10 列，超出的列数会被忽略 2. 一条消息里最多支持展示 5 个表格组件，超出的话会目前会降级展示： 3. 表格组件列与列之间没有联动校验的逻辑（e.g 三列加起来宽度超过 xxx 会报错），因此设置的时候独立考虑每一列即可 4. 表格组件 Markdown 列数据类型的 at 语法对齐消息卡片的 at 语法，暂不支持直接填写 Aily 的 userId，见：开放平台 Markdown 语法说明 5. 表格组件 Markdown 列数据类型，目前在飞书渠道仅支持 7.10 以上的版本展示，低版本会降级成如下的消息 6. columns 里的 name 字段建议只用英文和数字混用表示，不要使用其他额外的字符，如 /，如果使用了额外的字符，那么需要保证你的 data 字段里的 key 用双引号包裹。如下，str/2 由于没有双引号包裹，就直接报错了。 Code block Markdown <table columns = [ { type: 'string', name: 'str/2', displayName: '字符串', width: '100px', }, ] data = [ { str/2: 'str1', }, ] rowHeight = 'high' / 正确写法： Code block Markdown <table columns = [ { type: 'string', name: 'str/2', displayName: '字符串', width: '100px', }, ] data = [ { "str/2": 'str1', }, ] rowHeight = 'high' / dayjs 说明文档 开放平台 Markdown 语法说明 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） DateColumn 📌 对应数据的 VALUE 配置类型：number，从 1970 1 1 00:00:00 UTC+0 开始到现在所经过的毫秒数 对应数据的 VALUE 配置类型：number，从 1970 1 1 00:00:00 UTC+0 开始到现在所经过的毫秒数 属性 类型 必填 默认值 说明 type date 是 name string 是 displayName string 否 如果没有，直接用 name 来展示 format string 否 YYYY MM DD 时间戳的格式化 可参考 dayjs width string 否 auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） dayjs 属性 属性 类型 类型 必填 必填 默认值 默认值 说明 说明 type type date date 是 是 name name string string 是 是 displayName displayName string string 否 否 如果没有，直接用 name 来展示 如果没有，直接用 name 来展示 format format string string 否 否 YYYY MM DD YYYY MM DD 时间戳的格式化 可参考 dayjs dayjs 时间戳的格式化 可参考 dayjs dayjs width width string string 否 否 auto auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） OptionsColumn 📌 对应数据的 VALUE 配置类型：string | string[] 对应数据的 VALUE 配置类型：string | string[] 属性 类型 必填 默认值 说明 type options 是 name string 是 displayName string 否 如果没有，直接用 name 来展示 options (string | { label?: string, value: string })[] 否 选项定义，单 string 可以理解为是语法糖，比如定义 options: 'opt'，与下面的写法是等效的 Code block JSON { label: 'opt', value: 'opt', } label 表示实际渲染的内容，value 表示在数据源里写的值 label 不写时默认为 value width string 否 auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 属性 属性 类型 类型 必填 必填 默认值 默认值 说明 说明 type type options options 是 是 name name string string 是 是 displayName displayName string string 否 否 如果没有，直接用 name 来展示 如果没有，直接用 name 来展示 options options (string | { label?: string, value: string })[] (string | { label?: string, value: string })[] 否 否 选项定义，单 string 可以理解为是语法糖，比如定义 options: 'opt'，与下面的写法是等效的 Code block JSON { label: 'opt', value: 'opt', } label 表示实际渲染的内容，value 表示在数据源里写的值 label 不写时默认为 value 选项定义，单 string 可以理解为是语法糖，比如定义 options: 'opt'，与下面的写法是等效的 label 表示实际渲染的内容，value 表示在数据源里写的值 label 不写时默认为 value width width string string 否 否 auto auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） PersonsColumn 📌 对应数据的 VALUE 配置类型：string | string[]，字符串内容应为 userId（Aily 数据中用户表的 id，说明文档） 说明文档 对应数据的 VALUE 配置类型：string | string[]，字符串内容应为 userId（Aily 数据中用户表的 id，说明文档） 说明文档 属性 类型 必填 默认值 说明 type persons 是 name string 是 displayName string 否 如果没有，直接用 name 来展示 width string 否 auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 属性 属性 类型 类型 必填 必填 默认值 默认值 说明 说明 type type persons persons 是 是 name name string string 是 是 displayName displayName string string 否 否 如果没有，直接用 name 来展示 如果没有，直接用 name 来展示 width width string string 否 否 auto auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） MarkdownColumn 📌 对应数据的 VALUE 配置类型：string 对应数据的 VALUE 配置类型：string 属性 类型 必填 默认值 说明 type markdown 是 name string 是 displayName string 否 如果没有，直接用 name 来展示 width string 否 auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 属性 属性 类型 类型 必填 必填 默认值 默认值 说明 说明 type type markdown markdown 是 是 name name string string 是 是 displayName displayName string string 否 否 如果没有，直接用 name 来展示 如果没有，直接用 name 来展示 width width string string 否 否 auto auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 注意事项 1. 表格组件目前最多支持配置 10 列，超出的列数会被忽略 2. 一条消息里最多支持展示 5 个表格组件，超出的话会目前会降级展示： 3. 表格组件列与列之间没有联动校验的逻辑（e.g 三列加起来宽度超过 xxx 会报错），因此设置的时候独立考虑每一列即可 4. 表格组件 Markdown 列数据类型的 at 语法对齐消息卡片的 at 语法，暂不支持直接填写 Aily 的 userId，见：开放平台 Markdown 语法说明 开放平台 Markdown 语法说明 5. 表格组件 Markdown 列数据类型，目前在飞书渠道仅支持 7.10 以上的版本展示，低版本会降级成如下的消息 6. columns 里的 name 字段建议只用英文和数字混用表示，不要使用其他额外的字符，如 /，如果使用了额外的字符，那么需要保证你的 data 字段里的 key 用双引号包裹。如下，str/2 由于没有双引号包裹，就直接报错了。 Code block Markdown <table columns = [ { type: 'string', name: 'str/2', displayName: '字符串', width: '100px', }, ] data = [ { str/2: 'str1', }, ] rowHeight = 'high' / Code block Markdown <table columns = [ { type: 'string', name: 'str/2', displayName: '字符串', width: '100px', }, ] data = [ { str/2: 'str1', }, ] rowHeight = 'high' / 正确写法： Code block Markdown <table columns = [ { type: 'string', name: 'str/2', displayName: '字符串', width: '100px', }, ] data = [ { "str/2": 'str1', }, ] rowHeight = 'high' / Code block Markdown <table columns = [ { type: 'string', name: 'str/2', displayName: '字符串', width: '100px', }, ] data = [ { "str/2": 'str1', }, ] rowHeight = 'high' / 使用场景 表格组件是一个用于数据展示的组件，允许用户以行和列的形式查看信息，便于比较和分析各项数据。 使用示例 组件属性说明 属性 类型 必填 默认值 说明 columns (StringColumn | BooleanColumn | NumberColumn | DateColumn | OptionsColumn | PersonsColumn | MarkdownColumn)[] 是 表格列的配置描述，详细参数见下文 data JSON[] 是 表格的数据： • 用 "name": VALUE 的形式，定义每一行的数据内容，name 为 columns 中每一列定义的 name 字段 • 具体 VALUE 值见下文列配置参数的介绍 pageSize number 否 10 每页所显示的数据量，支持配置 1 10 rowHeight string 否 low 行高：选填，可按以下 2 种方式配置： • 枚举型，枚举范围包括： ◦ 低（low）默认值 ◦ 中等（middle） ◦ 高（high） • 固定高度：按 “xxxpx ” 声明行高，高度为固定数值高度。取值范围为 [32px, 124px] 的整数。单元格高度如无法展示一整行内容，则上下裁剪内容 StringColumn BooleanColumn NumberColumn DateColumn OptionsColumn PersonsColumn MarkdownColumn 属性 属性 类型 类型 必填 必填 默认值 默认值 说明 说明 columns columns (StringColumn | BooleanColumn | NumberColumn | DateColumn | OptionsColumn | PersonsColumn | MarkdownColumn)[] StringColumn BooleanColumn NumberColumn DateColumn OptionsColumn PersonsColumn MarkdownColumn (StringColumn | BooleanColumn | NumberColumn | DateColumn | OptionsColumn | PersonsColumn | MarkdownColumn)[] StringColumn BooleanColumn NumberColumn DateColumn OptionsColumn PersonsColumn MarkdownColumn 是 是 表格列的配置描述，详细参数见下文 表格列的配置描述，详细参数见下文 data data JSON[] JSON[] 是 是 表格的数据： • 用 "name": VALUE 的形式，定义每一行的数据内容，name 为 columns 中每一列定义的 name 字段 • 具体 VALUE 值见下文列配置参数的介绍 表格的数据： • 用 "name": VALUE 的形式，定义每一行的数据内容，name 为 columns 中每一列定义的 name 字段 • 具体 VALUE 值见下文列配置参数的介绍 pageSize pageSize number number 否 否 10 10 每页所显示的数据量，支持配置 1 10 每页所显示的数据量，支持配置 1 10 rowHeight rowHeight string string 否 否 low low 行高：选填，可按以下 2 种方式配置： • 枚举型，枚举范围包括： ◦ 低（low）默认值 ◦ 中等（middle） ◦ 高（high） • 固定高度：按 “xxxpx ” 声明行高，高度为固定数值高度。取值范围为 [32px, 124px] 的整数。单元格高度如无法展示一整行内容，则上下裁剪内容 行高：选填，可按以下 2 种方式配置： • 枚举型，枚举范围包括： ◦ 低（low）默认值 ◦ 中等（middle） ◦ 高（high） ◦ 低（low）默认值 ◦ 中等（middle） ◦ 高（high） • 固定高度：按 “xxxpx ” 声明行高，高度为固定数值高度。取值范围为 [32px, 124px] 的整数。单元格高度如无法展示一整行内容，则上下裁剪内容 StringColumn 📌 对应数据的 VALUE 配置类型：string 对应数据的 VALUE 配置类型：string 属性 类型 必填 默认值 说明 type string 是 name string 是 displayName string 否 如果没有，直接用 name 来展示 width string 否 auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 属性 属性 类型 类型 必填 必填 默认值 默认值 说明 说明 type type string string 是 是 name name string string 是 是 displayName displayName string string 否 否 如果没有，直接用 name 来展示 如果没有，直接用 name 来展示 width width string string 否 否 auto auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） BooleanColumn 📌 对应数据的 VALUE 配置类型：boolean 对应数据的 VALUE 配置类型：boolean 属性 类型 必填 默认值 说明 type boolean 是 name string 是 displayName string 否 如果没有，直接用 name 来展示 width string 否 auto 列宽度：选填，可按以下 3 种方式配置： • auto（默认）：列宽最小宽度为 80px，自适应内容宽度为最合适宽度 • 固定宽度：按 “xxxpx” 声明当前列宽度，宽度为固定数值宽度。取值范围是 [80px, 600px] 的整数 • 固定百分比：按 “xxx%” 声明当前列宽度，宽度为当前表格画布宽度取百分比（表格画布宽度 = 卡片宽度 卡片左右padding） 属性 属性 类型 类型 必填 必填 默认值 默认值 说明 说明 type type boolean boolean 是 是 name name string string 是 是 displayName displayName string string 否 否 如果没有，直