折叠效果组件,用于制作下滑菜单或手风琴效果。
结合 Panel 组件实现手风琴效果。需结合以下辅助 class 使用:
.am-collapse
;.am-collapse.am-in
;添加以上 class 以后,通过 Data API 来调用:
<h4 data-am-collapse="{parent: '#accordion', target: '#do-not-say-1'}"></h4>
其中:
parent
为容器 IDtarget
为要伸缩的容器 ID如果触发元素为 <a>
元素,可以把 target
设置在 href
属性里。
<a data-am-collapse="{parent: '#accordion'}" href="#do-not-say-1">
...
</a>
<div class="am-panel-group" id="accordion">
<div class="am-panel am-panel-default">
<div class="am-panel-hd">
<h4 class="am-panel-title" data-am-collapse="{parent: '#accordion', target: '#do-not-say-1'}">
...
</h4>
</div>
<div id="do-not-say-1" class="am-panel-collapse am-collapse am-in">
<div class="am-panel-bd">
...
</div>
</div>
</div>
<div class="am-panel am-panel-default">
<div class="am-panel-hd">
<h4 class="am-panel-title" data-am-collapse="{parent: '#accordion', target: '#do-not-say-2'}">
...
</h4>
</div>
<div id="do-not-say-2" class="am-panel-collapse am-collapse">
<div class="am-panel-bd">
...
</div>
</div>
</div>
<div class="am-panel am-panel-default">
<div class="am-panel-hd">
<h4 class="am-panel-title" data-am-collapse="{parent: '#accordion', target: '#do-not-say-3'}">...</h4>
</div>
<div id="do-not-say-3" class="am-panel-collapse am-collapse">
<div class="am-panel-bd">
...
</div>
</div>
</div>
</div>
使用时注意目标元素外面应该有一个容器,以便动画执行时计算高端。
<button class="am-btn am-btn-primary" data-am-collapse="{target: '#collapse-nav'}">Menu <i class="am-icon-bars"></i></button>
<nav>
<ul id="collapse-nav" class="am-nav am-collapse">
<li><a href="">开始使用</a></li>
<li><a href="">CSS 介绍</a></li>
<li class="am-active"><a href="">JS 介绍</a></li>
<li><a href="">功能定制</a></li>
</ul>
</nav>
在元素上添加 data-am-collapse
并设置 target
的值为折叠元素 ID:
<button data-am-collapse="{target: '#my-collapse'}"></button>
使用方法:
$('#myCollapse').collapse()
$().collapse(options)
- 绑定元素展开/折叠操作$('#myCollapse').collapse({
toggle: false
})
$().collapse('toggle')
- 切换面板状态$().collapse('open')
- 展开面板$().collapse('close')
- 关闭面板参数 | 类型 | 默认 | 描述 |
---|---|---|---|
parent | 选择符 | false | 如果设置了 parent 参数,且该容器下有多个可折叠的面板时,展开一个面板会关闭其它展开的面板。换言之,如果想让多个面板可以都处于展开状态,那不设置这个参数即可。 |
toggle | 布尔值 | true | 交替执行展开/关闭操作 |
事件 | 描述 |
---|---|
open:collapse:amui | open 方法被调用时立即触发 |
opened:collapse:amui | 元素完全展开后触发 |
close:collapse:amui | close 方法被调用后立即触发 |
closed:collapse:amui | 元素折叠完成后触发 |