设置UI引擎前端页面搜索模板组件属性

前提条件

• 已在当前页面添加“搜索模板”组件，具体操作请参见为UI引擎前端页面添加物料组件。
• 已创建数据源，具体操作请参见为UI引擎前端项目创建数据源。

配置入口

1. 在页面设计器的中心画布区，单击选中“搜索模板”组件。
2. 在右侧设置面板中，单击，即可展开“属性”设置面板。

模型属性

此部分配置用于关联xDM-F数据模型、绑定搜索基础数据，是组件实现数据检索功能的核心前提。

配置xDM-F模型页面

• 搜索表单项配置：用于自定义搜索表单的展示样式、字段范围与布局结构，适配不同检索需求。

  配置类型	配置说明
  基础配置	用于定义搜索表单的基础交互样式与文本标识。 搜索按钮文字：自定义搜索按钮文本（如“检索设备”、“查询物料”），默认为“搜索”。 重置按钮文字：自定义重置按钮文本（如“清空条件”），默认为“重置”。 标签宽度：设置表单标签占位宽度。可根据字段名称长度调整。 是否不使用展开更多：选择是否隐藏“展开更多”按钮，所有搜索字段直接展示（字段较少时开启，字段较多时关闭以节省空间）。
  表单字段配置	配置搜索表单的可用字段，仅支持模型的列表属性和已入库属性（保障搜索数据的规范性与可用性）。 添加字段：在“未选表单项”中勾选目标属性，单击，移入“已选表单项”。 移除字段：在“已选表单项”中勾选目标属性，单击，移回“未选表单项”。
  栅格配置	用于自定义搜索表单的栅格布局，适配大屏、紧凑型操作界面等不同场景。 行数：设置表单总行数（根据字段数量合理分配，如8个字段设为4行）。 列数：设置表单总列数（大屏场景设为3列，紧凑型界面设为2列）。 行间距（px）：设置行之间的间距（建议16px，提升可读性）。 列间距（px）：设置列之间的间距（建议24px，避免字段挤压）。
  区块配置 - 创建时间	用于精准定位“创建时间”字段在表单中的布局位置。 可配置行位置、列位置、跨行数、跨列数（默认均为1）。
  可拖动下方区块进行布局调整	支持拖动下方字段区块可视化调整位置，建议将时间字段放在表单顶部或右侧，提升检索便捷性。

• 搜索表格项配置：结果展示配置，用于自定义搜索结果表格的展示内容与操作功能。

  配置类型	配置说明
  设置表格最大高度	控制表格内容的最大展示高度。当内容超出设定值时，表格内部启用滚动条。 单位支持px和百分比，不支持vh。
  是否显示工具栏	控制表格工具栏的整体显示/隐藏。 工具栏默认包含“创建”、“删除”、“批量操作”和“设置”按钮。
  是否显示设置按钮	控制工具栏中“设置”按钮的显示/隐藏。
  创建按钮	用于配置“创建”按钮的文字和显示状态。 按钮文字：设置“创建”按钮要显示的文字，默认为“创建”。 是否显示：控制“创建”按钮是否展示。
  删除按钮	用于配置“删除”按钮的文字和显示状态。 按钮文字：设置“删除”按钮要显示的文字，默认为“删除”。 是否显示：控制“删除”按钮是否展示。
  批量操作	用于配置批量操作下拉菜单的内容和显示状态。 按钮文字：设置“批量操作”按钮要显示的文字，默认为“批量操作”。 导出搜索结果：配置下拉菜单中“导出搜索结果”选项的文字，默认为“导出搜索结果”。 导出选中项：配置下拉菜单中“导出选中项”的文字，默认为“导出选中项”。 是否显示：控制“批量操作”及对应子项是否展示。
  是否显示操作列	控制表格是否展示行级操作列。
  是否显示编辑按钮	控制操作列是否展示“编辑”按钮。
  是否显示删除按钮	控制操作列是否展示“删除”按钮。
  表格字段配置	用于定义搜索结果表格的展示字段。 添加字段：在“未选表格项”中勾选目标属性（如设备名称、运行温度、所属车间），单击，移入“已选表格项”。 移除字段：在“已选表格项”中勾选目标属性，单击，移回“未选表格项”。

• 创建/修改表单项配置：弹窗表单配置，用于配置点击表格“编辑/新增”按钮后弹出的表单，适配数据的新增与修改场景。

  配置类型	配置说明
  表单项配置	用于定义新增/修改弹窗表单的可用字段。 添加字段：在“未选表单项”中勾选目标属性，单击，移入“已选表单项”。 移除字段：在“已选表单项”中勾选目标属性，单击，移回“未选表单项”。
  栅格配置	用于自定义弹窗表单的栅格布局，适配弹窗尺寸与字段展示需求。 行数：根据字段数量设置（如10个字段设为5行）。 列数：弹窗场景建议设为2列（避免弹窗过宽）。 行间距（px）：设置行之间的间距，建议16px。 列间距（px）：设置列之间的间距，建议20px。
  区块配置 - 创建时间	用于定位“创建时间”字段在弹窗表单中的位置，支持配置行位置、列位置、跨行数、跨列数（默认均为1）。
  可拖动下方区块进行布局调整	支持拖动下方字段区块可视化调整位置，建议将时间字段放在表单顶部或右侧，提升检索便捷性。

其他

如下属性适用于UI引擎所有组件，用于精细化控制。