更新时间:2025-08-15 GMT+08:00
分享

设置物料插件的“表格”组件属性

适用场景

“表格”组件是流程中结构化数据管理的核心工具,专为行列数据展示和操作而设计。支持数据浏览、批量操作、信息比对和流程追溯等功能,广泛应用于物料信息管理、评审记录展示、附件列表维护等场景,帮助用户高效组织和处理结构化数据。

模型选择

属性名

说明

支持变量绑定

选择模型

“模型”中选择需要的表格模型(如“物料清单”“评审记录表”),系统将自动关联对应的数据结构与展示配置。

如果“模型”没有可选择的数据模型,请在数据编辑页面添加数据模型

×

基础属性

属性名

说明

支持变量绑定

组件名

表格组件的名称,默认为“表格”,不可修改。

×

rel引用类

表格组件的ID,系统自动生成,且不可修改。

×

Style

配置表格组件样式,支持通过CSS代码自定义表格组件的样式。

只读

设置组件是否可编辑

  • 允许编辑单元格内容
  • 表格内容只读,不可编辑。

启用添加

设置是否显示添加按钮。

  • 不显示添加按钮
  • 在表格左上角显示“添加”按钮,单击可新增行

是否允许复选框选中数据

设置表格是否显示复选框。

  • 不显示复选框,无法批量选择行
  • 显示复选框,支持勾选多行进行批量操作

更多选项类型

在设置“基础属性”过程中,可以通过“更多选项类型”配置,以满足特定需求。

  • 处理选中数据:支持通过JavaScript代码自定义表格选中数据后的业务逻辑,实现多样化交互(如将选中数据传递至其他组件、触发特定业务流程)。
  • 表格高度:设置表格的固定高度(数值越大,纵向展示行数越多),超出部分显示滚动条。
  • 表格最大高度:设置表格的最大高度限制,内容不足时自适应高度,超过时显示滚动条。
  • 默认排序:设置表格初始化时的排序规则(如按“创建时间”降序排列)。

表格数据配置

属性名

说明

支持变量绑定

测试数据

支持通过JavaScript代码动态生成模拟数据

表格数据

支持通过JavaScript代码动态处理或转换数据源

查询数据的方法

支持通过JavaScript代码自定义API请求逻辑

分页配置

支持通过JavaScript代码动态计算分页参数

数据类型

所选模型对应的数据结构类型,由系统自动关联,不可修改。

×

表格列配置

属性名

说明

支持变量绑定

表格列

