设置UI引擎前端页面模板表单组件属性
模板表单组件是UI引擎封装的高效标准化表单组件，基于xDM-F数据模型快速生成标准化表单，适配设备参数配置、生产计划录入、物料信息提报、故障报修登记等场景。该组件支持xDM-F模型字段自定义配置、栅格布局调整、表单交互控制等功能，可灵活适配数据的录入、展示与提交需求，降低表单开发成本，保障数据录入的标准化与合规性。
前提条件
- 已在当前页面添加“模板表单”组件，具体操作请参见为UI引擎前端页面添加物料组件。
- 已创建数据源，具体操作请参见为UI引擎前端项目创建数据源。
配置入口
- 在页面设计器的中心画布区，单击选中“模板表单”组件。
- 在右侧设置面板中，单击
，即可展开“属性”设置面板。
模型属性
此部分配置用于关联xDM-F数据模型并自定义表单项属性，是快速生成业务表单的核心，直接决定表单的字段结构与展示形态。
|
属性名称 |
说明 |
是否支持变量绑定 |
|---|---|---|
|
xdm模型 |
用于绑定xDM-F数据模型。选择后，系统将自动生成与模型字段对应的表单项，无需手动配置基础字段。 配置步骤：
|
否 |
|
模型字段 |
根据所选“xdm模型”自动生成字段列表，支持以下配置：
|
否 |
|
自定义提交函数 |
支持绑定自定义提交函数，用于处理表单提交后的逻辑（如保存数据到后端）。函数需返回“Promise”对象以支持异步操作。 |
是 |
|
表单布局 |
用于自定义表单的栅格布局，适配不同页面排版需求（如大屏表单、紧凑型操作表单）。单击“点击配置栅格布局”，在弹出的配置弹窗中设置以下内容：
|
否 |
基础信息
|
属性名称 |
说明 |
是否支持变量绑定 |
|---|---|---|
|
组件名称 |
当前组件的固定名称，不可修改，用于系统内部标识。 |
否 |
|
表单数据 |
表单要展示的数据。 |
是 |
|
尺寸 |
配置表单的整体尺寸，可选：medium、small、mini。 |
是 |
|
表单仅展示 |
控制表单是否仅用于展示。 启用后，表单将仅展示字段内容，不可编辑。 |
是 |
|
禁用 |
控制整个表单是否禁用。 启用后，表单将完全禁用（灰显），无法进行任何交互操作。 |
是 |
|
标签位置 |
配置表单字段标签的位置，可选：左边、右边、上面。 |
是 |
|
标签宽度 |
设置表单字段标签的宽度，默认为100px。 |
是 |
|
基础属性标题 |
设置表单基础属性区域的标题，用于区分基础属性和扩展属性。 |
是 |
|
扩展属性标题 |
设置表单扩展属性区域的标题，用于区分基础属性和扩展属性。 |
是 |
其他
如下属性适用于UI引擎所有组件，用于精细化控制。
|
属性名称 |
说明 |
是否支持变量绑定 |
|---|---|---|
|
元素id值 |
对应HTML标签的“id”属性，同一页面内必须唯一。 |
是 |
|
样式类 |
对应HTML标签的“class”属性，为空格分隔的类名列表，用于自定义组件样式。默认为“component-base-style”。 |
是 |
|
ref引用类 |
对应Vue的“ref”属性，用于注册模板引用以访问组件实例方法。 如果为“数据源表单”组件，会自动填充默认值。 |
是 |
