4.9Bootstrap学习js插件篇之折叠

野性酷女 2022-08-27 04:43 167阅读 0赞

### 关于 ###

对为支持折叠功能的组件，例如accordions和导航，赋予基本样式和灵活的支持。

#### 插件依赖 ####

折叠插件依赖[过渡效果插件][Link 1]。

## 案例 ##

使用折叠插件，通过扩展panel组件从而构建了一个简单的accordion组件。

#### [Collapsible Group Item \#1][Collapsible Group Item _1] ####

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.

#### [Collapsible Group Item \#2][Collapsible Group Item _2] ####

#### [Collapsible Group Item \#3][Collapsible Group Item _3] ####

<div class="panel-group" id="accordion">
      <div class="panel panel-default">
        <div class="panel-heading">
          <h4 class="panel-title">
            <a data-toggle="collapse" data-toggle="collapse" data-parent="#accordion" href="#collapseOne">
              Collapsible Group Item #1
            </a>
          </h4>
        </div>
        <div id="collapseOne" class="panel-collapse collapse in">
          <div class="panel-body">
            Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
          </div>
        </div>
      </div>
      <div class="panel panel-default">
        <div class="panel-heading">
          <h4 class="panel-title">
            <a data-toggle="collapse" data-toggle="collapse" data-parent="#accordion" href="#collapseTwo">
              Collapsible Group Item #2
            </a>
          </h4>
        </div>
        <div id="collapseTwo" class="panel-collapse collapse">
          <div class="panel-body">
            Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
          </div>
        </div>
      </div>
      <div class="panel panel-default">
        <div class="panel-heading">
          <h4 class="panel-title">
            <a data-toggle="collapse" data-toggle="collapse" data-parent="#accordion" href="#collapseThree">
              Collapsible Group Item #3
            </a>
          </h4>
        </div>
        <div id="collapseThree" class="panel-collapse collapse">
          <div class="panel-body">
            Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
          </div>
        </div>
      </div>
    </div>

You can also use the plugin without the accordion markup. Make a button toggle the expanding and collapsing of another element.

<button type="button" class="btn btn-danger" data-toggle="collapse" data-target="#demo">
      simple collapsible
    </button>
    
    <div id="demo" class="collapse in">...</div>

## 预览效果： ##

![Center][]

## 用法 ##

The collapse plugin utilizes a few classes to handle the heavy lifting:

*  `.collapse` hides the content
 *  `.collapse.in` shows the content
 *  `.collapsing` is added when the transition starts, and removed when it finishes

These classes can be found in `component-animations.less`.

### 通过data属性 ###

仅仅通过向页面元素添加`data-toggle="collapse"` 和`data-target`就可以为其赋予控制可折叠页面元素的能力。`data-target`属性接受一个CSS选择器作为其控制对象。请确保为可折叠页面元素添加`collapse` class。如果你希望可折叠页面元素的默认状态是展开的，请添加`in` class。

为了给一组可折叠页面元素添加控制器，添加`data-parent="#selector"`即可。请参考下面给出的案例。

### 通过JavaScript ###

手动触发：

$('.collapse').collapse()

### 代码： ###

<button type="button" class="btn btn-danger" onClick="Open()">打开</button>
    	<button type="button" class="btn btn-danger" onClick="Hide()">折叠</button>
    
    	<div id="demo1" class="collapse in">Anim pariatur cliche r
    eprehenderit, enim eiusmod high life accusamus terry richardson 
    ad squid. 3 wolf moon officia aute, non cupidatat skateboard d
    olor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunc
    </div>

### 预览： ###

![16105940-3bcc4dc6f32d43619ad95c7f45b521ae.gif][]

### 选项 ###

可以将选项通过data属性或JavaScript传递。对于data属性，需要将选项名称放到`data-`之后，例如`data-parent=""`。