“模型选择”下完成“选择模型”后,系统将自动展示该模型的所有属性字段作为表单项。您可以根据实际业务需求调整这些属性,从而实现多样化的功能和交互体验。

  • 批量显示/隐藏:用于控制模型的全部属性字段(表单项)的整体可见性,实现一键显示或隐藏。
  • :当存在多个表单项时,长按此图标并上下拖动,调整模型属性的排列排序。
  • /:单独控制某一个表单项的可见状态,灵活满足不同场景下的展示需求。
  • :允许用户修改某个表单项的具体内容,以适应更细致的定制化要求。
    • 事件绑定:
    • 列标题:表单项的表头名称,支持自定义文本。
    • 列字段:绑定模型中的属性字段(如“物料编码”对应模型的“code”字段),决定该列展示的数据来源。
    • 列宽:设置列的宽度。
    • 最小列宽:设置列宽的最小限制,避免内容挤压或过度留白。
    • 格式化方法:支持通过JavaScript代码自定义数据展示格式(如日期格式化、数值单位转换)。
    • 文本溢出显示tooltip:设置文本过长时是否显示悬浮提示。
      • 不显示
      • 显示
    • 列固定:支持选择固定左侧、固定右侧,避免滚动时关键列被遮挡。
    • 是否排序:设置该列是否支持点击表头排序。
      • 排序
      • 排序
    • 表头tip:设置表头是否显示提示信息。
      • 不显示
      • 显示,开启后可自定义tip内容。
    • 表头tip内容:当“表头tip”开启时,可自定义tip内容。
    • 是否可编辑:设置该列是否允许编辑。
      • 可编辑
      • 可编辑
    • 必填:当“是否可编辑”开启时,可设置该字段是否为必填项。
      • 非必填
      • 必填
    • 控件类型:当您开启“是否可编辑”时,系统会根据所指定模型属性的类型自动匹配相应的输入方式。支持多种输入方式,包括输入框、选人组件、选择框、布尔值、文本、状态标识、时间选择器日期选择器和计数器。
    • 组件名:当您开启“是否可编辑”,且“控件类型”设置为“输入框”时,展示此配置项。默认为“输入框”,不可修改。
    • ref引用类:当您开启“是否可编辑”,且“控件类型”设置为“输入框”时,展示此配置项。系统自动生成,且不可修改。
    • Style:当您开启“是否可编辑”,且“控件类型”设置为“输入框”时,展示此配置项。可通过CSS代码自定义该控件样式。
    • 默认值:当您开启“是否可编辑”,且“控件类型”设置为“输入框”“选人组件”“选择框”“布尔值”“时间选择器”“日期选择器”“计数器”时,可设置默认值。支持国际化配置,如需在切换语言时同步更新内容,可单击进行多语言词条关联,具体操作请参见使用国际化词条
    • 类型:当您开启“是否可编辑”,且“控件类型”设置为“输入框”“状态标识”时,可设置此配置项。
      • 如果“控件类型”设置为“输入框”支持选择文本框、文本域。
      • 如果“控件类型”设置为“状态标识”支持选择成功、失败、告警。
    • 只读:当您开启“是否可编辑”,且“控件类型”设置为“输入框”“时间选择器”“日期选择器”时,可设置是否只读。
      • :不只读
      • 只读
    • 禁用:当您开启“是否可编辑”,且“控件类型”设置为“输入框”“选人组件”“选择框”“布尔值”“时间选择器”“日期选择器”,可设置是否禁用。
      • 禁用
      • 不禁用
    • 文本框可输入:当您开启“是否可编辑”“控件类型”设置为“日期选择器”,可设置文本框是否可输入。
      • 不可输入
      • 输入
    • 数据标识字段:当您开启“是否可编辑”“控件类型”设置为“选择框”时,可以根据实际业务需求自定义设置数据标识字段。数据标识字段用于唯一标识选项数据,确保在下拉列表中每个选项都能被准确识别和区分。通过合理配置,可以更好地匹配后台数据源,提升表单的数据处理能力和用户体验。
    • 数据展示字段:当您开启“是否可编辑”“控件类型”设置为“选择框”时,可以根据实际业务需求自定义该字段的显示内容。
    • 占位符:当您开启“是否可编辑”,且“控件类型”设置为“输入框”“选人组件”“选择框”“时间选择器”“日期选择器”可设置占位符。支持国际化配置,如需在切换语言时同步更新提示内容,可单击进行多语言词条关联,具体操作请参见使用国际化词条
    • 最大长度:当您开启“是否可编辑”,且“控件类型”设置为“输入框”时,可设置最大长度
    • 多选:当您开启“是否可编辑”,且“控件类型”设置为“选人组件”“选择框”时,可以根据实际业务需求启用或关闭此功能。
    • 最大选中人员数:“控件类型”设置为“选人组件”,且开启“多选”功能后,可以根据实际业务需求自定义允许选中的最大人员数量。
    • 文本内容:当您开启“是否可编辑”,且“控件类型”设置为“文本”时,可通过JSON格式自定义设置输入框的提示文本或默认值。
    • 文本宽度:当您开启“是否可编辑”,且“控件类型”设置为“文本”时,可以根据实际业务需求进行自定义设置输入框的宽度,以适应不同的布局要求和用户体验。
    • 启用超链接:当您开启“是否可编辑”,且“控件类型”设置为“文本”时,可以根据实际业务需求自定义设置是否启用此功能。
    • 超链接地址:开启“启用超链接”后,可以根据实际业务需求自定义设置超链接的目标地址。
    • 超链接新开页面:开启“启用超链接”后,可以根据实际业务需求设置超链接点击后在新窗口打开或当前窗口跳转。
    • 超链接变量:开启“启用超链接”后,可以根据实际业务需求进行自定义设置链接变量,以便传递特定数据。
      • 链接变量名:用于标识链接变量的自定义名称,便于区分和管理不同的链接变量。
      • 链接变量值:对应链接变量实际携带的数据内容,在业务场景中起到关键作用的信息。
    • 自定义超链接地址:开启“启用超链接”后,可通过JSON格式自定义设置复杂的链接地址规则。
    • 点击响应函数:开启“启用超链接”后,可通过JSON格式自定义设置链接点击后的响应行为,如数据提交、页面刷新等操作。
    • 可编辑:当您开启“是否可编辑”,且“控件类型”设置为“时间选择器”时,您可以根据实际业务需求灵活决定是否允许对所选时间进行手动编辑。
    • 输入框尺寸:当您开启“是否可编辑”,且“控件类型”设置为“时间选择器”时,可以根据实际业务场景下的页面布局和视觉效果需求,自由调整输入框的大小。
    • 时间显示格式:当您开启“是否可编辑”,且“控件类型”设置为“时间选择器”时,可以根据实际业务需求选择以下时间显示样式:小时、分钟、秒、小时:分钟、分钟:秒、小时:分钟:秒、AM/PM 小时、AM/PM 小时:分钟、AM/PM 小时:分钟:秒。
    • 日期类型:当您开启“是否可编辑”,且“控件类型”设置为“日期选择器”时,可以根据实际业务需求选择不同的日期选择器类型。可选类型包括:年、月、日、周、日期时间、多日期、日期时间范围、日期范围、月份范围、年份范围。
    • 日期显示格式:当您开启“是否可编辑”,且“控件类型”设置为“日期选择器”时,可以根据实际业务需求自定义日期显示格式。支持的格式包括:年、月、日、年-月、年-月-日、年-月-日 小时:分钟、年-月-日 小时:分钟:秒。
    • 面板对齐方式:当您开启“是否可编辑”,且“控件类型”设置为“时间选择器”“日期选择器”时,可以根据实际业务需求调整面板的对齐方式。支持的对齐方式包括:左对齐、居中对齐和右对齐。
    • 默认日期:当您开启“是否可编辑”,且“控件类型”设置为“日期选择器”时,可以根据业务流程与用户使用习惯,自定义默认显示的日期,减少用户手动输入操作,提升数据录入效率。
    • 默认时间:当您开启“是否可编辑”,且“控件类型”设置为“时间选择器”时,可以根据实际业务需求设置默认显示的时间,使初始界面更贴合用户使用预期,简化操作流程。
    • 启用范围选择:当您开启“是否可编辑”,且“控件类型”设置为“时间选择器”时,可以根据实际业务需求开启或关闭此功能。
    • 可选时间段:在未开启“启用范围选择”的情况下,您可以根据实际业务需求自定义单个时间选择的可选时段,精准限定时间选择范围。
    • 开启占位符:开启“启用范围选择”后,可以根据实际业务需求自定义时间范围起始端的占位提示文本。
    • 结束占位符:开启“启用范围选择”后,可以根据实际业务需求设置时间范围结束端的占位提示内容,引导用户准确输入。
    • 分隔符:开启“启用范围选择”后,可以根据实际业务需求自定义设置时间范围之间的分隔符,如 “-”“至”等。
    • 数据传递格式:当您开启“是否可编辑”,且“控件类型”设置为“时间选择器”“日期选择器”时,可以根据实际业务需求,定义数据的传输格式,确保数据与系统或其他模块的兼容性。
      • “时间选择器”格式:当使用“时间选择器”时,支持的选择方式包括:小时、分钟、秒、小时:分钟、分钟:秒、小时:分钟:秒、AM/PM 小时、AM/PM 小时:分钟、AM/PM 小时:分钟:秒,满足不同时间记录与展示需求。
      • “日期选择器”格式:当使用“日期选择器”时,支持的选择方式包括:年、月、日、年-月、年-月-日、年-月-日 小时:分钟、年-月-日 小时:分钟:秒,适配各类业务场景下的日期数据录入与显示要求。
    • 禁用日期:当您开启“是否可编辑”,且“控件类型”设置为“日期选择器”时,可以根据实际业务需求自定义禁止选择的日期范围,避免无效或冲突的日期输入。
    • 快捷项:当您开启“是否可编辑”,且“控件类型”设置为“日期选择器”时,可以根据实际业务需求,单击,灵活添加多个日期快捷选项,方便用户快速选择常用日期。
      • 文本:自定义快捷项显示的文本内容,确保其清晰、准确地传达对应日期含义。
      • 点击回调事件:支持通过JavaScript进行个性化设置,当用户点击快捷项时,可触发特定逻辑,如数据提交、页面跳转、动态更新等,实现与业务流程的深度交互。
    • 选项数据:当您开启“是否可编辑”,且“控件类型”设置为“选择框”时,可通过JavaScript进行配置
    • 选项:当您开启“是否可编辑”,且“控件类型”设置为“布尔值”时,可以根据实际业务需求,单击为控件添加多个选项。添加完成后,您可以在展开的选项列表中进行详细配置。
      • 数据标识:选项的ID,用于唯一地识别和区分每个选项。支持选择文本、数字和布尔。
      • 数据展示:表示用户在页面所看到的内容。支持国际化配置,如需在切换语言时同步更新提示内容,可单击进行多语言词条关联,具体操作请参见使用国际化词条
    • 校验提示内容:当您开启“是否可编辑”,且“控件类型”设置为“选人组件”时,可以根据实际业务需求自定义校验失败时的提示信息,便于用户快速修正操作。

