bricks/docs/zh/menu.md

Menu

控件功能：用于创建可交互的菜单组件，支持静态菜单项、嵌套子菜单以及动态加载远程子菜单。点击菜单项可触发页面跳转或弹出窗口等行为。
类型：容器控件
父类控件：bricks.VBox

初始化参数

参数名	类型	说明
options.bgcolor	String	菜单背景颜色，默认为 "white"
options.items	Array	菜单项数组，每个项包含 label、url、icon、target 等属性（详见 create_menuitem 和 create_children 方法）
options.item_cheight	Number	菜单项的高度单位（cheight），影响图标和文本布局
options.menuitem_css	String	自定义菜单项的 CSS 样式名称
options.target	String	点击菜单项后目标容器类型，如 'PopupWindow', 'Popup' 或其他 widget ID
options.popup_options	Object	弹窗相关配置选项，用于定制 PopupWindow 或 Popup 的显示行为

注：options 还会传递给父类 VBox，继承其通用布局参数。

主要事件

• item_click
  触发时机：用户点击某个菜单项时
  回调参数：item 对象（包含 label, url, icon, target 等字段）
  处理逻辑：根据 item.target 决定打开方式（新窗口、弹窗或替换指定控件内容），并通过 widgetBuild 加载对应 URL 内容。

• command
  触发时机：在 menu_clicked 处理完导航逻辑后派发
  回调参数：与 item_click 相同的 opts 对象
  用途：通知外部系统执行附加命令或进行状态更新。

事件绑定通过 this.bind('item_click', ...) 在构造函数中设置，并由 regen_menuitem_event 触发。