jQuery EasyUI 菜單與按鈕插件– Menu 菜單
jQuery EasyUI插件 通過$.fn.menu.defaults 重寫默認的defaults。
菜單（Menu）通常用於上下文菜單。 它是創建其他菜單組件（比如：menubutton、splitbutton）的基礎組件。 它也能用於導航和執行命令。
用法
創建菜單（Menu）
通過標記創建菜單（menu）應該添加'easyui-menu' class 到<div> 標記。 每個菜單項（menu item）通過<div> 標記創建。 我們可以添加'iconCls' 屬性到菜單項（menu item），以定義一個顯示在菜單項（menu item）左邊的圖標。 添加'menu-sep' class 到菜單項（menu item）將產生一個菜單（menu）分隔符。
<div id="mm" class="easyui-menu" style="width:120px;">
<div>New</div>
<div>
<span>Open</span>
<div style="width:150px;">
<div><b>Word</b></div>
<div>Excel</div>
<div>PowerPoint</div>
</div>
</div>
<div data-options="iconCls:'icon-save'">Save</div>
<div class="menu-sep"></div>
<div>Exit</div>
</div>
編程創建菜單（menu）並偵聽'onClick' 事件。
$('#mm').menu({
onClick:function(item){
//...
}
});
顯示菜單（Menu）
當菜單（menu）被創建時，它是隱藏不可見的。 調用'show' 方法來顯示菜單（menu）。
$('#mm').menu('show', {
left: 200,
top: 100
});
菜單項
菜單項（menu item）代表一個顯示在菜單中的單獨的項目。 它包含下列屬性：
| 名称 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| id | string | 菜单项（menu item）的 id 属性。 | |
| text | string | 项目文本。 | |
| iconCls | string | 在项目左边显示一个 16x16 图标的 CSS class。 | |
| href | string | 当点击菜单项（menu item）时设置页面位置。 | |
| disabled | boolean | 定义是否禁用菜单项（menu item）。 | false |
| onclick | function | 当点击菜单项（menu item）时被调用的函数。 |
菜單屬性
| 名称 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| zIndex | number | 菜单（Menu）的 z-index 样式，从它开始增加。 | 110000 |
| left | number | 菜单（Menu）的左边位置。 | 0 |
| top | number | 菜单（Menu）的顶部位置。 | 0 |
| minWidth | number | 菜单（Menu）的最小宽度。该属性自版本 1.3.2 起可用。 | 120 |
| hideOnUnhover | boolean | 如果设置为 true，当鼠标离开它时自动隐藏菜单（menu）。该属性自版本 1.3.5 起可用。 | true |
菜單事件
| 名称 | 参数 | 描述 |
|---|---|---|
| onShow | none | 当菜单（menu）显示之后触发。 |
| onHide | none | 当菜单（menu）隐藏之后触发。 |
| onClick | item | 当点击菜单项（menu item）时触发。下面的实例演示如何处理所有菜单项点击：
<div class="easyui-menu" data-options="onClick:menuHandler" style="width:120px;">
<div data-options="name:'new'">New</div>
<div data-options="name:'save',iconCls:'icon-save'">Save</div>
<div data-options="name:'print',iconCls:'icon-print'">Print</div>
<div class="menu-sep"></div>
<div data-options="name:'exit'">Exit</div>
</div>
<script type="text/javascript">
function menuHandler(item){
alert(item.name)
}
</script>
|
菜單方法
| 名称 | 参数 | 描述 |
|---|---|---|
| options | none | 返回选项（options）对象。 |
| show | pos | 在指定的位置显示菜单（menu）。 pos 参数有两个属性： left：新的左边位置。 top：新的顶部位置。 |
| hide | none | 隐藏菜单（menu）。 |
| destroy | none | 销毁菜单（menu）。 |
| getItem | itemEl | 获取包含 'target' 属性（指示项目 DOM 元素）的菜单项（menu item）属性。下面的实例演示如何通过 id 获取指定的项目：
<div id="mm" class="easyui-menu" style="width:120px">
<div>New</div>
<div id="m-open">Open</div>
<div>Save</div>
</div>
var itemEl = $('#m-open')[0]; // the menu item element
var item = $('#mm').menu('getItem', itemEl);
console.log(item);
|
| setText | param | 给指定的菜单项（menu item）设置文本。'param' 参数包含两个属性： target：DOM 对象，被设定的菜单项（menu item）。 text：string，新的文本值。 代码实例：
var item = $('#mm').menu('findItem', 'Save');
$('#mm').menu('setText', {
target: item.target,
text: 'Saving'
});
|
| setIcon | param | 给指定的菜单项（menu item）设置图标。'param' 参数包含两个属性： target：DOM 对象，即菜单项（menu item）。 iconCls：新图标的 CSS class。 代码实例：
$('#mm').menu('setIcon', {
target: $('#m-open')[0],
iconCls: 'icon-closed'
});
|
| findItem | text | 找到指定的菜单项（menu item），返回对象与 getItem 方法相同。 代码实例：
// find 'Open' item and disable it
var item = $('#mm').menu('findItem', 'Open');
$('#mm').menu('disableItem', item.target);
|
| appendItem | options | 追加一个新的菜单项（menu item），'param' 参数指示新的项目属性。默认情况下，新增的项目将作为顶级菜单项（menu item）。如需追加一个子菜单项，需设置 'parent' 属性，用来指示已经有子项目的父项目元素。 代码实例：
// append a top menu item
$('#mm').menu('appendItem', {
text: 'New Item',
iconCls: 'icon-ok',
onclick: function(){alert('New Item')}
});
// append a menu separator
$('#mm').menu('appendItem', {
separator: true
});
// append a sub menu item
var item = $('#mm').menu('findItem', 'Open'); // find 'Open' item
$('#mm').menu('appendItem', {
parent: item.target, // the parent item element
text: 'Open Excel',
iconCls: 'icon-excel',
onclick: function(){alert('Open Excel')}
});
|
| removeItem | itemEl | 移除指定的菜单项（menu item）。 |
| enableItem | itemEl | 启用菜单项（menu item）。 |
| disableItem | itemEl | 禁用菜单项（menu item）。 |
jQuery EasyUI插件