# 栏目管理
栏目管理是UI引擎中用于构建前端项目导航结构的核心模块。在工业互联网应用中，该模块用于定义车间、产线、设备等复杂业务单元的层级化组织架构。通过配置菜单层级、页面路由及展示属性，用户可以快速搭建符合实际生产业务流程的应用导航体系。
#### 约束与限制
- 仅"管理员"角色可使用"栏目管理"功能。
- 菜单树最大支持5层深度。
  - 第1-4层：支持创建"文件夹"或"页面"。
  
  - 第5层（最底层）：仅支持创建"页面"，不允许创建"文件夹"。
   
- "页面"类型菜单必须为叶子节点，其下不支持挂载任何子级资源。
- 在"栏目管理"中进行的新增、删除、修改、排序操作，会实时同步至"页面设计器"的页面管理视图。如需使变更在最终运行的前端项目中生效，必须在完成配置后执行"发布"或"出码"操作，以生成最新代码包。相关操作请参见[发布UI引擎开发的前端项目](https://support.huaweicloud.com/usermanual-idme/idme_ui_0100.html)、[使用出码导出前端项目源码](https://support.huaweicloud.com/usermanual-idme/idme_ui_0116.html)。
 
#### 前提条件
- 已[登录应用运行态](https://support.huaweicloud.com/consog-idme/idme_consog_0023.html)，并具备UI引擎操作权限。
- 已完成前端项目创建，具体操作请参见[使用UI引擎创建前端项目](https://support.huaweicloud.com/usermanual-idme/idme_ui_0008.html)。
 
#### 进入栏目管理
1. 在左侧导航栏中，单击"UI引擎"，进入"UI引擎"。
2. 在左侧导航栏中，选择"前端项目"，进入"前端项目"页面。
3. 找到目标项目，将鼠标悬停在其"更多操作"上，在下拉菜单中单击"栏目管理"，展开"栏目管理"页面。 
   在栏目管理页面，您可以进行以下操作：
   - [新增菜单]
   
   - [启用/停用菜单]
   
   - [编辑菜单]
   
   - [调整菜单顺序]
   
   - [搜索菜单]
   
   - [删除菜单]
   
   
   
   
 
#### 新增菜单
用于构建新的业务模块或功能入口（如设备监控看板、生产报表、按车间/产线进行导航分组等），支持创建页面（功能入口）和文件夹（逻辑分组）两种类型。
1. 在左侧栏目树中，选中目标节点（如"根节点"或某文件夹），右侧列表将自动展示其下所有子菜单。
2. 单击"新增"，弹出"新增菜单"窗口。
3. 根据实际业务需求，配置如下参数信息。 
   图1新增菜单   
   ![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002579801746.png)
   表1创建项目参数信息 
   | 参数名称  | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                                        |
   |:---|:---|
   | 类型    | 支持"页面"和"文件夹"两种类型。 - 文件夹：用于逻辑分组，不直接对应页面。例如按车间、产线进行分组。  - 页面：对应具体的业务功能界面。例如设备监控看板、报表页面。   **注意**：类型在创建后不可修改。                    |
   | 菜单名称  | 自定义菜单显示名称。 长度限制为3-25个字符。                                                                                                                                                                                                                                                                                                                                                     |
   | 路由类型  | 仅当"类型"选择"页面"时，此配置项才会显示且必填。 - 项目内部路由：指向本项目内创建的页面，适用于工业应用内部功能跳转。  - 外部链接：指向外部系统地址，适用于集成第三方工业系统（如MES工单系统、ERP库存查询、SCADA实时画面）。   |
   | 菜单URL | 自定义访问路径。 - 如果"路由类型"为"项目内部路由"：仅允许英文字母、数字、下划线（_）、中横线（-）、正斜杠（/），且必须以英文字母开头。  - 如果"路由类型"为"外部链接"：需确保地址可正常访问，且允许被本项目嵌套。         |
   | 菜单图标  | 上传菜单左侧显示的图标。 - 格式支持：.png、.jpeg、.jpg、.svg。  - 大小限制：不超过10KB。                                                               |
   | 打开方式  | 仅当"类型"选择"页面"时，此配置项才会显示且必填。 - 当前窗口：在项目内当前页签打开，适用于常规业务页面（如数据录入、报表查询）。  - 新窗口：在浏览器新页签打开，适用于外部系统跳转、大屏看板等独立场景。                  |
   | 是否启用  | 控制菜单在前端的可见性与可用性，默认勾选（启用）。 - 勾选：菜单对终端用户可见。  - 不勾选：菜单隐藏，但配置保留，可随时启用。                                                      |
   | 是否为首页 | 仅当"类型"选择"页面"时，此配置项才会显示且选填。 - 勾选：设置为前端项目启动后的默认首页。  - 不勾选：非首页。                                                                       |
      
   
   
4. 确认配置无误后，单击"保存"。 
   - 如果创建的是"文件夹"：保存后即可在该文件夹下继续新增子菜单。
   
   - 如果创建的是"页面"且"路由类型"为"项目内部路由"：保存菜单后，该页面仅建立了导航入口，尚未包含具体内容。请进入"页面设计器"，找到对应页面进行可视化布局与组件配置。具体操作请参见[使用UI引擎的页面设计器开发前端项目](https://support.huaweicloud.com/usermanual-idme/idme_ui_0012.html)。
   
   
   
   
 
#### 启用/停用菜单
用于控制菜单在前端项目运行时的可见性，无需删除即可临时隐藏调试页面、未完成的功能模块，或根据业务节奏分阶段开放新功能。
1. 在左侧栏目树中，选中目标节点（即文件夹，如"根节点"），右侧列表将自动展示其下所有子菜单。
2. 在右侧列表中找到目标菜单，根据其当前状态执行对应操作： 
   - 如果菜单处于启用状态，单击"停用"。
   
   - 如果菜单处于停用状态，单击"启用"。
   
   
   状态变更即时生效于"页面设计器"。
   
   
 
#### 编辑菜单
当现有菜单属性发生变更时（如菜单名称录入错误、页面路由地址调整、图标或权限配置变更等），可通过编辑操作更新菜单信息，无需删除重建，避免关联配置丢失。
1. 在左侧栏目树中，选中目标节点（如"根节点"或某文件夹），右侧列表将自动展示其下所有子菜单。
2. 在右侧列表中找到目标菜单，单击该菜单所在行的"编辑"。
3. 在弹出的窗口中，修改所需字段信息，单击"保存"。
 
#### 调整菜单顺序
当业务优先级发生变化或需要优化导航结构的逻辑布局时，可通过拖拽操作重新排列菜单顺序，使高频或高优先级菜单更易触达。
1. 在左侧栏目树中，长按鼠标左键选中目标菜单项，保持按住状态并将其拖拽至目标位置。
2. 根据需求将菜单项放置于以下位置： 
   - 同级排序：拖拽至其他同级菜单的上方或下方。松开鼠标后，该菜单将在同级节点中按新位置排列。
   
   - 层级变更：拖拽至某个文件夹节点内部。松开鼠标后，该菜单将成为该文件夹的子节点。
     ![](https://support.huaweicloud.com/usermanual-idme/public_sys-resources/caution_3.0-zh-cn.png)
     系统会自动校验层级深度限制。如果目标位置导致层级超过最大限制（5层），光标将变为禁止状态，松开鼠标后不会执行移动。
     
   
   
   
   
3. 松开鼠标左键，系统即刻自动保存新的排序结构并实时同步至"页面设计器"视图。
 
#### 搜索菜单
当栏目结构复杂、节点众多时，支持通过关键字模糊搜索菜单名称，快速定位深层级菜单节点。
1. 在左侧栏目树上方的搜索框中，输入菜单名称关键字。
2. 系统自动过滤并展示匹配的菜单节点，隐藏不相关的菜单项。
 
#### 删除菜单
当业务调整导致某些菜单不再需要时（如产线永久下线、设备报废停用、旧版报表淘汰等场景），可执行删除操作以清理导航结构。
![](https://support.huaweicloud.com/usermanual-idme/public_sys-resources/caution_3.0-zh-cn.png)
- 删除页面时，被删除的页面统一回收至当前项目的页面回收站。更多信息请参见[页面回收站](https://support.huaweicloud.com/usermanual-idme/idme_ui_0113.html#ZH-CN_TOPIC_0000002485204912__section186001064415)。
- 删除文件夹时，该操作不可恢复，建议在删除前确认业务影响并做好备份。
- 如果目标文件夹下包含子页面或子文件夹，则无法直接删除。请先清空其内部所有子节点后，再执行删除操作。
 
1. 在左侧栏目树中，选中目标节点（如"根节点"或某文件夹），右侧列表将自动展示其下所有子菜单。
2. 在右侧列表中找到目标菜单，执行对应删除操作： 
   - 删除单个菜单：在目标菜单所在行，单击"删除"。
   
   - 批量删除菜单：勾选目标菜单，单击"批量删除"。
   
   
   
   
3. 在弹出的提示框中，单击"确定"。