Skip to content

Accordion(分类)

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

分类空间允许用户使用多面板,但在同一时间只会显示一个。每个面板都内建支持展开和折叠功能。点击一个面板的标题将会展开或折叠面板主体。面板内容可以通过指定的'href'属性使用ajax方式读取面板内容。用户可以定义一个被默认选中的面板,如果未指定,那么第一个面板就是默认的。

依赖关系

用法

创建分类

通过标签创建分类,给<div/>标签添加data-toggle="topjui-accordion"

html
<div id="aa" data-toggle="topjui-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 topjui 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>

我们可以更改或修改面板的一些功能以后再重新创建它。

javascript
$('#aa').iAccordion({
  animate:false
});

刷新分类面板内容

调用'getSelected'方法获取当前面板,此外我们还可以调用'refresh'方法重新载入新内容。

javascript
var pp = $('#aa').iAccordion('getSelected');
if (pp){
  pp.iPanel('refresh','new_content.php');
}

属性

属性名属性值类型描述默认值
widthnumber分类容器的宽度。auto
heightnumber分类容器的高度。auto
fitboolean如果设置为true,分类容器大小将自适应父容器。false
borderboolean定义是否显示边框。true
animateboolean定义在展开和折叠的时候是否显示动画效果。true
multipleboolean如果为true时,同时展开多个面板。false
selectednumber设置初始化时默认选中的面板索引号。0
halignstring设置分类面板头部对齐方式。可用值有:'top', 'left', 'right'。top

分类面板属性

分类面板属性继承自panel(面板),分类面板新增的属性如下:

属性名属性值类型描述默认值
selectedboolean如果设置为true将展开面板。false
collapsibleboolean如果设置为true将显示折叠按钮。true

事件

事件名事件参数描述
onSelecttitle,index在面板被选中的时候触发。
onUnselecttitle,index在面板被取消选中的时候触发。
onAddtitle,index在添加新面板的时候触发。
onBeforeRemovetitle,index在移除面板之前触发,返回false可以取消移除操作。
onRemovetitle,index在面板被移除的时候触发。

方法

方法名方法参数描述
optionsnone返回分类组件的属性。
panelsnone获取所有面板。
resizenone调整分类组件大小。
getSelectednone获取选中的面板。
getSelectionsnone获取所有选中的面板。
getPanelwhich获取指定的面板,'which'参数可以是面板的标题或者索引。
getPanelIndexpanel获取指定面板的索引。见下方代码示例。
selectwhich选择指定面板。'which'参数可以是面板标题或者索引。
unselectwhich取消选择指定面板。'which'参数可以是面板标题或者索引。
addoptions添加一个新面板。在默认情况下,新增的面板会变成当前面板。如果要添加一个非选中面板,不要忘记将'selected'属性设置为false。见下方代码示例。
removewhich移除指定面板。'which'参数可以使面板的标题或者索引。

方法代码示例

getPanelIndex方法示例:

以下示例显示如何获取选中面板的索引:

javascript
var p = $('#aa').iAccordion('getSelected');
if (p){
  var index = $('#aa').iAccordion('getPanelIndex', p);
  alert(index);
}

add方法示例:

javascript
$('#aa').iAccordion('add', {
  title: '新标题',
  content: '新内容',
  selected: false
});

基于最新稳定版jQuery EasyUI构建的前端框架