<table style="border-collapse:collapse; border-spacing:0px; max-width:100%; background-color:transparent; width:847px; margin-bottom:20px; border:1px solid rgb(221,221,221)"> 
 <thead style=""> 
  <tr style=""> 
   <th style="padding:8px; line-height:1.428571429; vertical-align:bottom; border-width:0px 1px 2px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); border-right-style:solid; border-left-style:solid; border-right-color:rgb(221,221,221); border-left-color:rgb(221,221,221); width:100px"> 名称</th> 
   <th style="padding:8px; line-height:1.428571429; vertical-align:bottom; border-width:0px 1px 2px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); border-right-style:solid; border-left-style:solid; border-right-color:rgb(221,221,221); border-left-color:rgb(221,221,221); width:50px"> 类型</th> 
   <th style="padding:8px; line-height:1.428571429; vertical-align:bottom; border-width:0px 1px 2px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); border-right-style:solid; border-left-style:solid; border-right-color:rgb(221,221,221); border-left-color:rgb(221,221,221); width:50px"> 默认值</th> 
   <th style="padding:8px; line-height:1.428571429; vertical-align:bottom; border-width:0px 1px 2px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); border-right-style:solid; border-left-style:solid; border-right-color:rgb(221,221,221); border-left-color:rgb(221,221,221)"> 描述</th> 
  </tr> 
 </thead> 
 <tbody style=""> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> parent</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> selector</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> false</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> If selector then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior - this dependent on the<code style="font-family:Menlo,Monaco,Consolas,'Courier New',monospace; font-size:13px; padding:2px 4px; color:rgb(199,37,78); white-space:nowrap; background-color:rgb(249,242,244)">accordion-group</code>&nbsp;class)</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> toggle</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> boolean</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> true</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> Toggles the collapsible element on invocation</td> 
  </tr> 
 </tbody> 
</table>

### 方法 ###

#### .collapse(options) ####

赋予页面元素可折叠功能。接受一个可选的`object`作为参数。

$('#myCollapsible').collapse({
      toggle: false
    })

#### .collapse('toggle') ####

展示或隐藏一个可折叠的页面元素。

#### .collapse('show') ####

展示一个可折叠页面元素。

#### .collapse('hide') ####

隐藏一个可折叠页面元素。

### 事件 ###

Bootstrap中的折叠插件对外暴露了一组可以监听的事件。

<table style="border-collapse:collapse; border-spacing:0px; max-width:100%; background-color:transparent; width:847px; margin-bottom:20px; border:1px solid rgb(221,221,221)"> 
 <thead style=""> 
  <tr style=""> 
   <th style="padding:8px; line-height:1.428571429; vertical-align:bottom; border-width:0px 1px 2px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); border-right-style:solid; border-left-style:solid; border-right-color:rgb(221,221,221); border-left-color:rgb(221,221,221); width:150px"> 事件类型</th> 
   <th style="padding:8px; line-height:1.428571429; vertical-align:bottom; border-width:0px 1px 2px; border-bottom-style:solid; border-bottom-color:rgb(221,221,221); border-right-style:solid; border-left-style:solid; border-right-color:rgb(221,221,221); border-left-color:rgb(221,221,221)"> 描述</th> 
  </tr> 
 </thead> 
 <tbody style=""> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> show.bs.collapse</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> 当<code style="font-family:Menlo,Monaco,Consolas,'Courier New',monospace; font-size:13px; padding:2px 4px; color:rgb(199,37,78); white-space:nowrap; background-color:rgb(249,242,244)">show</code>方法被调用之后立即触发此事件。</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> shown.bs.collapse</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> 当可折叠页面元素显示出来之后（同时CSS过渡效果也已执行完毕），此事件被触发。</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> hide.bs.collapse</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221); background-color:rgb(249,249,249)"> 当<code style="font-family:Menlo,Monaco,Consolas,'Courier New',monospace; font-size:13px; padding:2px 4px; color:rgb(199,37,78); white-space:nowrap; background-color:rgb(249,242,244)">hide</code>方法被调用之后，此事件被立即触发。</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> hidden.bs.collapse</td> 
   <td style="padding:8px; line-height:1.428571429; vertical-align:top; border:1px solid rgb(221,221,221)"> 当可折叠页面元素隐藏之后（同时CSS过渡效果也已执行完毕），此事件被触发。</td> 
  </tr> 
 </tbody> 
</table>

$('#myCollapsible').on('hidden.bs.collapse', function () { 
      // do something…
    })

[Link 1]: http://v3.bootcss.com/javascript/#transitions
[Collapsible Group Item _1]: http://v3.bootcss.com/javascript/#collapseOne
[Collapsible Group Item _2]: http://v3.bootcss.com/javascript/#collapseTwo
[Collapsible Group Item _3]: http://v3.bootcss.com/javascript/#collapseThree
[Center]: /images/20220824/a153513226d74a0382f9d3a0216f41fa.png
[16105940-3bcc4dc6f32d43619ad95c7f45b521ae.gif]: /images/20220824/f928635400e24e85bab238ccc0601f00.png