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