模態框是互動式網站裡最常見的彈窗元件,登入提示、表單確認、二次刪除確認幾乎都靠它。這一節把 Bootstrap Modal 的結構層級、data 屬性用法、可配置參數、方法與事件完整梳理一遍。
一個標準模態框由三層 div 由外而內包住:modal(模態宣告層)、modal-dialog(視窗宣告層)、modal-content(內容層)。內容層內部再切三塊:modal-header(頭部)、modal-body(主體)、modal-footer(注腳)。
<!-- 模態宣告層,show 表示直接顯示 -->
<div class="modal show" tabindex="-1">
<div class="modal-dialog">
<div class="modal-content">
<!-- 頭部 -->
<div class="modal-header">
<button type="button" class="close" data-dismiss="modal"><span>×</span></button>
<h4 class="modal-title">會員登入</h4>
</div>
<!-- 主體 -->
<div class="modal-body">
<p>目前無法登入會員</p>
</div>
<!-- 注腳 -->
<div class="modal-footer">
<button type="button" class="btn btn-default">註冊</button>
<button type="button" class="btn btn-primary">登入</button>
</div>
</div>
</div>
</div>
實務上比較少讓模態框一載入就顯示,通常會拿掉 show、補一個 id,再用按鈕觸發:
<!-- 拿掉 show,加上 id --> <div class="modal" id="myModal"> ... </div> <!-- 觸發顯示 --> <button class="btn btn-primary btn-lg" data-toggle="modal" data-target="#myModal">點擊彈窗</button> <!-- 視窗尺寸:預設、大、小 --> <div class="modal-dialog modal-lg"> <div class="modal-dialog modal-sm"> <!-- 加上淡入淡出 --> <div class="modal fade" id="myModal">
主體區塊裡也可以直接放進格線系統的流動容器,讓彈窗內容跟頁面一樣採用欄位排版:
<div class="modal-body">
<div class="container-fluid">
<div class="row">
<div class="col-md-4">1</div>
<div class="col-md-4">2</div>
<div class="col-md-4">3</div>
</div>
</div>
</div>
Bootstrap 的插件都建立在 JavaScript/jQuery 之上,因此每個插件都可以從這四個角度去理解。
最簡單的方式是 data 屬性:data-toggle="modal" 決定觸發類型,data-target="#myModal" 決定要控制哪個節點。
<button data-toggle="modal" data-target="#myModal">...</button>
如果觸發元素是 <a>,也可以用 href="#myModal" 取代 data-target,不過官方建議統一用 data-target,語意比較清楚。
可以透過 HTML 上的 data-* 屬性宣告:

data-backdrop="false" // 不要遮罩背景 data-keyboard="false" // 按 ESC 不關閉 data-show="false" // 初始化時不顯示(注意:首次點擊不會彈出,第二次才會) href="index.html" // 載入一次遠端內容到容器內
同樣的選項也能在 JavaScript 中傳入:

$('#myModal').modal({
show: true,
backdrop: false,
keyboard: false,
remote: 'index.html'
});
如果預設不顯示,就得靠方法把彈窗叫出來:

$('#btn').on('click', function () {
$('#myModal').modal('show');
});
Modal 同樣提供四個階段的事件,命名規則為「動詞 + .bs.modal」:

$('#myModal').on('show.bs.modal', function () {
alert('呼叫 show 的當下觸發');
});
$('#myModal').on('shown.bs.modal', function () {
alert('模態框完全顯示後觸發');
});
$('#myModal').on('hide.bs.modal', function () {
alert('呼叫 hide 的當下觸發');
});
$('#myModal').on('hidden.bs.modal', function () {
alert('模態框完全關閉後觸發');
});
$('#myModal').on('loaded.bs.modal', function () {
alert('遠端資料載入完成後觸發');
});
把「show/shown」這對事件用對,就能在彈窗前做資料準備、在彈出後設定焦點,這是寫互動表單時最實用的兩個掛勾點。想繼續深入可以參考 Bootstrap 學習教程、Bootstrap 實戰教程與 Bootstrap 插件使用教程。