栏目管理

栏目管理是UI引擎中用于构建前端项目导航结构的核心模块。在工业互联网应用中，该模块用于定义车间、产线、设备等复杂业务单元的层级化组织架构。通过配置菜单层级、页面路由及展示属性，用户可以快速搭建符合实际生产业务流程的应用导航体系。

约束与限制

仅“管理员”角色可使用“栏目管理”功能。
菜单树最大支持5层深度。
- 第1-4层：支持创建“文件夹”或“页面”。
- 第5层（最底层）：仅支持创建“页面”，不允许创建“文件夹”。
“页面”类型菜单必须为叶子节点，其下不支持挂载任何子级资源。
在“栏目管理”中进行的新增、删除、修改、排序操作，会实时同步至“页面设计器”的页面管理视图。如需使变更在最终运行的前端项目中生效，必须在完成配置后执行“发布”或“出码”操作，以生成最新代码包。相关操作请参见发布UI引擎开发的前端项目、使用出码导出前端项目源码。

前提条件

已登录应用运行态，并具备UI引擎操作权限。
已完成前端项目创建，具体操作请参见使用UI引擎创建前端项目。

进入栏目管理

在左侧导航栏中，单击“UI引擎”，进入“UI引擎”。
在左侧导航栏中，选择“前端项目”，进入“前端项目”页面。
找到目标项目，将鼠标悬停在其“更多操作”上，在下拉菜单中单击“栏目管理”，展开“栏目管理”页面。

在栏目管理页面，您可以进行以下操作：

新增菜单

用于构建新的业务模块或功能入口（如设备监控看板、生产报表、按车间/产线进行导航分组等），支持创建页面（功能入口）和文件夹（逻辑分组）两种类型。

在左侧栏目树中，选中目标节点（如“根节点”或某文件夹），右侧列表将自动展示其下所有子菜单。
单击“新增”，弹出“新增菜单”窗口。

根据实际业务需求，配置如下参数信息。

图1 新增菜单

表1 创建项目参数信息
参数名称	参数说明
类型	支持“页面”和“文件夹”两种类型。文件夹：用于逻辑分组，不直接对应页面。例如按车间、产线进行分组。页面：对应具体的业务功能界面。例如设备监控看板、报表页面。注意：类型在创建后不可修改。
菜单名称	自定义菜单显示名称。长度限制为3-25个字符。
路由类型	仅当“类型”选择“页面”时，此配置项才会显示且必填。项目内部路由：指向本项目内创建的页面，适用于工业应用内部功能跳转。外部链接：指向外部系统地址，适用于集成第三方工业系统（如MES工单系统、ERP库存查询、SCADA实时画面）。
菜单URL	自定义访问路径。如果“路由类型”为“项目内部路由”：仅允许英文字母、数字、下划线（_）、中横线（-）、正斜杠（/），且必须以英文字母开头。如果“路由类型”为“外部链接”：需确保地址可正常访问，且允许被本项目嵌套。
菜单图标	上传菜单左侧显示的图标。格式支持：.png、.jpeg、.jpg、.svg。大小限制：不超过10KB。
打开方式	仅当“类型”选择“页面”时，此配置项才会显示且必填。当前窗口：在项目内当前页签打开，适用于常规业务页面（如数据录入、报表查询）。新窗口：在浏览器新页签打开，适用于外部系统跳转、大屏看板等独立场景。
是否启用	控制菜单在前端的可见性与可用性，默认勾选（启用）。勾选：菜单对终端用户可见。不勾选：菜单隐藏，但配置保留，可随时启用。
是否为首页	仅当“类型”选择“页面”时，此配置项才会显示且选填。勾选：设置为前端项目启动后的默认首页。不勾选：非首页。

确认配置无误后，单击“保存”。
- 如果创建的是“文件夹”：保存后即可在该文件夹下继续新增子菜单。
- 如果创建的是“页面”且“路由类型”为“项目内部路由”：保存菜单后，该页面仅建立了导航入口，尚未包含具体内容。请进入“页面设计器”，找到对应页面进行可视化布局与组件配置。具体操作请参见使用UI引擎的页面设计器开发前端项目。

启用/停用菜单

用于控制菜单在前端项目运行时的可见性，无需删除即可临时隐藏调试页面、未完成的功能模块，或根据业务节奏分阶段开放新功能。

在左侧栏目树中，选中目标节点（即文件夹，如“根节点”），右侧列表将自动展示其下所有子菜单。
在右侧列表中找到目标菜单，根据其当前状态执行对应操作：
- 如果菜单处于启用状态，单击“停用”。
- 如果菜单处于停用状态，单击“启用”。
状态变更即时生效于“页面设计器”。

编辑菜单

当现有菜单属性发生变更时（如菜单名称录入错误、页面路由地址调整、图标或权限配置变更等），可通过编辑操作更新菜单信息，无需删除重建，避免关联配置丢失。

在左侧栏目树中，选中目标节点（如“根节点”或某文件夹），右侧列表将自动展示其下所有子菜单。
在右侧列表中找到目标菜单，单击该菜单所在行的“编辑”。
在弹出的窗口中，修改所需字段信息，单击“保存”。

调整菜单顺序

当业务优先级发生变化或需要优化导航结构的逻辑布局时，可通过拖拽操作重新排列菜单顺序，使高频或高优先级菜单更易触达。

在左侧栏目树中，长按鼠标左键选中目标菜单项，保持按住状态并将其拖拽至目标位置。
根据需求将菜单项放置于以下位置：
- 同级排序：拖拽至其他同级菜单的上方或下方。松开鼠标后，该菜单将在同级节点中按新位置排列。
- 层级变更：拖拽至某个文件夹节点内部。松开鼠标后，该菜单将成为该文件夹的子节点。
  
  系统会自动校验层级深度限制。如果目标位置导致层级超过最大限制（5层），光标将变为禁止状态，松开鼠标后不会执行移动。
松开鼠标左键，系统即刻自动保存新的排序结构并实时同步至“页面设计器”视图。