jQuery EasyUI 布局插件 _ Panel 面板


jQuery EasyUI 插件 jQuery EasyUI 插件

通过 $.fn.panel.defaults 重写默认的 defaults。

面板(panel)当做其他内容的容器使用。它是创建其他组件(比如:Layout 布局、Tabs 标签页/选项卡、Accordion 折叠面板,等等)的基础组件。它也提供内置的可折叠、可关闭、可最大化、可最小化的行为以及其他自定义行为。面板(panel)可以简单地嵌入到网页的任何位置。

用法

创建面板(Panel)

1、通过标记创建面板(Panel)

从标记创建面板(Panel)更容易。把 'easyui-panel' class 添加到 <div> 标记。

<div 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>
</div>

2、编程创建面板(Panel)

让我们创建带右上角工具栏的面板(Panel)。

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

移动面板(Panel)

调用 'move' 方法把面板(Panel)移动到新位置。

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

加载内容

让我们通过 ajax 加载面板(panel)内容并且当加载成功时显示一些信息。

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

属性

名称类型描述默认值
idstring面板(panel)的 id 属性。null
titlestring显示在面板(panel)头部的标题文字。null
iconClsstring在面板(panel)里显示一个 16x16 图标的 CSS class。null
widthnumber设置面板(panel)的宽度。auto
heightnumber设置面板(panel)的高度。auto
leftnumber设置面板(panel)的左边位置。null
topnumber设置面板(panel)的顶部位置。null
clsstring给面板(panel)添加一个 CSS class。null
headerClsstring给面板(panel)头部添加一个 CSS class。null
bodyClsstring给面板(panel)主体添加一个 CSS class。null
styleobject给面板(panel)添加自定义格式的样式。
改变面板(panel)边框宽度的代码实例:
<div class="easyui-panel" style="width:200px;height:100px"
        data-options="style:{borderWidth:2}">
</div>
{}
fitboolean当设置为 true 时,面板(panel)的尺寸就适应它的父容器。下面的实例演示了自动调整尺寸到它的父容器的最大内部尺寸的面板(panel)。
<div style="width:200px;height:100px;padding:5px">
    <div class="easyui-panel" style="width:200px;height:100px"
            data-options="fit:true,border:false">
        Embedded Panel
    </div>
</div>
false
borderboolean定义了是否显示面板(panel)的边框。true
doSizeboolean如果设置为 true,创建时面板(panel)就调整尺寸并做成布局。true
noheaderboolean如果设置为 true,面板(panel)的头部将不会被创建。false
contentstring面板(panel)主体内容。null
collapsibleboolean定义是否显示折叠按钮。false
minimizableboolean定义是否显示最小化按钮。false
maximizableboolean定义是否显示最大化按钮。false
closableboolean定义是否显示关闭按钮。false
toolsarray,selector自定义工具组,可能的值:
1、数组,每个元素包含 iconCls 和 handler 两个属性。
2、选择器,指示工具组。

面板(panel)工具组可通过已存在 <div> 标签声明:
<div class="easyui-panel" style="width:300px;height:200px"
        title="My Panel" data-options="iconCls:'icon-ok',tools:'#tt'">
</div>
<div id="tt">
    <a href="#" class="icon-add" onclick="javascript:alert('add')"></a>
    <a href="#" class="icon-edit" onclick="javascript:alert('edit')"></a>
</div>
面板(panel)工具组可通过数组定义:
<div class="easyui-panel" style="width:300px;height:200px"
        title="My Panel" data-options="iconCls:'icon-ok',tools:[
                {
                    iconCls:'icon-add',
                    handler:function(){alert('add')}
                },{
                    iconCls:'icon-edit',
                    handler:function(){alert('edit')}
                }]">
</div>
[]
collapsedboolean定义初始化面板(panel)是不是折叠的。false
minimizedboolean定义初始化面板(panel)是不是最小化的。false
maximizedboolean定义初始化面板(panel)是不是最大化的。false
closedboolean定义初始化面板(panel)是不是关闭的。false
hrefstring一个 URL,用它加载远程数据并且显示在面板(panel)里。请注意,除非面板(panel)打开,否则内容不会被加载。这对创建一个惰性加载的面板(panel)很有用:
<div id="pp" class="easyui-panel" style="width:300px;height:200px"
        data-options="href='get_content.php',closed:true">
