jQuery EasyUI，Menu(菜单)组件
学习要点：
1.加载方式
2.菜单项属性
3.菜单属性
4.菜单事件
5.菜单方法
本节课重点了解 EasyUI 中 Menu(菜单)组件的使用方法，这个组件不依赖于任何其他 组件。
一．加载方式
菜单组件通常用于快捷菜单，在加载方式上，通过 class 或 JS 进行设置为菜单组件。 然后，再通过 JS 事件部分再响应。
class 加载方式，
<div id="box" class="easyui-menu" style="width:120px;">
<div>新建</div>
<div>
<span>打开</span>
<div style="width:150px;">
<div>Word</div>
<div>Excel</div>
<div>PowerPoint</div>
</div>
</div>
<div data-options="iconCls:'icon-save'">保存</div>
<div class="menu-sep"></div>
<div>退出</div>
</div>
注意必须结合js使用，因为默认class 加载方式，是隐藏的，而且默认是浏览器系统菜单
js
$(function () {
$(document).on('contextmenu',function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show',{ //执行自定义鼠标左键菜单
left:e.pageX, //菜单位置
top:e.pageY //菜单位置
})
})
});
menu()方法，将元素执行鼠标左键自定义菜单方法
JS 加载方式
$(function () {
$('#box').menu({
});
$(document).on('contextmenu',function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show',{ //执行自定义鼠标左键菜单
left:e.pageX, //菜单位置
top:e.pageY //菜单位置
})
})
});
二．菜单项属性，菜单主体属性
在 data-options 设置，只有两个有效，这些属性一般用于class 加载方式的每一项，或者使用方法增加时设置
<div data-options="
iconCls :'icon-save',
disabled : true,
">保存</div>
PS：其他的参数会菜单方法中设置菜单项时有效
三．菜单属性
菜单属性，有些设置在 data-options 有效
zIndex number 菜单 z-index 样式，增加它的值。默认值110000。 设置菜单的层级关系
$(function () {
$('#box').menu({
zIndex:100 //设置菜单的层级关系
});
$(document).on('contextmenu', function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show', { //执行自定义鼠标左键菜单
left: e.pageX, //菜单位置
top: e.pageY //菜单位置
});
});
});
left number 菜单的左边距位置。默认值0。
$(function () {
$('#box').menu({
zIndex:100, //设置菜单的层级关系
left:100,
top:100
});
$(document).on('contextmenu', function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show', { //执行自定义鼠标左键菜单
// left: e.pageX, //菜单位置
// top: e.pageY //菜单位置
});
});
});
top number 菜单的上边距位置。默认值0。
$(function () {
$('#box').menu({
zIndex:100, //设置菜单的层级关系
left:100,
top:100
});
$(document).on('contextmenu', function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show', { //执行自定义鼠标左键菜单
// left: e.pageX, //菜单位置
// top: e.pageY //菜单位置
});
});
});
minWidth number 菜单的最小宽度。默认值120。
$(function () {
$('#box').menu({
zIndex:100, //设置菜单的层级关系
left:100,
top:100,
minWidth:400 //菜单的最小宽度。默认值120。
});
$(document).on('contextmenu', function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show', { //执行自定义鼠标左键菜单
// left: e.pageX, //菜单位置
// top: e.pageY //菜单位置
});
});
});
hideOnUnhover boolean 当设置为 true 时，在鼠标离开菜单的时候将自动隐藏菜单。默认值 true。
$(function () {
$('#box').menu({
zIndex:100, //设置菜单的层级关系
minWidth:400, //菜单的最小宽度。默认值120。
hideOnUnhover:false //当设置为 true 时，在鼠标离开菜单的时候将自动隐藏菜单。默认值 true。
});
$(document).on('contextmenu', function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show', { //执行自定义鼠标左键菜单
left: e.pageX, //菜单位置
top: e.pageY //菜单位置
});
});
});
四．菜单事件
onShow none 在菜单显示之后触发。
$(function () {
$('#box').menu({
zIndex:100, //设置菜单的层级关系
onShow:function () {
alert('在菜单显示之后触发。');
}
});
$(document).on('contextmenu', function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show', { //执行自定义鼠标左键菜单
left: e.pageX, //菜单位置
top: e.pageY //菜单位置
});
});
});
onHide none 在菜单隐藏之后触发。
$(function () {
$('#box').menu({
zIndex:100, //设置菜单的层级关系
onHide:function () {
alert('在菜单隐藏之后触发');
}
});
$(document).on('contextmenu', function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show', { //执行自定义鼠标左键菜单
left: e.pageX, //菜单位置
top: e.pageY //菜单位置
});
});
});
onClick item 在菜单项被点击的时候触发。
$(function () {
$('#box').menu({
zIndex:100, //设置菜单的层级关系
onClick:function (item) {
alert('在菜单项被点击的时候触发');
alert(item); //接收点击的对象
}
});
$(document).on('contextmenu', function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show', { //执行自定义鼠标左键菜单
left: e.pageX, //菜单位置
top: e.pageY //菜单位置
});
});
});
五．菜单方法
options none 返回属性对象。
$(function () {
$('#box').menu({
});
alert($('#box').menu('options')); //返回属性对象
});
show pos显示菜单到指定的位置。'pos'参数有2个属性：
left：新的左边距位置。
top：新的上边距位置。
$(function () {
$('#box').menu({
});
$(document).on('contextmenu',function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show',{ //执行自定义鼠标左键菜单
left:e.pageX, //菜单位置
top:e.pageY //菜单位置
})
});
});
hide none 隐藏菜单。
$(function () {
$('#box').menu({
});
$(document).on('contextmenu',function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show',{ //执行自定义鼠标左键菜单
left:e.pageX, //菜单位置
top:e.pageY //菜单位置
});
$('#box').menu('hide'); //隐藏菜单。
});
});
destroy none 销毁菜单。
$(function () {
$('#box').menu({
});
$(document).on('contextmenu',function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show',{ //执行自定义鼠标左键菜单
left:e.pageX, //菜单位置
top:e.pageY //菜单位置
});
$('#box').menu('destroy'); //销毁菜单
});
});
getItem itemEl 获取指定的菜单项。得到的是一个菜单项的 DOM 元素。值为指定菜单项的id
$(function () {
$('#box').menu({
});
$(document).on('contextmenu',function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show',{ //执行自定义鼠标左键菜单
left:e.pageX, //菜单位置
top:e.pageY //菜单位置
});
alert($('#box').menu('getItem','#df')); //得到的是一个菜单项的 DOM 元素。值为指定菜单项的id
});
});
setText param设置指定菜单项的文本。'param'参数包含2个属性：
target：DOM 对象，要设置值的菜单项。
text: 字符串，要设置的新文本值。
$(function () {
$('#box').menu({
});
$(document).on('contextmenu',function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show',{ //执行自定义鼠标左键菜单
left:e.pageX, //菜单位置
top:e.pageY //菜单位置
});
$('#box').menu('setText', {
target: '#df',
text: '修改'
});
});
});
setIcon param设置指定菜单项图标。'param'参数包含2个属性：
target：DOM 对象，要设置的菜单项。
iconCls：新的图标 CSS 类 ID。
$(function () {
$('#box').menu({
});
$(document).on('contextmenu',function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show',{ //执行自定义鼠标左键菜单
left:e.pageX, //菜单位置
top:e.pageY //菜单位置
});
$('#box').menu('setIcon', {
target: '#df',
iconCls : 'icon-add'
});
});
});
findItem text 查 找 的 指 定 菜 单 项 ， 返 回 的 对 象 和getItem 方法是一样的。
$(function () {
$('#box').menu({
});
$(document).on('contextmenu',function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show',{ //执行自定义鼠标左键菜单
left:e.pageX, //菜单位置
top:e.pageY //菜单位置
});
alert($('#box').menu('findItem','新建'));
});
});
appendItem options追加新的菜单项，'options'参数代表新菜单项属性。默认情况下添加的项在菜单项的顶部。追加一个子菜单项，'parent'属性应该设置指定的父项元素，并且该父项元素必须是已经定义在页面上的。
$(function () {
$('#box').menu({});
$(document).on('contextmenu', function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show', { //执行自定义鼠标左键菜单
left: e.pageX, //菜单位置
top: e.pageY //菜单位置
});
});
$('#box').menu('appendItem', {
text: '新增',
iconCls: 'icon-add',
onclick: function () {
alert('新增');
}
});
});
追加一个子菜单项
$(function () {
$('#box').menu({});
$(document).on('contextmenu', function (e) { //设置鼠标左键方法
e.preventDefault(); //阻止默认行为，阻止掉浏览器系统菜单
$('#box').menu('show', { //执行自定义鼠标左键菜单
left: e.pageX, //菜单位置
top: e.pageY //菜单位置
});
});
$('#box').menu('appendItem', {
parent: $('#box').menu('findItem', '打开').target,
text: '新增',
iconCls: 'icon-add',
onclick: function () {
alert('新增');
},
});
});
removeItem itemEl 移除指定的菜单项。值为目标id
$('#box').menu('removeItem', '#new');
enableItem itemEl 启用菜单项。值为目标id
$('#box').menu('disableItem', '#new');
disableItem itemEl 禁用菜单项。值为目标id
$('#box').menu('enableItem', '#new');
$.fn.menu.defaults 重写默认值对象。见前面