小部件(Widgets)
描述:把一对标题和内容面板转换成折叠面板。
版本新增:1.0
折叠面板容器的标记需要一对标题和内容面板。
- <div id="accordion">
- <h3>First header</h3>
- <div>First content panel</div>
- <h3>Second header</h3>
- <div>Second content panel</div>
- </div>
折叠面板支持任意标记,但是每个内容面板必须是与其相关的头部面板的下一个同级。请查看 header
选项了解如何使用自定义的标记结构。
面板可以通过设置 active
选项以编程的方式激活。
当焦点在标题(header)上时,下面的键盘命令可用:
当焦点在面板(panel)中时,下面的键盘命令可用:
折叠面板部件(Accordion Widget)使用 jQuery UI CSS 框架 来定义它的外观和感观的样式。如果需要使用折叠面板指定的样式,则可以使用下面的 CSS class 名称:
ui-accordion
:折叠面板的外层容器。ui-accordion-header
:折叠面板的标题。如果标题包含 icons
,则标题会另外有个 ui-accordion-icons
class。ui-accordion-content
:折叠面板的内容面板。animate
选项一起使用时)选项 | 类型 | 描述 | 默认值 |
---|---|---|---|
active | Boolean 或 Integer | 当前打开哪一个面板。 支持多个类型:
代码实例: 初始化带有指定
在初始化后,获取或设置
| 0 |
animate | Boolean 或 Number 或 String 或 Object | 是否使用动画改变面板,且如何使用动画改变面板。 支持多个类型:
代码实例: 初始化带有指定
在初始化后,获取或设置
| {} |
collapsible | Boolean | 所有部分是否都可以马上关闭。允许折叠激活的部分。 代码实例: 初始化带有指定
在初始化后,获取或设置
| false |
disabled | Boolean | 如果设置为 true ,则禁用该 accordion。代码实例: 初始化带有指定
在初始化后,获取或设置
| false |
event | String | accordion 头部会作出反应的事件,用以激活相关的面板。可以指定多个事件,用空格间隔。 代码实例: 初始化带有指定
在初始化后,获取或设置
| "click" |
header | Selector | 标题元素的选择器,通过主要 accordion 元素上的 .find() 进行应用。内容面板必须是紧跟在与其相关的标题后的同级元素。 代码实例: 初始化带有指定
在初始化后,获取或设置
| "> li > :first-child,> :not(li):even" |
heightStyle | String | 控制 accordion 和每个面板的高度。可能的值:
代码实例: 初始化带有指定
在初始化后,获取或设置
| "auto" |
icons | Object | 标题要使用的图标,与 jQuery UI CSS 框架提供的图标(Icons) 匹配。设置为 false 则不显示图标。
代码实例: 初始化带有指定
在初始化后,获取或设置
| { "header": "ui-icon-triangle-1-e", "activeHeader": "ui-icon-triangle-1-s" } |
方法 | 返回 | 描述 |
---|---|---|
destroy() | jQuery (plugin only) | 完全移除 accordion 功能。这会把元素返回到它的预初始化状态。
代码实例: 调用 destroy 方法:
|
disable() | jQuery (plugin only) | 禁用 accordion。
代码实例: 调用 disable 方法:
|
enable() | jQuery (plugin only) | 启用 accordion。
代码实例: 调用 enable 方法:
|
option( optionName ) | Object | 获取当前与指定的 optionName 关联的值。
代码实例: 调用该方法:
|
option() | PlainObject | 获取一个包含键/值对的对象,键/值对表示当前 accordion 选项哈希。
代码实例: 调用该方法:
|
option( optionName, value ) | jQuery (plugin only) | 设置与指定的 optionName 关联的 accordion 选项的值。
代码实例: 调用该方法:
|
option( options ) | jQuery (plugin only) | 为 accordion 设置一个或多个选项。
代码实例: 调用该方法:
|
refresh() | jQuery (plugin only) | 处理任何在 DOM 中直接添加或移除的标题和面板,并重新计算 accordion 的高度。结果取决于内容和 heightStyle 选项。
代码实例: 调用 refresh 方法:
|
widget() | jQuery | 返回一个包含 accordion 的 jQuery 对象。
代码实例: 调用 widget 方法:
|
事件 | 类型 | 描述 |
---|---|---|
activate( event, ui ) | accordionactivate | 面板被激活后触发(在动画完成之后)。如果 accordion 之前是折叠的,则 ui.oldHeader 和 ui.oldPanel 将是空的 jQuery 对象。如果 accordion 正在折叠,则 ui.newHeader 和 ui.newPanel 将是空的 jQuery 对象。注意:由于
代码实例: 初始化带有指定 activate 回调的 accordion:
绑定一个事件监听器到 accordionactivate 事件:
|
beforeActivate( event, ui ) | accordionbeforeactivate | 面板被激活前直接触发。可以取消以防止面板被激活。如果 accordion 当前是折叠的,则 ui.oldHeader 和 ui.oldPanel 将是空的 jQuery 对象。如果 accordion 正在折叠,则 ui.newHeader 和 ui.newPanel 将是空的 jQuery 对象。
代码实例: 初始化带有指定 beforeActivate 回调的 accordion:
绑定一个事件监听器到 accordionbeforeactivate 事件:
|
create( event, ui ) | accordioncreate | 当创建 accordion 时触发。如果 accordion 是折叠的,ui.header 和 ui.panel 将是空的 jQuery 对象。
代码实例: 初始化带有指定 create 回调的 accordion:
绑定一个事件监听器到 accordioncreate 事件:
|
一个简单的 jQuery UI 折叠面板(Accordion)。
- <!doctype html>
- <html lang="en">
- <head>
- <meta charset="utf-8">
- <title>折叠面板部件(Accordion Widget)演示</title>
- <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
- <script src="//code.jquery.com/jquery-1.10.2.js"></script>
- <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
- </head>
- <body>
- <div id="accordion">
- <h3>部分 1</h3>
- <div>
- <p>Mauris mauris ante, blandit et, ultrices a, suscipit eget.
- Integer ut neque. Vivamus nisi metus, molestie vel, gravida in,
- condimentum sit amet, nunc. Nam a nibh. Donec suscipit eros.
- Nam mi. Proin viverra leo ut odio.</p>
- </div>
- <h3>部分 2</h3>
- <div>
- <p>Sed non urna. Phasellus eu ligula. Vestibulum sit amet purus.
- Vivamus hendrerit, dolor aliquet laoreet, mauris turpis velit,
- faucibus interdum tellus libero ac justo.</p>
- </div>
- <h3>部分 3</h3>
- <div>
- <p>Nam enim risus, molestie et, porta ac, aliquam ac, risus.
- Quisque lobortis.Phasellus pellentesque purus in massa.</p>
- <ul>
- <li>List item one</li>
- <li>List item two</li>
- <li>List item three</li>
- </ul>
- </div>
- </div>
- <script>
- $( "#accordion" ).accordion();
- </script>
- </body>
- </html>