Layout（布局）
使用$.fn.layout.defaults重写默认值对象。
布局容器有5个区域：北、南、东、西和中间。中间区域面板是必须的，边缘的面板都是可选的。每个边缘区域面板都可以通过拖拽其边框改变大小，也可以点击折叠按钮将面板折叠起来。布局可以进行嵌套，用户可以通过组合布局构建复杂的布局结构。
依赖关系
使用案例
创建布局
1. 通过标签创建布局
为<div/>标签增加名为'easyui-layout'的类ID。
- <div id="cc" class="easyui-layout" style="width:600px;height:400px;">
- <div data-options="region:'north',title:'North Title',split:true" style="height:100px;"></div>
- <div data-options="region:'south',title:'South Title',split:true" style="height:100px;"></div>
- <div data-options="region:'east',iconCls:'icon-reload',title:'East',split:true" style="width:100px;"></div>
- <div data-options="region:'west',title:'West',split:true" style="width:100px;"></div>
- <div data-options="region:'center',title:'center title'" style="padding:5px;background:#eee;"></div>
- </div>
2. 使用完整页面创建布局
- <body class="easyui-layout">
- <div data-options="region:'north',title:'North Title',split:true" style="height:100px;"></div>
- <div data-options="region:'south',title:'South Title',split:true" style="height:100px;"></div>
- <div data-options="region:'east',iconCls:'icon-reload',title:'East',split:true" style="width:100px;"></div>
- <div data-options="region:'west',title:'West',split:true" style="width:100px;"></div>
- <div data-options="region:'center',title:'center title'" style="padding:5px;background:#eee;"></div>
- </body>
3. 创建嵌套布局
注意：嵌套在内部的布局面板的左侧(西面)面板是折叠的。
- <body class="easyui-layout">
- <div data-options="region:'north'" style="height:100px"></div>
- <div data-options="region:'center'">
- <div class="easyui-layout" data-options="fit:true">
- <div data-options="region:'west',collapsed:true" style="width:180px"></div>
- <div data-options="region:'center'"></div>
- </div>
- </div>
- </body>
4. 通过ajax读取内容
布局是以面板为基础创建的。所有的布局面板都支持异步加载URL内容。使用异步加载技术，用户可以使自己的布局页面显示的内容更多更快。
- <body class="easyui-layout">
- <div data-options="region:'west',href:'west_content.php'" style="width:180px" ></div>
- <div data-options="region:'center',href:'center_content.php'" ></div>
- </body>
折叠布局面板
- $('#cc').layout();
- // collapse the west panel
- $('#cc').layout('collapse','west');
添加西侧区域面板和工具菜单按钮
- $('#cc').layout('add',{
- region: 'west',
- width: 180,
- title: 'West Title',
- split: true,
- tools: [{
- iconCls:'icon-add',
- handler:function(){alert('add')}
- },{
- iconCls:'icon-remove',
- handler:function(){alert('remove')}
- }]
- });
布局属性
| 属性名 | 属性值类型 | 描述 | 默认值 |
|---|---|---|---|
| fit | boolean | 如果设置为true，布局组件将自适应父容器。当使用'body'标签创建布局的时候，整个页面会自动最大。 | false |
事件
| 事件名 | 事件参数 | 描述 |
|---|---|---|
| onCollapse | region | 在折叠区域面板的时候触发。（该事件自1.4.4版开始可用） |
| onExpand | region | 在展开区域面板的时候触发。（该事件自1.4.4版开始可用） |
| onAdd | region | 在新增区域面板的时候触发。（该事件自1.4.4版开始可用） |
| onRemove | region | 在移除区域面板的时候触发。（该事件自1.4.4版开始可用） |
区域面板属性
区域面板属性定义与panel组件类似，下面的是公共的和新增的属性：
| 属性名 | 属性值类型 | 描述 | 默认值 |
|---|---|---|---|
| title | string | 布局面板标题文本。 | null |
| region | string | 定义布局面板位置，可用的值有：north, south, east, west, center。 | |
| border | boolean | 为true时显示布局面板边框。 | true |
| split | boolean | 为true时用户可以通过分割栏改变面板大小。 | false |
| iconCls | string | 一个包含图标的CSS类ID，该图标将会显示到面板标题上。 | null |
| href | string | 用于读取远程站点数据的URL链接 | null |
| collapsible | boolean | 定义是否显示折叠按钮。（该属性自1.3.3版开始可用） | true |
| minWidth | number | 最小面板宽度。（该属性自1.3.3版开始可用） | 10 |
| minHeight | number | 最小面板高度。（该属性自1.3.3版开始可用） | 10 |
| maxWidth | number | 最大面板宽度。（该属性自1.3.3版开始可用） | 10000 |
| maxHeight | number | 最大面板高度。（该属性自1.3.3版开始可用） | 10000 |
| expandMode | string | 在点击折叠面板时候的扩展模式。可用值有：“float”、“dock”和null float：区域面板将展开并浮动在顶部，在鼠标焦点离开面板时会自动隐藏。 dock：区域面板将展开并钉在面板上，在鼠标焦点离开面板时不会自动隐藏。 null：什么也不会发生。 （该属性自1.4.4版开始可用） |
float |
| collapsedSize | number | 折叠后的面板大小。（该属性自1.4.4版开始可用） | 28 |
| hideExpandTool | boolean | 为true时隐藏折叠面板上的扩展面板工具。（该属性自1.4.4版开始可用） | false |
| hideCollapsedContent | boolean | 为true时隐藏折叠面板上的标题栏。（该属性自1.4.4版开始可用） | true |
| collapsedContent | string,function(title) | 定义在折叠面板上要显示标题内容。 1. 标题字符串； 2. 通过函数返回标题内容。 （该方法自1.4.4版开始可用） 代码示例： collapsedContent: function(title){
var region = $(this).panel('options').region;
if (region == 'north' || region == 'south'){
return title;
} else {
return '<div class="mytitle">'+title+'</div>';
}
} |
方法
| 方法名 | 方法属性 | 描述 |
|---|---|---|
| resize | param |
设置布局大小。param对象包含如下属性： 代码示例： $('#cc').layout('resize', {
width:'80%',
height:300
}) |
| panel | region | 返回指定面板，'region'参数可用值有：'north','south','east','west','center'。 |
| collapse | region | 折叠指定面板。'region'参数可用值有：'north','south','east','west'。 |
| expand | region | 展开指定面板。'region'参数可用值有：'north','south','east','west'。 |
| add | options | 添加指定面板。属性参数是一个配置对象，更多细节请查看选项卡面板属性。 |
| remove | region | 移除指定面板。'region'参数可用值有：'north','south','east','west'。 |
| split | region |
分割区域面板。'region'参数可用值有：'north','south','east','west'。（该方法自1.4.2版开始可用） 代码示例： |
| unsplit | region |
移除指定面板。'region'参数可用值有：'north','south','east','west'。（该方法自1.4.2版开始可用） 代码示例： |