×

行操作设置

设置每行右侧的操作按钮,支持勾选“启用编辑”“启用删除”,显示对应的编辑/删除功能。

自定义行操作

单击添加自定义操作按钮(如“查看详情”“导出”

配置项包括:

  • 文本:按钮显示文字(支持国际化配置,切换语言时同步更新,具体操作请参见使用国际化词条)。
  • 图标:按钮图标(如“copy”对应复制图标)
  • 点击回调事件:支持通过JavaScript代码进行自定义配置,自定义按钮点击后的执行逻辑

表格列最小宽度

设置列的最小宽度(防止内容过窄导致显示不全)。

表格列宽度

设置列的具体宽度(可根据内容重要性调整各列占比)。

折叠表格/树表格/大数据表格配置

属性名

说明

支持变量绑定

启用折叠

设置表格是否支持行折叠。

  • :不折叠,普通表格展示
  • 支持单击展开/收起子行(如树形结构数据)

树形表字段

指定用于标识树形结构的字段(如“parentId”“children”)。

折叠表格映射

用于配置折叠表格中父子节点的数据关联规则(如定义父行与子行的字段映射关系、层级匹配逻辑),支持通过JavaScript代码自定义复杂映射逻辑,确保折叠/展开时子节点数据能准确关联至对应父节点。

默认展开所有行

设置初始化时是否展开所有折叠行

  • 默认仅显示根节点
  • 默认展开所有层级

展开的行id数组

指定初始化时需自动展开的行ID集合(如[1,3,5]表示展开ID为1、3、5的行),支持通过JavaScript代码动态生成或计算该数组,实现根据业务逻辑控制初始展开状态(如默认展开当前用户负责的行)。

渲染优化

针对大数据量表格的渲染性能优化配置,支持通过JavaScript代码自定义。例如:

  • 虚拟滚动:仅渲染可视区域的行,提升长列表滚动性能
  • 数据分批加载:分页或按需加载数据,避免一次性处理大量数据
  • 懒渲染策略:延迟渲染非关键区域内容
  • 缓存机制:优化数据缓存与更新逻辑,减少重复渲染。

高级配置

属性名

说明

支持变量绑定

是否渲染

在页面开发中,可能需要根据某些条件来动态显示或隐藏页面中的组件内容,您可以设置此配置项。

  • :关闭渲染。
  • :开启渲染。

循环数据

表示需要循环渲染的数组。当页面存在若干份重复的、动态生成的内容时,您可以在高级面板中自定义循环数据。

迭代变量名

在循环渲染子项对应的变量名,默认为item。

×

索引变量名

循环渲染的索引变量名,默认为index。

×

key

用于标识每个循环项的唯一键值,默认为index。建议根据实际需求选择一个更合适的字段作为唯一标识符,以提高性能和避免潜在问题。

×

相关文档