首页  >  文章  >  web前端  >  jQuery EasyUI 教程-Panel(面板)

jQuery EasyUI 教程-Panel(面板)

黄舟
黄舟原创
2017-03-23 17:30:282367浏览

<br/>

从现在开始,要给大家开始讲解jQuery EasyUI 教程-Layout(布局)中的第一小节内容:jQuery-panel(面板)组件,这款组件跟前面几篇文章的组件用法几乎都差不多,也是从设置一些面板属性、操作面板触发的事件以及方法来实现案列的,我们可针对这三个点去学习。

使用$.fn.panel.defaults重写默认值对象。

面板作为承载其它内容的容器。这是构建其他组件的基础(比如:layout,tabs,accordion等)。它还提供了折叠、关闭、最大化、最小化和自定义行为。面板可以很容易地嵌入到web页面的任何位置。

463.png

使用案例:

创建面板

前端开发工作中会通过标签和程序两种方法来创建面板。

1、通过标签创建面板

通过标签创建更简单。添加’easyui-panel’类ID到a6f776b766579c28d02706af09482172标签。

<p id=”p” class=”easyui-panel” title=”My Panel”
style=”width:500px;height:150px;padding:10px;background:#fafafa;”
data-options=”iconCls:’icon-save’,closable:true,
collapsible:true,minimizable:true,maximizable:true”>
<p>panel content.</p>
<p>panel content.</p>
</p>

2. 创建面板程序

让我们创建面板右上角的的工具栏。

<p id=”p” style=”padding:10px;”>
<p>panel content.</p>
<p>panel content.</p>
</p>
$(‘#p’).panel({
width:500,
height:150,
title: ‘My Panel’,
tools: [{
iconCls:’icon-add’,
handler:function(){alert(‘new’)}
},{
iconCls:’icon-save’,
handler:function(){alert(‘save’)}
}]
});

移动面板

调用‘move’方法移动面板到新的位置。

$(‘#p’).panel(‘move’,{
left:100,
top:100
});

读取内容

当加载成功的时候让我们通过ajax加载面板内容并显示一些消息。

$(‘#p’).panel({
href:’content_url.php’,
onLoad:function(){
alert(‘loaded successfully’);
}
});

属性:

属性名 属性值类型 描述
id string 面板的ID属性。
title string 在面板头部显示的标题文本。
iconCls string 设置一个16×16图标的CSS类ID显示在面板左上角。
width number 设置面板宽度。
height number 设置面板高度。
left number 设置面板距离左边的位置(即X轴位置)
top number 设置面板距离顶部的位置(即Y轴位置)
cls string 添加一个CSS类ID到面板
headerCls string 添加一个CSS类ID到面板头部
bodyCls string 添加一个CSS类ID到面板正文部分
style object 添加一个当前指定样式到面板。如下代码示例更改面板边框宽度:
<p class="easyui-panel" style="width:200px;height:100px"
        data-options="style:{borderWidth:2}">
</p>
fit boolean

当设置为true的时候面板大小将自适应父容器。下面的例子显示了一个面板;可以自动在父容器的最大范围内调整大小。

<p style="width:200px;height:100px;padding:5px">
<p class="easyui-panel" style="width:200px;height:100px"
data-options="fit:true,border:false">
Embedded Panel
</p>
</p>


border boolean 定义是否显示面板边框。
doSize boolean 如果设置为true,在面板被创建的时候将重置大小和重新布局。
noheader boolean 如果设置为true,那么将不会创建面板标题
content string 面板主体内容
collapsible boolean 定义是否显示可折叠按钮。
minimizable boolean 定义是否显示最小化按钮。
maximizable boolean 定义是否显示最大化按钮。
closable boolean 定义是否显示关闭按钮。
tools array,selector 自定义工具菜单,可用值:
1) 数组,每个元素都包含’iconCls’和’handler’属性。
2) 指向工具菜单的选择器。

面板工具菜单可以声明在已经存在的e388a4556c0f65e1904146cc1a846bee标签上:

<p class="easyui-panel" style="width:300px;height:200px"
title="My Panel" data-options
="iconCls:&#39;icon-ok&#39;,tools:&#39;#tt&#39;">
</p>
<p id="tt">
<a href="#" class="icon-add" onclick
="javascript:alert(&#39;add&#39;)"></a>
<a href="#" class="icon-edit" onclick
="javascript:alert(&#39;edit&#39;)"></a>
</p>

面板工具菜单也可以通过数组定义:

