bootstrap中的模態框（modal），不同於Tooltips，模態框以彈出對話框的形式出現，具有最小和最實用的功能集。
務必將模態框的 HTML 代碼放在文檔的最高層級內（也就是說，盡量作為 body 標簽的直接子元素），以避免其他組件影響模態框的展現或功能。
默認的modal示例：
- <!DOCTYPE html>
- <html lang="zh-CN">
- <head>
- <meta charset="utf-8">
- <meta http-equiv="X-UA-Compatible" content="IE=edge">
- <meta name="viewport" content="width=device-width, initial-scale=1">
- <title>Bootstrap Modal</title>
- <link rel="stylesheet" href="http://cdn.bootcss.com/bootstrap/3.3.5/css/bootstrap.min.css">
- </head>
- <body>
- <button type="button" class="btn btn-primary btn-lg" data-toggle="modal" data-target="#myModal">
- Launch demo modal
- </button>
- <div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel">
- <div class="modal-dialog" role="document">
- <div class="modal-content">
- <div class="modal-header">
- <button type="button" class="close" data-dismiss="modal" aria-label="Close">
- <span aria-hidden="true">×</span>
- </button>
- <h4 class="modal-title" id="myModalLabel">Modal title</h4>
- </div>
- <div class="modal-body">
- <p>One fine body…</p>
- </div>
- <div class="modal-footer">
- <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
- <button type="button" class="btn btn-primary">Save</button>
- </div>
- </div>
- </div>
- </div>
- <script src="http://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
- <script src="http://cdn.bootcss.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
- </body>
- </html>
- 為 .modal 添加 role="dialog"，用於指定模態框為對話框。
- 為 .modal-dialog 添加 aria-hidden="true" 屬性。
- 通過 aria-describedby 屬性為模態框 .modal 添加描述性信息。
關閉動畫
如果你不需要模態框彈出時的動畫效果（淡入淡出效果），刪掉 .fade 類即可。
通過按鈕屬性顯示不同內容
當有一堆按鈕，都要觸發相同的模態框(如：向好友列表中某個人發消息)，只是有用戶ID不同，那么可以使用data-whatever配合event.relatedtarget來實現：
- <!DOCTYPE html>
- <html lang="zh-CN">
- <head>
- <meta charset="utf-8">
- <meta http-equiv="X-UA-Compatible" content="IE=edge">
- <meta name="viewport" content="width=device-width, initial-scale=1">
- <title>Bootstrap Modal</title>
- <link rel="stylesheet" href="http://cdn.bootcss.com/bootstrap/3.3.5/css/bootstrap.min.css">
- </head>
- <body>
- <div class="panel panel-default">
- <div class="panel-heading">好友列表</div>
- <div class="panel-body">
- <div class="list-group" role="group" aria-label="好友列表">
- <button type="button" class="list-group-item" data-toggle="modal" data-target="#exampleModal"
- data-whatever="張三">張三
- </button>
- <button type="button" class="list-group-item" data-toggle="modal" data-target="#exampleModal"
- data-whatever="李四">李四
- </button>
- <button type="button" class="list-group-item" data-toggle="modal" data-target="#exampleModal"
- data-whatever="王二">王二
- </button>
- </div>
- </div>
- </div>
- <div class="modal fade" id="exampleModal" tabindex="-1" role="dialog" aria-labelledby="exampleModalLabel">
- <div class="modal-dialog" role="document">
- <div class="modal-content">
- <div class="modal-header">
- <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span
- aria-hidden="true">×</span></button>
- <h4 class="modal-title" id="exampleModalLabel">New message</h4>
- </div>
- <div class="modal-body">
- <form>
- <div class="form-group">
- <label for="recipient-name" class="control-label">Recipient:</label>
- <input type="text" class="form-control" id="recipient-name">
- </div>
- <div class="form-group">
- <label for="message-text" class="control-label">Message:</label>
- <textarea class="form-control" id="message-text"></textarea>
- </div>
- </form>
- </div>
- <div class="modal-footer">
- <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
- <button type="button" class="btn btn-primary">Send message</button>
- </div>
- </div>
- </div>
- </div>
- <script src="http://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
- <script src="http://cdn.bootcss.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
- <script>
- $('#exampleModal').on('show.bs.modal', function (event) {
- var button = $(event.relatedTarget) // 觸發事件的按鈕
- var recipient = button.data('whatever') // 解析出data-whatever內容
- var modal = $(this)
- modal.find('.modal-title').text('Message To ' + recipient)
- modal.find('.modal-body input').val(recipient)
- })
- </script>
- </body>
- </html>
通常不需寫 JavaScript 代碼也可激活模態框。通過在一個起控制器作用的元素（例如：按鈕）上添加 data-toggle="modal" 屬性，或者 data-target="#foo" 屬性，再或者 href="#foo" 屬性，用於指向被控制的模態框。
通過JavaScript調用modal
通常只需一行 javascript 代碼，即可通過元素的 id myModal 調用模態框：
- $('#myModal').modal(options)
JavaScript參數：
可以將選項通過 data 屬性或 JavaScript 代碼傳遞。對於 data 屬性，需要將參數名稱放到 data- 之后，例如 data-backdrop=""。
| 名稱 | 類型 | 默認值 | 描述 |
|---|---|---|---|
| backdrop | boolean或'static' | true | 默認情況下，點擊其它位置，模態框自動關閉，你可以設置此屬性為false或者"static"防止模態框自動關閉 |
| keyboard | boolean | true | 鍵盤上的 esc 鍵被按下時關閉模態框。 |
| show | path | true | 模態框初始化之后就立即顯示出來。 |
| remote | path | false | 這個參數在v4里會去掉（可以自己寫ajax請求來實現）如果提供的是 URL，將利用 jQuery 的 load 方法從此 URL 地址加載要展示的內容（只加載一次）並插入 .modal-content 內。如果使用的是 data 屬性 API，還可以利用 href 屬性指定內容來源地址。下面是一個實例： <a data-toggle="modal" href="remote.html" data-target="#modal">Click me</a> |
調用示例
1.將頁面中的某塊內容作為模態框激活。接受可選參數 object。
- $('#myModal').modal({
- keyboard: false
- })
2.手動打開或關閉模態框。在模態框顯示或隱藏之前返回到主調函數中（也就是，在觸發 shown.bs.modal 或 hidden.bs.modal 事件之前）。
- $('#myModal').modal('toggle')
3.手動打開模態框。在模態框顯示之前返回到主調函數中 （也就是，在觸發 shown.bs.modal 事件之前）。
- $('#myModal').modal('show')
4.手動隱藏模態框。在模態框隱藏之前返回到主調函數中 （也就是，在觸發 hidden.bs.modal 事件之前）。
- $('#myModal').modal('hide')
5.更新模態框，在模態框動態添加或刪除內容時：
- $('#myModal').modal('handleUpdate')
綁定事件
Bootstrap 的模態框類提供了一些事件用於監聽並執行你自己的代碼。
| 事件類型 | 描述 |
|---|---|
| show.bs.modal | show 方法調用之后立即觸發該事件。如果是通過點擊某個作為觸發器的元素，則此元素可以通過事件的 relatedTarget 屬性進行訪問。 |
| shown.bs.modal | 此事件在模態框已經顯示出來（並且同時在 CSS 過渡效果完成）之后被觸發。如果是通過點擊某個作為觸發器的元素，則此元素可以通過事件的 relatedTarget 屬性進行訪問。 |
| hide.bs.modal | hide 方法調用之后立即觸發該事件。 |
| hidden.bs.modal | 此事件在模態框被隱藏（並且同時在 CSS 過渡效果完成）之后被觸發。 |
| loaded.bs.modal | 從遠端的數據源加載完數據之后觸發該事件。 |
如：
- $('#myModal').on('hidden.bs.modal', function (e) {
- // do something...
- })