1.Bootstrap 插件概览

在前面 布局组件 章节中所讨论到的组件仅仅是个开始。Bootstrap 自带 12 种 jQuery 插件，扩展了功能，可以给站点添加更多的互动。即使您不是一名高级的 JavaScript 开发人员，您也可以着手学习 Bootstrap 的 JavaScript 插件。利用 Bootstrap 数据 API（Bootstrap Data API），大部分的插件可以在不编写任何代码的情况被触发。

站点引用 Bootstrap 插件的方式有两种：

• 单独引用：使用 Bootstrap 的个别的 *.js 文件。一些插件和 CSS 组件依赖于其他插件。如果您单独引用插件，请先确保弄清这些插件之间的依赖关系。
• 编译（同时）引用：使用 bootstrap.js 或压缩版的 bootstrap.min.js。

  不要尝试同时引用这两个文件，因为 bootstrap.js 和 bootstrap.min.js 都包含了所有的插件。

所有的插件依赖于 jQuery。所以必须在插件文件之前引用 jQuery。请访问 bower.json 查看 Bootstrap 当前支持的 jQuery 版本。

1.1data 属性

• 你可以仅仅通过 data 属性 API 就能使用所有的 Bootstrap 插件，无需写一行 JavaScript 代码。这是 Bootstrap 中的一等 API，也应该是你的首选方式。
• 话又说回来，在某些情况下可能需要将此功能关闭。因此，我们还提供了关闭 data 属性 API 的方法，即解除以 data-api为命名空间并绑定在文档上的事件。就像下面这样：

$(document).off(‘.data-api‘)

$(document).off(‘.alert.data-api‘)

1.2编程方式的 API

我们为所有 Bootstrap 插件提供了纯 JavaScript 方式的 API。所有公开的 API 都是支持单独或链式调用方式，并且返回其所操作的元素集合（注：和jQuery的调用形式一致）。例如：

$(".btn.danger").button("toggle").addClass("fat")

所有的方法都可以接受一个可选的选项对象作为参数，或者一个代表特定方法的字符串，或者不带任何参数（这种情况下，将会初始化插件为默认行为），如下所示：

/ 初始化为默认行为
$("#myModal").modal()    
 // 初始化为不支持键盘               
$("#myModal").modal({ keyboard: false })  
// 初始化并立即调用 show
$("#myModal").modal(‘show‘)             

1.3事件

Bootstrap 为大多数插件的独特行为提供了自定义事件。一般来说，这些事件有两种形式：

• 动词不定式：这会在事件开始时被触发。例如 ex: show。动词不定式事件提供了 preventDefault 功能。这使得在事件开始前可以停止操作的执行。

  $(‘#myModal‘).on(‘show.bs.modal‘, function (e) {
  // 阻止模态框的显示
    if (!data) return e.preventDefault() 
  })

• 过去分词形式：这会在动作执行完毕之后被触发。例如 ex: shown。

2.Bootstrap 模态框（Modal）插件

模态框（Modal）是覆盖在父窗体上的子窗体。通常，目的是显示来自一个单独的源的内容，可以在不离开父窗体的情况下有一些互动。子窗体可提供信息、交互等。

2.1用法

您可以切换模态框（Modal）插件的隐藏内容：

• 通过 data 属性：在控制器元素（比如按钮或者链接）上设置属性 data-toggle="modal"，同时设置 data-target="#identifier" 或 href="http://www.mamicode.com/#identifier" 来指定要切换的特定的模态框（带有 id="identifier"）。
• 通过 JavaScript：使用这种技术，您可以通过简单的一行 JavaScript 来调用带有 id="identifier" 的模态框：

$(‘#identifier‘).modal(options)

2.2实例

一个静态的模态窗口实例，如下面的实例所示：

<h2>创建模态框（Modal）</h2>
<!-- 按钮触发模态框 -->
<button class="btn btn-primary btn-lg" data-toggle="modal" data-target="#myModal">开始演示模态框</button>
<!-- 模态框（Modal） -->
<div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true">
    <div class="modal-dialog">
        <div class="modal-content">
            <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
                <h4 class="modal-title" id="myModalLabel">模态框（Modal）标题</h4>
            </div>
            <div class="modal-body">在这里添加一些文本</div>
            <div class="modal-footer">
                <button type="button" class="btn btn-default" data-dismiss="modal">关闭</button>
                <button type="button" class="btn btn-primary">提交更改</button>
            </div>
        </div><!-- /.modal-content -->
    </div><!-- /.modal -->
</div>

代码讲解：

• 使用模态窗口，您需要有某种触发器。您可以使用按钮或链接。这里我们使用的是按钮。
• 如果您仔细查看上面的代码，您会发现在 <button> 标签中，data-target="#myModal" 是您想要在页面上加载的模态框的目标。您可以在页面上创建多个模态框，然后为每个模态框创建不同的触发器。现在，很明显，您不能在同一时间加载多个模块，但您可以在页面上创建多个在不同时间进行加载。
• 在模态框中需要注意两点：
  1. 第一是 .modal，用来把 <div> 的内容识别为模态框。
  2. 第二是 .fade class。当模态框被切换时，它会引起内容淡入淡出。
• aria-labelledby="myModalLabel"，该属性引用模态框的标题。
• 属性 aria-hidden="true" 用于保持模态窗口不可见，直到触发器被触发为止（比如点击在相关的按钮上）。
• <div class="modal-header">，modal-header 是为模态窗口的头部定义样式的类。
• class="close"，close 是一个 CSS class，用于为模态窗口的关闭按钮设置样式。
• data-dismiss="modal"，是一个自定义的 HTML5 data 属性。在这里它被用于关闭模态窗口。
• class="modal-body"，是 Bootstrap CSS 的一个 CSS class，用于为模态窗口的主体设置样式。
• class="modal-footer"，是 Bootstrap CSS 的一个 CSS class，用于为模态窗口的底部设置样式。
• data-toggle="modal"，HTML5 自定义的 data 属性 data-toggle 用于打开模态窗口。

2.3方法

$(‘#identifier‘).modal({
keyboard: false
})//把内容作为模态框激活。接受一个可选的选项对象。
$(‘#identifier‘).modal(‘toggle‘)//手动切换模态框。
$(‘#identifier‘).modal(‘show‘)//手动打开模态框。
$(‘#identifier‘).modal(‘hide‘)//手动隐藏模态框。

2.4事件

$(‘#identifier‘).on(‘show.bs.modal‘, function () {
  // 执行一些动作...
})//在调用 show 方法后触发。

$(‘#identifier‘).on(‘shown.bs.modal‘, function () {
  // 执行一些动作...
})//当模态框对用户可见时触发（将等待 CSS 过渡效果完成）

$(‘#identifier‘).on(‘hide.bs.modal‘, function () {
  // 执行一些动作...
})//当调用 hide 实例方法时触发。

$(‘#identifier‘).on(‘hidden.bs.modal‘, function () {
  // 执行一些动作...
})//当模态框完全对用户隐藏时触发。

Bootstrap 插件