第二百零六节,jQuery EasyUI,Menu(菜单)组件

时间:2023-07-25 23:31:08

jQuery EasyUI,Menu(菜单)组件

第二百零六节,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 //菜单位置
})
})
});

二.菜单项属性,菜单主体属性

第二百零六节,jQuery EasyUI,Menu(菜单)组件

在 data-options 设置,只有两个有效,这些属性一般用于class 加载方式的每一项,或者使用方法增加时设置

<div data-options="
  iconCls :'icon-save',
  disabled : true,
">保存</div>

PS:其他的参数会菜单方法中设置菜单项时有效

三.菜单属性

第二百零六节,jQuery EasyUI,Menu(菜单)组件

菜单属性,有些设置在 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 //菜单位置
});
});
});

四.菜单事件

第二百零六节,jQuery EasyUI,Menu(菜单)组件

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 //菜单位置
});
});
});

五.菜单方法

第二百零六节,jQuery EasyUI,Menu(菜单)组件

第二百零六节,jQuery EasyUI,Menu(菜单)组件

第二百零六节,jQuery EasyUI,Menu(菜单)组件

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 重写默认值对象。见前面