Bootstrap 模态框（Modal）插件

http://www.runoob.com/bootstrap/bootstrap-modal-plugin.html

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

如果您想要单独引用该插件的功能，那么您需要引用 modal.js。或者，正如 Bootstrap 插件概览一章中所提到，您可以引用 bootstrap.js 或压缩版的 bootstrap.min.js。

用法

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

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

实例

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

<!DOCTYPE html>
<html>
<head>
   <title>Bootstrap 实例 - 模态框（Modal）插件</title>
   <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
   <script src="/scripts/jquery.min.js"></script>
   <script src="/bootstrap/js/bootstrap.min.js"></script>
</head>
<body>

<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 -->

</body>
</html>

结果如下所示：

代码讲解：

使用模态窗口，您需要有某种触发器。您可以使用按钮或链接。这里我们使用的是按钮。
如果您仔细查看上面的代码，您会发现在 <button> 标签中，data-target="#myModal" 是您想要在页面上加载的模态框的目标。您可以在页面上创建多个模态框，然后为每个模态框创建不同的触发器。现在，很明显，您不能在同一时间加载多个模块，但您可以在页面上创建多个在不同时间进行加载。
在模态框中需要注意两点：
- 第一是 .modal，用来把 <div> 的内容识别为模态框。
- 第二是 .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 用于打开模态窗口。

选项

有一些选项可以用来定制模态窗口（Modal Window）的外观和感观，它们是通过 data 属性或 JavaScript 来传递的。下表列出了这些选项：

选项名称	类型/默认值	Data 属性名称	描述
backdrop	boolean 或 string 'static' 默认值：true	data-backdrop	指定一个静态的背景，当用户点击模态框外部时不会关闭模态框。
keyboard	boolean 默认值：true	data-keyboard	当按下 escape 键时关闭模态框，设置为 false 时则按键无效。
show	boolean 默认值：true	data-show	当初始化时显示模态框。
remote	path 默认值：false	data-remote	使用 jQuery .load 方法，为模态框的主体注入内容。如果添加了一个带有有效 URL 的 href，则会加载其中的内容。如下面的实例所示： <a data-toggle="modal" href="remote.html" data-target="#modal">请点击我</a>

方法

下面是一些可与 modal() 一起使用的有用的方法。

方法	描述	实例
Options: .modal(options)	把内容作为模态框激活。接受一个可选的选项对象。	$('#identifier').modal({ keyboard: false })
Toggle: .modal('toggle')	手动切换模态框。	$('#identifier').modal('toggle')
Show: .modal('show')	手动打开模态框。	$('#identifier').modal('show')
Hide: .modal('hide')	手动隐藏模态框。	$('#identifier').modal('hide')

实例

下面的实例演示了方法的用法：

<!DOCTYPE html>
<html>
<head>
   <title>Bootstrap 实例 - 模态框（Modal）插件方法</title>
   <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
   <script src="/scripts/jquery.min.js"></script>
   <script src="/bootstrap/js/bootstrap.min.js"></script>
</head>
<body>

<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">×
            </button>
            <h4 class="modal-title" id="myModalLabel">
               模态框（Modal）标题
            </h4>
         </div>
         <div class="modal-body">
            按下 ESC 按钮退出。
         </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-dialog -->
</div><!-- /.modal -->
<script>
   $(function () { $('#myModal').modal({
      keyboard: true
   })});
</script>

</body>
</html>

结果如下所示：

只需要点击 ESC 键，模态窗口即会退出。

事件

下表列出了模态框中要用到事件。这些事件可在函数中当钩子使用。

事件	描述	实例
show.bs.modal	在调用 show 方法后触发。	$('#identifier').on('show.bs.modal', function () { // 执行一些动作... })
shown.bs.modal	当模态框对用户可见时触发（将等待 CSS 过渡效果完成）。	$('#identifier').on('shown.bs.modal', function () { // 执行一些动作... })
hide.bs.modal	当调用 hide 实例方法时触发。	$('#identifier').on('hide.bs.modal', function () { // 执行一些动作... })
hidden.bs.modal	当模态框完全对用户隐藏时触发。	$('#identifier').on('hidden.bs.modal', function () { // 执行一些动作... })

实例

下面的实例演示了事件的用法：

<!DOCTYPE html>
<html>
<head>
   <title>Bootstrap 实例 - 模态框（Modal）插件事件</title>
   <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet">
   <script src="/scripts/jquery.min.js"></script>
   <script src="/bootstrap/js/bootstrap.min.js"></script>
</head>
<body>

<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">×
            </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-dialog -->
</div><!-- /.modal -->
<script>
   $(function () { $('#myModal').modal('hide')})});
</script>
<script>
   $(function () { $('#myModal').on('hide.bs.modal', function () {
      alert('嘿，我听说您喜欢模态框...');})
   });
</script>

</body>
</html>

---------------------------------------------------------------

Bootstrap Modals（模态框）

描述

Bootstrap Modals（模态框）是使用定制的 Jquery 插件创建的。它可以用来创建模态窗口丰富用户体验，或者为用户添加实用功能。您可以在 Modals（模态框）中使用 Popover（弹出框）和 Tooltip（工具提示插件）。

在本教程中，将通过一些实例和解释来讨论如何使用 Bootstrap 创建模态窗口。同时，我们也会讨论用于定制的各种可用选项。

什么是必需的

您需要 Jquery、Bootstrap CSS 和 JavaScript 文件 bootstrap-modal.js。这个 js 文件位于您下载的 Bootstrap 主文件夹中的 js 文件夹内。

Jquery 位于您的 Bootstrap 主文件夹中的 docs > assets > js 下，名为 jquery.js。或者您可以直接访问 https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js 下载 Jquery。

Bootstrap Modals（模态框）长什么样

下面的实例演示了 Bootstrap Modals（模态框）长什么样。

Bootstrap Modals

在您的网站中使用 Bootstrap Modals（模态框）

下面的实例演示了如何在网页中使用 Bootstrap Modals（模态框）。请注意，您不需要编写任何的 JavaScript 代码。实例后面附有相关的解释。

<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="utf-8"> 
<title>Twitter Bootstrap Modals Example</title> 
<meta name="description" content="Creating Modal Window with Twitter Bootstrap">
<link href="/twitter-bootstrap/twitter-bootstrap-v2/docs/assets/css/bootstrap.css" rel="stylesheet"> 
</head>
<body>
<div class="container">
<h2>Example of creating Modals with Twitter Bootstrap</h2>
<div id="example" class="modal hide fade in" style="display: none; ">
<div class="modal-header">
<a class="close" data-dismiss="modal">×</a>
<h3>This is a Modal Heading</h3>
</div>
<div class="modal-body">
<h4>Text in a modal</h4>
<p>You can add some text here.</p>		        
</div>
<div class="modal-footer">
<a href="#" class="btn btn-success">Call to action</a>
<a href="#" class="btn" data-dismiss="modal">Close</a>
</div>
</div>
<p><a data-toggle="modal" href="#example" class="btn btn-primary btn-large">Launch demo modal</a></p>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="/twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-modal.js"></script>
</body>
</html>

在线查看 Bootstrap Modals（模态框）实例。

解释

下面的表格解释了上面的代码。它将帮助您理解如何使用 Bootstrap Modals（模态框）。

代码	解释
div id="example"	分配给相关 div 的 id，id 的值指向后边要实现 modal（模态框）的 JavaScript。
class="modal hide fade in"	Bootstrap CSS 的四个 class - modal、hide、fade 和 in，用于设置 modal（模态框）的布局。
style="display: none;	用于保持模态窗口可见，直到触发器触发（比如点击相关按钮）。
<div class="modal-header">	modal-header 适用于定义模态窗口标题样式的 class。
a class="close"	CSS class close 用于设置模态窗口关闭按钮的样式。
data-dismiss="modal"	data-dismiss 是一个定制的 HTML5 data 属性。用于关闭模态窗口。
class="modal-body"	modal-body 是 Bootstrap 的一个 CSS class，用于设置模态窗口主体的样式。
class="modal-footer"	modal-footer 是 Bootstrap 的一个 CSS class，用于设置模态窗口尾部的样式。
class="btn btn-success"	CSS class btn 和 btn-success 用于在模态窗口的尾部创建一个大号的按钮。您可以使用任何其他 Bootstrap 按钮代替。
class="btn"	Bootstrap CSS 的按钮 class btn，用于在模态窗口的尾部创建一个小号的按钮。
data-dismiss="modal"	HTML5 定制的 data 属性 data-dismiss，用于关闭模态窗口。
data-toggle="modal"	HTML5 定制的 data 属性 data-toggle，用于打开模态窗口。
class="btn btn-primary btn-large"	设置按钮样式，点击该按钮则创建模态窗口。
<script src="https://ajax.googleapis.com/ajax/libs /jquery/1.7.1/jquery.min.js"></script>	引用 Jquery 文件。
<script src="../bootstrap/twitter-bootstrap-v2> /js/bootstrap-modal.js"></script>	引用 bootstrap modal（模态框）的 JS 文件。

使用 JavaScript

您可以使用 JavaScript 来实现 Bootstrap 模态窗口。只需要在您的 JavaScript 中调用 modal() 即可。您的代码如下所示，您可以在 body 结束标签（即 </body>）前引用它。

 $(function ()  
{ $("#identifier").modal();  
});

其中 identifier 是一个 Jquery 选择器，用于标识相关的容器元素。接下来，我们来看看 options 都有哪些。

选项

下面是一些通过 modal() 定制模态窗口外观和感观时可能使用到的选项。

backdrop

backdrop 选项用于包含一个 modal-backdrop 元素。

如果您把"使用 JavaScript"实例中行号 2 的代码替换为下面的代码，即给 backdrop 选项赋值为 false，此时就不存在任何的 modal-backdrop。

{ $("#example").modal({backdrop:false});

keyboard

如果使用 keyboard 选项，当点击 escape 时则关闭模态窗口。它的类型是 boolean，默认值是 true。如果把 keyboard 选项的值设置为 false，此时即使点击 escape 也不会关闭模态窗口。

如果您把"使用 JavaScript"实例中行号 2 的代码替换为下面的代码，即给 keyboard 选项赋值为 false，此时点击 escape 则不会关闭模态窗口。

{ $("#example").modal({keyboard:false});

show

如果使用 show 选项，当初始化的时候则会显示模态窗口。它的类型是 boolean，默认值是 true。如果把 show 选项的值设置为 false，在初始化时不会显示模态窗口。

如果您把"使用 JavaScript"实例中行号 2 的代码替换为下面的代码，即给 show 选项赋值为 false，在初始化时不会显示模态窗口。

{ $("#example").modal({show:false});

方法

下面是一些通过 modal() 使用到的方法。

.modal(options)

该方法把内容激活为一个 modal（模态框）。您可以引用一个可选的 object 类型的 options 参数。如果您在本教程的第一个实例中的 </body> 标签前添加下面的代码，此时就不存在任何的 modal（模态框） backdrop 元素。

$('#example').modal({
  backdrop: false
})

.modal('toggle')

该方法手动切换一个 modal（模态框）。如果您在本教程的第一个实例中的 </body> 标签前添加下面的代码，即可手动切换 modal（模态框）。

$('#example').modal('toggle')

.modal(show)

该方法可用于手动打开一个 modal（模态框）。如果您在本教程的第一个实例中的 </body> 标签前添加下面的代码，即可手动打开 modal（模态框）。

$('#example').modal('show')

.modal(hide)

该方法可用于手动隐藏一个 modal（模态框）。如果您在本教程的第一个实例中的 </body> 标签前添加下面的代码，即可手动隐藏 modal（模态框）。

$('#example').modal('hide')

事件

下面是 Modals（模态框）相关的事件。这些事件用于截获并执行自己的代码。

show

当 show 实例方法被调用之后，此事件被立即触发。

shown

当模态框显示出来之后（同时 CSS 过渡效果也已执行完毕），此事件被触发。

hide

当 hide 实例方法被调用之后，此事件被立即触发。Immediately after the hide instance method has been called, this event is called.

hidden

当模态框向用户隐藏之后（同时 CSS 过渡效果也已执行完毕），此事件被触发。

点击这里，下载本教程中使用到的所有 HTML、CSS、JS 和图片文件。

posted @ 2015-07-28 20:06 功夫熊猫阅读(2622) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

Bootstrap 模态框（Modal）插件

用法

实例

选项

方法

实例

事件

实例

Bootstrap Modals（模态框）

描述

什么是必需的

Bootstrap Modals（模态框）长什么样

在您的网站中使用 Bootstrap Modals（模态框）

解释

使用 JavaScript

选项

backdrop

keyboard

show

方法

.modal(options)

.modal('toggle')

.modal(show)

.modal(hide)

事件

show

shown

hide

hidden

公告