Bootstrap 教程
模態(tài)框(Modal)是覆蓋在父窗體上的子窗體。通常,目的是顯示來自一個單獨的源的內(nèi)容,可以在不離開父窗體的情況下有一些互動。子窗體可提供信息、交互等。
如果您想要單獨引用該插件的功能,那么您需要引用 modal.js?;蛘?,正如 Bootstrap 插件概覽 一章中所提到,您可以引用 bootstrap.js 或壓縮版的 bootstrap.min.js。
您可以切換模態(tài)框(Modal)插件的隱藏內(nèi)容:
$('#identifier').modal(options)
一個靜態(tài)的模態(tài)窗口實例,如下面的實例所示:
結(jié)果如下所示:
代碼講解:
有一些選項可以用來定制模態(tài)窗口(Modal Window)的外觀和感觀,它們是通過 data 屬性或 JavaScript 來傳遞的。下表列出了這些選項:
選項名稱 | 類型/默認(rèn)值 | Data 屬性名稱 | 描述 |
---|---|---|---|
backdrop | boolean 或 string 'static' 默認(rèn)值:true | data-backdrop | 指定一個靜態(tài)的背景,當(dāng)用戶點擊模態(tài)框外部時不會關(guān)閉模態(tài)框。 |
keyboard | boolean 默認(rèn)值:true | data-keyboard | 當(dāng)按下 escape 鍵時關(guān)閉模態(tài)框,設(shè)置為 false 時則按鍵無效。 |
show | boolean 默認(rèn)值:true | data-show | 當(dāng)初始化時顯示模態(tài)框。 |
remote | path 默認(rèn)值:false | data-remote | 使用 jQuery .load 方法,為模態(tài)框的主體注入內(nèi)容。如果添加了一個帶有有效 URL 的 href,則會加載其中的內(nèi)容。如下面的實例所示:
<a data-toggle="modal" href="remote.html" data-target="#modal" rel="noopener noreferrer">請點擊我</a> |
下面是一些可與 modal() 一起使用的有用的方法。
方法 | 描述 | 實例 |
---|---|---|
Options: .modal(options) | 把內(nèi)容作為模態(tài)框激活。接受一個可選的選項對象。 |
$('#identifier').modal({ keyboard: false }) |
Toggle: .modal('toggle') | 手動切換模態(tài)框。 |
$('#identifier').modal('toggle') |
Show: .modal('show') | 手動打開模態(tài)框。 |
$('#identifier').modal('show') |
Hide: .modal('hide') | 手動隱藏模態(tài)框。 |
$('#identifier').modal('hide') |
下面的實例演示了方法的用法:
結(jié)果如下所示:
只需要點擊 ESC 鍵,模態(tài)窗口即會退出。
下表列出了模態(tài)框中要用到事件。這些事件可在函數(shù)中當(dāng)鉤子使用。
事件 | 描述 | 實例 |
---|---|---|
show.bs.modal | 在調(diào)用 show 方法后觸發(fā)。 |
$('#identifier').on('show.bs.modal', function () { // 執(zhí)行一些動作... }) |
shown.bs.modal | 當(dāng)模態(tài)框?qū)τ脩艨梢姇r觸發(fā)(將等待 CSS 過渡效果完成)。 |
$('#identifier').on('shown.bs.modal', function () { // 執(zhí)行一些動作... }) |
hide.bs.modal | 當(dāng)調(diào)用 hide 實例方法時觸發(fā)。 |
$('#identifier').on('hide.bs.modal', function () { // 執(zhí)行一些動作... }) |
hidden.bs.modal | 當(dāng)模態(tài)框完全對用戶隱藏時觸發(fā)。 |
$('#identifier').on('hidden.bs.modal', function () { // 執(zhí)行一些動作... }) |
下面的實例演示了事件的用法:
結(jié)果如下所示:
正如上面實例所示,如果您點擊了 關(guān)閉 按鈕,即 hide 事件,則會顯示一個警告消息。