DIV CSS 佈局教程網

Bootstrap 模態框(Modal)插件:結構、參數、方法與事件一次講透
編輯:關於JavaScript     

模態框是互動式網站裡最常見的彈窗元件,登入提示、表單確認、二次刪除確認幾乎都靠它。這一節把 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 之上,因此每個插件都可以從這四個角度去理解。

1. 用法

最簡單的方式是 data 屬性:data-toggle="modal" 決定觸發類型,data-target="#myModal" 決定要控制哪個節點。

<button data-toggle="modal" data-target="#myModal">...</button>

如果觸發元素是 <a>,也可以用 href="#myModal" 取代 data-target,不過官方建議統一用 data-target,語意比較清楚。

2. 參數

可以透過 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'
});

3. 方法

如果預設不顯示,就得靠方法把彈窗叫出來:

$('#btn').on('click', function () {
  $('#myModal').modal('show');
});

4. 事件

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 插件使用教程。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved