Accordion(分类)
使用$.fn.accordion.defaults重写默认值对象。
分类空间允许用户使用多面板,但在同一时间只会显示一个。每个面板都内建支持展开和折叠功能。点击一个面板的标题将会展开或折叠面板主体。面板内容可以通过指定的'href'属性使用ajax方式读取面板内容。用户可以定义一个被默认选中的面板,如果未指定,那么第一个面板就是默认的。
依赖关系
使用案例
创建分类
通过标签创建分类,给<div/>标签添加一个名为'easyui-accordion'的类ID。
- <div id="aa" class="easyui-accordion" style="width:300px;height:200px;">
- <div title="Title1" data-options="iconCls:'icon-save'" style="overflow:auto;padding:10px;">
- <h3 style="color:#0099FF;">Accordion for jQuery</h3>
- <p>Accordion is a part of easyui framework for jQuery.
- It lets you define your accordion component on web page more easily.</p>
- </div>
- <div title="Title2" data-options="iconCls:'icon-reload',selected:true" style="padding:10px;">
- content2
- </div>
- <div title="Title3">
- content3
- </div>
- </div>
我们可以更改或修改面板的一些功能以后再重新创建它。
- $('#aa').accordion({
- animate:false
- });
刷新分类面板内容
调用'getSelected'方法获取当前面板,此外我们还可以调用'refresh'方法重新载入新内容。
- var pp = $('#aa').accordion('getSelected');
- if (pp){
- pp.panel('refresh','new_content.php');
- }
容器属性
属性名 |
属性值类型 |
描述 |
默认值 |
width |
number |
分类容器的宽度。 |
auto |
height |
number |
分类容器的高度。 |
auto |
fit |
boolean |
如果设置为true,分类容器大小将自适应父容器。 |
false |
border |
boolean |
定义是否显示边框。 |
true |
animate |
boolean |
定义在展开和折叠的时候是否显示动画效果。 |
true |
multiple |
boolean |
如果为true时,同时展开多个面板。(该属性自1.3.5版开始可用) |
false |
selected |
number |
设置初始化时默认选中的面板索引号。(该属性自1.3.5版开始可用) |
0 |
面板属性
分类面板属性继承自panel(面板),分类面板新增的属性如下:
属性名 |
属性值类型 |
描述 |
默认值 |
selected |
boolean |
如果设置为true将展开面板。 |
false |
collapsible |
boolean |
如果设置为true将显示折叠按钮。 |
true |
事件
事件名 |
事件参数 |
描述 |
onSelect |
title,index |
在面板被选中的时候触发。 |
onUnselect |
title,index |
在面板被取消选中的时候触发。(该方法自1.3.5版开始可用) |
onAdd |
title,index |
在添加新面板的时候触发。 |
onBeforeRemove |
title,index |
在移除面板之前触发,返回false可以取消移除操作。 |
onRemove |
title,index |
在面板被移除的时候触发。 |
方法
方法名 |
方法参数 |
描述 |
options |
none |
返回分类组件的属性。 |
panels |
none |
获取所有面板。 |
resize |
none |
调整分类组件大小。 |
getSelected |
none |
获取选中的面板。 |
getSelections |
none |
获取所有选中的面板。(该方法自1.3.5版开始可用) |
getPanel |
which |
获取指定的面板,'which'参数可以是面板的标题或者索引。 |
getPanelIndex |
panel |
获取指定面板的索引。(该方法自1.3版开始可用)
以下示例显示如何获取选中面板的索引。 var p = $('#aa').accordion('getSelected');
if (p){
var index = $('#aa').accordion('getPanelIndex', p);
alert(index);
}
|
select |
which |
选择指定面板。'which'参数可以是面板标题或者索引。 |
unselect |
which |
取消选择指定面板。'which'参数可以是面板标题或者索引。(该方法自1.3.5版开始可用) |
add |
options |
添加一个新面板。在默认情况下,新增的面板会变成当前面板。如果要添加一个非选中面板,不要忘记将'selected'属性设置为false。
代码示例: $('#aa').accordion('add', {
title: '新标题',
content: '新内容',
selected: false
});
|
remove |
which |
移除指定面板。'which'参数可以使面板的标题或者索引。 |
;