<p class="easyui-panel" style="width:300px;height:200px"
title="My Panel" data-options="iconCls:&#39;icon-ok&#39;,tools:[
{
iconCls:&#39;icon-add&#39;,
handler:function(){alert(&#39;add&#39;)}
},{
iconCls:&#39;icon-edit&#39;,
handler:function(){alert(&#39;edit&#39;)}
}]">
</p>


collapsed boolean 定义是否在初始化的时候折叠面板。
minimized boolean 定义是否在初始化的时候最小化面板。
maximized boolean 定义是否在初始化的时候最大化面板。
closed boolean 定义是否在初始化的时候关闭面板。
href string 从URL读取远程数据并且显示到面板。注意:内容将不会被载入,直到面板打开或扩大,在创建延迟加载面板时是非常有用的:
<p id="pp" class="easyui-panel" style
="width:300px;height:200px"
data-options="href=&#39;get_content.php&#39;,closed:true">
</p>
<a href="#" onclick
="javascript:$(&#39;#pp&#39;).panel(&#39;open&#39;)">Open</a>
cache boolean 如果为true,在超链接载入时缓存面板内容
loadingMessage string 在加载远程数据的时候在面板内显示一条消息
extractor function 定义如何从ajax应答数据中提取内容,返回提取数据。
xtractor: function(data){
	var pattern = /<body[^>]*>((.|[\n\r])*)<\/body>/im;
	var matches = pattern.exec(data);
	if (matches){
		return matches[1];	// 仅提取主体内容
	} else {
		return data;
	}
}
method string 使用HTTP的哪一种方法读取内容页。可用值:’get’,’post’。(该属性自1.3.6版开始可用)
queryParams object 在加载内容页的时候添加的请求参数。(该属性自1.3.6版开始可用)
loader function 定义了如何从远程服务器加载内容页,该函数接受以下参数:
param:参数对象发送给远程服务器。
success(data):在检索数据成功的时候调用的回调函数。
error():在检索数据失败的时候调用的回调函数。
(该属性自1.3.6版开始可用)

事件:

事件名 事件参数 描述
onBeforeLoad none 在加载内容页之前触发,返回false将忽略该动作。(该事件自1.3.6版开始可用)
onLoad none 在加载远程数据时触发
onLoadError none 在加载内容页发生错误时触发。(该事件自1.3.6版开始可用)
onBeforeOpen none 在打开面板之前触发,返回false可以取消打开操作
onOpen none 在打开面板之后触发
onBeforeClose none 在关闭面板之前触发,返回false可以取消关闭操作。下列的面板将不能关闭。
<p class="easyui-panel" style="width:300px;height:200px;"
title="My Panel" data-options
="onBeforeClose:function(){return false}">
 面板将不能关闭
</p>
onClose none 在面板关闭之后触发。
onBeforeDestroy none 在面板销毁之前触发,返回false可以取消销毁操作
onDestroy none 在面板销毁之后触发
onBeforeCollapse none 在面板折叠之前触发,返回false可以终止折叠操作。
onCollapse none 在面板折叠之后触发
onBeforeExpand none 在面板展开之前触发,返回false可以终止展开操作。
onExpand none 在面板展开之后触发
onResize width, height 在面板改变大小之后触发。
width:新的宽度。
height:新的高度。
onMove left,top 在面板移动之后触发。
left:新的左边距位置。
top:新的上边距位置
onMaximize none 在窗口最大化之后触发
onRestore none 在窗口恢复到原始大小以后触发。
onMinimize none 在窗口最小化之后触发。

 方法:

方法名 方法参数 描述
options none 返回属性对象。
panel none 返回面板对象。
header none 返回面板头对象。
body none 返回面板主体对象。
setTitle title 设置面板头的标题文本。
open forceOpen 在’forceOpen’参数设置为true的时候,打开面板时将跳过’onBeforeOpen’回调函数。
close forceClose 在’forceClose’参数设置为true的时候,关闭面板时将跳过’onBeforeClose’回调函数。
destroy forceDestroy 在’forceDestroy’参数设置为true的时候,销毁面板时将跳过’onBeforeDestory’回调函数。
refresh href 刷新面板来装载远程数据。如果’href’属性有了新配置,它将重写旧的’href’属性。代码示例:
// 打开面板且刷新其内容。
$(&#39;#pp&#39;).panel(&#39;open&#39;).panel(&#39;refresh&#39;);
// 刷新一个新的URL内容
$(&#39;#pp&#39;).panel(&#39;open&#39;).panel(&#39;refresh&#39;,&#39;new_content.php&#39;);
resize options 设置面板大小和布局。参数对象包含下列属性:
width:新的面板宽度。
height:新的面板高度。
left:新的面板左边距位置。
top:新的面板上边距位置。代码示例:
$(&#39;#pp&#39;).panel(&#39;resize&#39;,{
	width: 600,
	height: 400
});
move options 移动面板到一个新位置。参数对象包含下列属性:
left:新的左边距位置。
top:新的上边距位置。
maximize options 最大化面板到容器大小。
minimize none 最小化面板。
restore none 恢复最大化面板回到原来的大小和位置。
collapse animate 折叠面板主题。
expand animate 展开面板主体。

 以上就是jQuery EasyUI 教程-Panel(面板)的内容,更多相关内容请关注PHP中文网(www.php.cn)!

相关文章:

easyui datagrid分页 4、easyUI-七种布局(layout)

初识通用数据库操作类前端easyui-datagrid,form(php),easyuidatagrid

浅析jQuery EasyUI中的tree使用指南

声明:
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn