一个静态的模态窗口实例,如下面的实例所示:
- <!DOCTYPE html>
- <html>
- <head>
- <title>Bootstrap 实例 - 模态框(Modal)插件</title>
- <link href="/stylesheets/bootstrap.min.css" rel="stylesheet">
- <script src="/scripts/jquery.min.js"></script>
- <script src="/scripts/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 -->
- </body>
- </html>
代码讲解:
- 使用模态窗口,您需要有某种触发器。您可以使用按钮或链接。这里我们使用的是按钮。
- 如果您仔细查看上面的代码,您会发现在 < button > 标签中,data-target="#myModal" 是您想要在页面上加载的模态框的目标。
- 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-dialog 和modal-sm或_modal-lg增加一个样式调整类实现。
- <!-- Large modal -->
- <button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bs-example-modal-lg">Large modal</button>
- <div class="modal fade bs-example-modal-lg" tabindex="-1" role="dialog" aria-labelledby="myLargeModalLabel" aria-hidden="true">
- <div class="modal-dialog modal-lg">
- <div class="modal-content">
- ...
- </div>
- </div>
- </div>
- <!-- Small modal -->
- <button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bs-example-modal-sm">Small modal</button>
- <div class="modal fade bs-example-modal-sm" tabindex="-1" role="dialog" aria-labelledby="mySmallModalLabel" aria-hidden="true">
- <div class="modal-dialog modal-sm">
- <div class="modal-content">
- ...
- </div>
- </div>
- </div>
禁止动画效果
如果你不需要模态框弹出时的动画效果(淡入淡出效果),删掉 .fade 类即可。
- <div class="modal" tabindex="-1" role="dialog" aria-labelledby="" aria-hidden="true">
- ...
- </div>
用法
通过 data 属性或 JavaScript 调用模态框插件,可以根据需要动态展示隐藏的内容。
通过 data 属性
不需写 JavaScript 代码也可激活模态框。通过在一个起控制器作用的元素(例如:按钮)上添加 data-toggle="modal" 属性,或者 data-target="#foo"属性,再或者 href="#foo" 属性,用于指向被控制的模态框。
- <button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>
通过 JavaScript 调用
只需一行 JavaScript 代码,即可通过元素的 id myModal 调用模态框:
- $('#myModal').modal(options)
参数
可以将选项通过 data 属性或 JavaScript 代码传递。对于 data 属性,需要将参数名称放到 data- 之后,例如 data-backdrop=""。
参数名称 | 类型/默认值 | 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,则会加载其中的内容。如下面的实例所示:
|
方法
下面是一些可与 modal() 一起使用的有用的方法。
方法 | 描述 | 实例 |
---|---|---|
Options:.modal(options) | 把内容作为模态框激活。接受一个可选的选项对象。 |
|
Toggle:.modal('toggle') | 手动切换模态框。 |
|
Show:.modal('show') | 手动打开模态框。 |
|
Hide: .modal('hide') | 手动隐藏模态框。 |
|
事件
下表列出了模态框中要用到事件。
事件 | 描述 | 实例 |
---|---|---|
show.bs.modal | 在调用 show 方法后触发。 |
|
shown.bs.modal | 当模态框对用户可见时触发(将等待 CSS 过渡效果完成)。 |
|
hide.bs.modal | 当调用 hide 实例方法时触发。 |
|
hidden.bs.modal | 当模态框完全对用户隐藏时触发。 |
|