网站前端_EasyUI.基础入门.0002.带你玩转jQuery EasyUI Panel组件 ?

简单介绍:

说明: Panel面板常当作其它内容的容器,可用于创建包含Layout布局/Tabs选项卡/Accordion折叠面板等基础组件,还提供了内置的折叠/关闭/最大化/最小化的行为,你可以将它嵌入到网页的任何位置.

基础用法:

<div id="p" class="easyui-panel" title="面板-标题" data-options="iconCls:'icon-save',closable:true,collapsible:true,minimizable:true,maximizable:true" >
    <p>面板-内容</p>
</div>

异步加载:

<!-- 注意: 必须添加easyui-panel类,不然在有些浏览器显示不完整 -->
<div id="p" class="easyui-panel"></div>
<!-- 说明: 加载jquery-easyui脚本文件 -->
<script src="js/jquery-easyui/jquery.min.js"></script>
<script src="js/jquery-easyui/jquery.easyui.min.js"></script>
<script src="js/jquery-easyui/locale/easyui-lang-zh_CN.js"></script>
<script type="text/javascript">
    var options = {
        width:500,
        height:150,
        iconCls:'icon-ok',
        title:'面板 - 标题',
        closable: true,
        href: '/easyui/data.json',
        cache: false,
        onLoad: function(){
            alert('notice: load remove data success!');
        }
    };
    $('#p').panel(options);
</script>

容器属性:

id -> string

说明: 面板的id属性

title -> string

说明: 显示在面板头部的标题文字

iconCls -> string

说明: 在面板显示一个16*16图标Css Class

width -> number

说明: 设置面板宽度

height -> number

说明: 设置面板高度

left -> number

说明: 设置面板的Left位置

top -> number

说明: 设置面板的Top位置

content -> string

说明: 面板的主体内容

<div id="p" class="easyui-panel" data-options="width:500,height:150,iconCls:'icon-save',title:'面板 - 标题',contet:''">
</div>

cls -> string

说明: 给面板添加一个Css Class

headerCls -> string

说明: 给面板头部添加一个Css Class

bodyCls -> string

说明: 给面板主体添加一个Css Class

style -> object

说明: 给面板添加一个自定义格式样式

<div id="p" class="easyui-panel"  data-options="width:500,height:150,cls:'p_panel',headerCls:'p_panel_header',iconCls:'icon-save',title:'测试',bodyCls:'p_panel_body'">
</div>

注意: 在data-options中使用style属性其实是应用在整个panel上,且写法必须是style:{padding: 10},而单独使用标签的style内联样式竟然应用在panel-body上,这个还是挺有意思~

collapsiable -> boolean

说明: 定义是否显示折叠按钮

minimizable -> boolean

说明: 定义是否显示最小化按钮

maximizable -> boolean

说明: 定义是否显示最大化按钮

closable -> boolean

说明: 定义是否显示关闭按钮

<div id="p" class="easyui-panel" data-options="width:500,height:150,iconCls:'icon-save',title:'面板 - 标题',collapsible:true,minimizable:true,maximizable:true,closable:true">
</div>

fit -> boolean

说明: 当为true时,面板尺寸适应其父元素

<div >
    <div id="p" class="easyui-panel" data-options="fit:true,width:250,height:150,iconCls:'icon-save',title:'面板 - 标题',closable:true">
    </div>
</div>

border -> boolean

说明: 定义是否显示面板的边框

doSize -> boolean

说明: 定义是否允许调整尺寸

noheader -> boolean

说明: 如果为true,面板的头部不会被创建,会忽略title/width/height等属性

<div id="p" class="easyui-panel" data-options="width:500,height:150,iconCls:'icon-save',title:'面板 - 标题',closable:true,border:true,doSize:true,noheader:true">
</div>

tools -> array/selector

说明: 定义工具组,数组每个对象必须包含iconCls和handler属性,还支持选择器,创建的新工具图表自动添加到默认工具左边

<div id="p" class="easyui-panel" data-options="width:500,height:150,iconCls:'icon-save',title:'面板-标题',closable:true,tools:[{iconCls:'icon-add', handler:function(e){alert('add')}},{iconCls:'icon-edit', handler:function(e){alert('edit')}}]">
</div>

<div id="p" class="easyui-panel" data-options="width:500,height:150,iconCls:'icon-save',title:'面板-标题',closable:true,tools:'#p_tools'">
</div>
<div id="p_tools">
    <a href="#" class="icon-add" onclick="javascript:alert('add')"></a>
    <a href="#" class="icon-edit" onclick="javascript:alert('edit')"></a>
</div>

collpsed -> boolean

说明: 定义初始化面板是不是折叠的.

minimized -> boolean

说明: 定义初始化面板是不是最小化

maxmized -> boolean

说明: 定义初始化面板是不是最大化

closed -> boolean

说明: 定义初始化面板是不是关闭的

href -> string

说明: 一个URL,用它加载远程数据并且显示在面板中,需要注意的是面板必须是打开时才会被加载,否则内容不会被加载,可用于创建惰性加载面板.

cache -> boolean

说明: 设置为true时就缓存从href加载的面板内容.

loadingMessage -> string

说明: 当加载远程数据时在面板中显示一条消息

extractor -> function

说明: 从Ajax响应中提取数据,处理函数接收data参数,常用于过滤数据返回作为结果.

<div id="p" class="easyui-panel" data-options="region:'center',width:800,height:300,iconCls:'icon-ok',title:'面板 - 标题',closable:true,href:'/easyui/data.json',cache:false,closed:true,loadingMessage:'Loading…',extractor: function(data){var d = JSON.parse(data);var s = JSON.stringify(d);return s;}">
</div>

容器事件:

onLoad -> function

说明: 当远程数据被加载时触发

onBeforeOpen -> function

说明: 面板打开前触发,返回false就停止打开

onOpen() -> function

说明: 面板打开后触发

onBeforeClose -> function

说明: 面板被关闭前触发,返回false就取消关闭

onClose -> function

说明: 面板被关闭后触发

onBeforeDestory -> function

说明: 面板销毁前触发,返回false就取消销毁

onDestory -> function

说明: 面板被销毁后触发

onBeforeCollapse -> function

说明: 面板折叠后触发,返回false被停止折叠

onCollapse -> function

说明: 面板折叠之后触发

onBeforeExpand -> function

说明: 面板展开前被触发,返回false被停止展开

onExpaned -> function

说明: 面板展开后被触发

onResize -> function

说明: 面板调整尺寸后被触发,处理函数接收width和height参数

onMove -> function

说明: 面板调整位置后被触发,处理函数接收left和top参数

onMaximize -> function

说明: 窗口最大化时被触发

onRestore -> function

说明: 窗口还原为他原始尺寸时被触发

onMinimize -> function

说明: 窗口最小化时被触发.

<div id="p" class="easyui-panel" data-options="width:500,height:150,iconCls:'icon-save',title:'面板 - 标题',collapsible:true,minimizable:true,maximizable:true,closable:true,href:'/easyui/data.json',cache:'false',onBeforeOpen:function(){
    alert('notice: exec before panel open');
},onOpen:function(){
    alert('notice: exec after panel open');
},onBeforeCollapse:function(){
    alert('notife: exec before panel collapse');
},onCollapse:function(){
    alert('notice: exec after panel collapse');
},onBeforeExpand:function(){
    alert('notice: exec before panel expand');
},onExpand:function(){
    alert('notice: exec after panel expand');
},onMaximize:function(){
    alert('notice: panel is maximizied');
},onMinimize:function(){
    alert('notice: panel is minimizied');
},onRestore:function(){
    alert('notice: panel is restored');
},onResize:function(width, height){
    alert('notice: panel width: '+width+' height: '+height);
},onMove:function(left, top){
    alert('notice: panel left: '+left+' top: '+top);
},onLoad:function(){
    alert('notice: panel start load remove data.')
}"></div>

容器接口:

options -> object

说明: 返回选项属性

panel -> object

说明: 返回外面板对象

header -> object

说明: 返回面板头部对象

body -> obejct

说明: 返回面板主体对象

setTitle -> property

说明: 设置头部的标题文本,需要传入title参数

open -> property

说明: 设置是否强制打开,需要传入forceOpen为true时可绕开onBeforeOpen回调函数打开面板

close -> property

说明: 设置是否强制关闭,需要传入forceClose为true时可绕开onBeforeClose回调函数关闭面板

destory -> property

说明: 设置是否强制销毁,需要传入forceDestory为true时可绕开onBeforeDestory回调函数销毁面板

refresh -> property

说明: 刷新pannel加载远程数据,可传递href参数将重写旧的href属性

resize -> property

说明: 设置面板尺寸并且做布局,需要传入包含width/height/left/top的对象

move -> property

说明: 移动面板到新的位置,需要传入包含left/top的对象

maximize -> property

说明: 面板适应它容器的尺寸

minimize ->  property

说明: 最小化面板

restore -> property

说明: 将最大化的面板还原为它原来的尺寸和位置

collapse -> property

说明: 折叠面板主体

expend -> property

说明: 展开面板主体

<fieldset>
    <legend>操作区</legend>
    <a href="#" class="easyui-linkbutton" onclick="javascript:console.log($('#p').panel('options'))">获取选项</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:console.log($('#p').panel('panel'))">获取面板</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:console.log($('#p').panel('header'))">获取头部</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:console.log($('#p').panel('body'))">获取主体</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:$('#p').panel('open')">打开</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:$('#p').panel('close')">关闭</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:$('#p').panel('refresh','/easyui/data.json')">刷新</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:$('#p').panel('maximize')">最大化</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:$('#p').panel('minimize')">最小化</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:$('#p').panel('restore')">还原</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:$('#p').panel('collapse')">折叠</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:$('#p').panel('expand')">展开</a>
    <a href="#" class="easyui-linkbutton" onclick="javascript:$('#p').panel('setTitle', '标题 - 面板')">改名</a>
</fieldset>
<!-- 注意: 必须添加easyui-panel类,不然在有些浏览器显示不完整 -->
<div id="p" class="easyui-panel"></div>
<!-- 说明: 加载jquery-easyui脚本文件 -->
<script src="js/jquery-easyui/jquery.min.js"></script>
<script src="js/jquery-easyui/jquery.easyui.min.js"></script>
<script src="js/jquery-easyui/locale/easyui-lang-zh_CN.js"></script>
<script type="text/javascript">
    var options = {
        width:500,
        height:150,
        iconCls:'icon-ok',
        title:'面板 - 标题',
        closed: true,
        closable: true,
    };
    var $p = $('#p').panel(options);
</script>