</div>
<a href="#" onclick="javascript:$('#pp').panel('open')">Open</a>
null
cacheboolean设置为 true 就缓存从 href 加载的面板(panel)内容。true
loadingMessagestring当加载远程数据时在面板(panel)里显示一条信息。Loading…
extractorfunction定义如何从 ajax 响应中提取内容,返回提取的数据。
extractor: function(data){
    var pattern = /<body[^>]*>((.|[\n\r])*)<\/body>/im;
    var matches = pattern.exec(data);
    if (matches){
        return matches[1];    // only extract body content
    } else {
        return data;
    }
}

事件

名称参数描述
onLoadnone当远程数据被加载时触发。
onBeforeOpennone面板(panel)打开前触发,返回 false 就停止打开。
onOpennone面板(panel)打开后触发。
onBeforeClosenone面板(panel)关闭前触发,返回 false 就取消关闭。下面声明的面板(panel)不会关闭。
<div class="easyui-panel" style="width:300px;height:200px;"
        title="My Panel" data-options="onBeforeClose:function(){return false}">
    The panel cannot be closed.
</div>
onClosenone面板(panel)关闭后触发。
onBeforeDestroynone面板(panel)销毁前触发,返回false就取消销毁。
onDestroynone面板(panel)销毁后触发。
onBeforeCollapsenone面板(panel)折叠前触发,返回false就停止折叠。
onCollapsenone面板(panel)折叠后触发。
onBeforeExpandnone面板(panel)展开前触发,返回false就停止展开。
onExpandnone面板(panel)展开后触发。
onResizewidth, height面板(panel)调整尺寸后触发。
width:新的外部宽度
height:新的外部高度
onMoveleft,top面板(panel)移动后触发。
left:新的左边位置
top:新的顶部位置
onMaximizenone窗口最大化后触发。
onRestorenone窗口还原为它的原始尺寸后触发。
onMinimizenone窗口最小化后触发。

方法

名称参数描述
optionsnone返回选项(options)属性(property)。
panelnone返回外部面板(panel)对象。
headernone返回面板(panel)头部对象。
bodynone返回面板(panel)主体对象。
setTitletitle设置头部的标题文本。
openforceOpen当 forceOpen 参数设置为 true 时,就绕过 onBeforeOpen 回调函数打开面板(panel)。
closeforceClose当 forceClose 参数设置为 true 时,就绕过 onBeforeClose 回调函数关闭面板(panel)。
destroyforceDestroy当 forceDestroy 参数设置为 true 时,就绕过 onBeforeDestroy 回调函数销毁面板(panel)。
refreshhref刷新面板(panel)加载远程数据。如果分配了 'href' 参数,将重写旧的 'href' 属性。
代码实例:
// open a panel and then refresh its contents.
$('#pp').panel('open').panel('refresh');
// refresh contents with a new URL.
$('#pp').panel('open').panel('refresh','new_content.php');
resizeoptions设置面板(panel)尺寸并做布局。Options 对象包含下列属性:
width:新的面板(panel)宽度
height:新的面板(panel)宽度
left:新的面板(panel)左边位置
top:新的面板(panel)顶部位置

代码实例:
$('#pp').panel('resize',{
    width: 600,
    height: 400
});
moveoptions移动面板(panel)到新位置。Options 对象包含下列属性:
left:新的面板(panel)左边位置
top:新的面板(panel)顶部位置
maximizenone面板(panel)适应它的容器的尺寸。
minimizenone最小化面板(panel)。
restorenone把最大化的面板(panel)还原为它原来的尺寸和位置。
collapseanimate折叠面板(panel)主体。
expandanimate展开面板(panel)主体。

jQuery EasyUI 插件 jQuery EasyUI 插件

    0 个评论

    要回复文章请先登录注册