# 设置UI引擎前端页面模板表单组件属性 模板表单组件是UI引擎封装的高效标准化表单组件，基于xDM-F数据模型快速生成标准化表单，适配设备参数配置、生产计划录入、物料信息提报、故障报修登记等场景。该组件支持xDM-F模型字段自定义配置、栅格布局调整、表单交互控制等功能，可灵活适配数据的录入、展示与提交需求，降低表单开发成本，保障数据录入的标准化与合规性。 #### 前提条件 - 已在当前页面添加"模板表单"组件，具体操作请参见[为UI引擎前端页面添加物料组件](https://support.huaweicloud.com/usermanual-idme/idme_ui_0016.html)。 - 已创建数据源，具体操作请参见[为UI引擎前端项目创建数据源](https://support.huaweicloud.com/usermanual-idme/idme_ui_0107.html)。 #### 配置入口 1. 在页面设计器的中心画布区，单击选中"模板表单"组件。 2. 在右侧设置面板中，单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002507396368.png)，即可展开"属性"设置面板。 #### 模型属性 此部分配置用于关联xDM-F数据模型并自定义表单项属性，是快速生成业务表单的核心，直接决定表单的字段结构与展示形态。 | 属性名称 | 说明 | 是否支持变量绑定 | |:---|:---|:---| | xdm模型 | 用于绑定xDM-F数据模型。绑定后，系统将自动生成与模型字段对应的表单项，无需手动配置基础字段。 配置步骤： 1. 单击"选择模型"，弹出"绑定数据模型"窗口。 2. 在弹出的窗口中，依次完成以下选择： - 选择xDM-F模型服务：从下拉列表中选择已在"数据源管理"中创建的xDM-F模型服务。 如果列表为空，请先前往"数据源管理"创建，具体操作请参见[为UI引擎前端项目创建数据源](https://support.huaweicloud.com/usermanual-idme/idme_ui_0107.html)。 - 选择租户：根据所选的xDM-F模型服务，选择其应用运行态下的目标租户。 - 选择目标数据模型：根据所选租户，从其可用模型列表中选择需要绑定的数据模型。 3. 单击"确认"，完成绑定。 | 否 | | 配置模型字段 | 完成"xdm模型"绑定后，系统会自动识别模型类型，并将其所有属性转换为字段列表。单击"点击配置模型字段"，可在弹出的窗口中对字段进行精细化设置。 根据所选模型的类型，"配置模型字段"窗口将显示不同的属性页签： - 单实体模型、关系实体：包含"基础属性"、"扩展属性"页签。 - M-V模型实体：包含"版本属性"、"主对象属性"、"分支对象属性"页签。 切换至相应页签后，可根据业务需求进行以下配置： - 字段状态：控制字段在表单中的显示状态，所有字段默认状态为"已使用"。 - 已使用：字段在表单中显示。 - 未使用：字段在表单中隐藏。 如果模型属性定义为必填，则该字段强制保持为"已使用"状态，不支持设置为"未使用"。 - 字段排序：通过拖拽调整字段在表单中的展示顺序。 - 字段编辑：单击字段所在行的![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002541425595.png)进行配置。 - 表单项标签：自定义该字段在前端表单中显示的标签名称。 - 字段名：由系统根据模型自动生成，为固定值，不可修改。 | 否 | | 布局模型表单 | 完成"xdm模型"绑定后，可通过此配置项自定义表单的栅格布局，以适配多样化的页面排版需求（如大屏表单、紧凑型操作表单）。单击"点击布局模型表单"，即可在弹出的窗口中进行可视化布局配置。 根据所选模型的类型，"布局模型表单"窗口将显示不同的属性页签，与字段配置保持一致： - 单实体模型、关系实体：包含"基础属性"、"扩展属性"页签。 - M-V模型实体：包含"版本属性"、"主对象属性"、"分支对象属性"页签。 切换至相应页签后，可针对全局栅格及具体字段区块进行以下配置： - 栅格配置：定义表单整体的网格结构及间距样式。 - 行数：设置表单栅格总行数。 - 列数：设置表单栅格总列数。 - 行间距（px）：设置栅格行之间的间距，单位为像素。 - 列间距（px）：设置栅格列之间的间距，单位为像素。 - 区块配置：配置字段区块在栅格中的布局位置，各项默认值均为1。 - 行位置：区块起始行号。 - 列位置：区块起始列号。 - 跨行数：区块在垂直方向所占的行数。 - 跨列数：区块在水平方向所占的列数。 - 可拖动下方区块进行布局调整：通过拖拽下方"已使用"模型字段，直观调整其在栅格中的具体位置。 | 否 | | 自定义提交函数 | 支持绑定自定义提交函数，用于处理表单提交后的逻辑（如保存数据到后端）。函数需返回"Promise"对象以支持异步操作。 | 是 | #### 基础信息 此部分用于配置模板表单组件的全局属性，包括尺寸、交互状态、标签样式及折叠面板标题等，直接影响表单的整体外观与用户体验。 | 属性名称 | 说明 | 是否支持变量绑定 | |:---|:---|:---| | 组件名称 | 当前组件的固定名称，不可修改，用于系统内部标识。 | 否 | | 表单数据 | 表单要展示的数据。 | 是 | | 尺寸 | 配置表单的整体尺寸，可选：medium、small、mini。 | 是 | | 表单仅展示 | 控制表单是否仅用于展示。 启用后，表单将仅展示字段内容，不可编辑。 | 是 | | 禁用 | 控制整个表单是否禁用。 启用后，表单将完全禁用（灰显），无法进行任何交互操作。 | 是 | | 标签位置 | 配置表单字段标签的位置，可选：左边、右边、上面。 | 是 | | 标签宽度 | 设置表单字段标签的宽度，默认为150px。 | 是 | | 基础属性标题 | 设置"基础属性"折叠面板的标题。 此配置项仅在"xdm模型"绑定单实体模型时生效。 | 是 | | 扩展属性标题 | 设置"扩展属性"折叠面板的标题。 此配置项仅在"xdm模型"绑定单实体模型时生效。 | 是 | | 版本属性标题 | 设置"版本属性"折叠面板的标题。 此配置项仅在"xdm模型"绑定M-V模型实体时生效。 | 是 | | 主对象属性标题 | 设置"主对象属性"折叠面板的标题。 此配置项仅在"xdm模型"绑定M-V模型实体时生效。 | 是 | | 分支对象属性标题 | 设置"分支对象属性"折叠面板的标题。 此配置项仅在"xdm模型"绑定M-V模型实体时生效。 | 是 | #### 其他 如下属性适用于UI引擎所有组件，用于精细化控制。 | 属性名称 | 说明 | 是否支持变量绑定 | |:---|:---|:---| | 元素id值 | 对应HTML标签的"id"属性，同一页面内必须唯一。 | 是 | | 样式类 | 对应HTML标签的"class"属性，为空格分隔的类名列表，用于自定义组件样式。默认为"component-base-style"。 | 是 | | ref引用类 | 对应Vue的"ref"属性，用于注册模板引用以访问组件实例方法。 如果为"数据源表单"组件，会自动填充默认值。 | 是 |