Bootstrap 模態對話框詳解與只加載一次 remote 數據的解決辦法
Pony Html, 技術分享 圍觀1228次
Bootstrap真的好用!地球人都知道,今天學習一下在項目中使用模態框遇到的問題!
首先模態框(Modal)是覆蓋在父窗體上的子窗體。通常,目的是顯示來自一個單獨的源的內容,可以在不離開父窗體的情況下有一些互動。子窗體可提供信息、交互等。如果您想要單獨引用該插件的功能,那么您需要引用 modal.js。或者,正如 Bootstrap 插件概覽 一章中所提到,您可以引用 bootstrap.js 或壓縮版的 bootstrap.min.js。
用法
您可以切換模態框(Modal)插件的隱藏內容:
實例
一個靜態的模態窗口實例,如下面的實例所示:
4 |
< title >Bootstrap 實例 - 模態框(Modal)插件</ title > |
5 |
< link href = "/bootstrap/css/bootstrap.min.css" rel = "stylesheet" > |
6 |
< script src = "/scripts/jquery.min.js" ></ script > |
7 |
< script src = "/bootstrap/js/bootstrap.min.js" ></ script > |
13 |
< button class = "btn btn-primary btn-lg" data-toggle = "modal" |
14 |
data-target = "#myModal" > |
19 |
< div class = "modal fade" id = "myModal" tabindex = "-1" role = "dialog" |
20 |
aria-labelledby = "myModalLabel" aria-hidden = "true" > |
21 |
< div class = "modal-dialog" > |
22 |
< div class = "modal-content" > |
23 |
< div class = "modal-header" > |
24 |
< button type = "button" class = "close" |
25 |
data-dismiss = "modal" aria-hidden = "true" > |
28 |
< h4 class = "modal-title" id = "myModalLabel" > |
32 |
< div class = "modal-body" > |
35 |
< div class = "modal-footer" > |
36 |
< button type = "button" class = "btn btn-default" |
37 |
data-dismiss = "modal" >關閉 |
39 |
< button type = "button" class = "btn btn-primary" > |
結果如下所示:
代碼講解:
- 使用模態窗口,您需要有某種觸發器。您可以使用按鈕或鏈接。這里我們使用的是按鈕。
- 如果您仔細查看上面的代碼,您會發現在 <button> 標簽中,data-target=”#myModal” 是您想要在頁面上加載的模態框的目標。您可以在頁面上創建多個模態框,然后為每個模態框創建不同的觸發器。現在,很明顯,您不能在同一時間加載多個模塊,但您可以在頁面上創建多個在不同時間進行加載。
- 在模態框中需要注意兩點:
- 第一是 .modal,用來把 <div> 的內容識別為模態框。
- 第二是 .fade class。當模態框被切換時,它會引起內容淡入淡出。
- aria-labelledby=”myModalLabel”,該屬性引用模態框的標題。
- 屬性 aria-hidden=”true” 用於保持模態窗口不可見,直到觸發器被觸發為止(比如點擊在相關的按鈕上)。
- <div>,modal-header 是為模態窗口的頭部定義樣式的類。
- class=”close”,close 是一個 CSS class,用於為模態窗口的關閉按鈕設置樣式。
- data-dismiss=”modal”,是一個自定義的 HTML5 data 屬性。在這里它被用於關閉模態窗口。
- class=”modal-body”,是 Bootstrap CSS 的一個 CSS class,用於為模態窗口的主體設置樣式。
- class=”modal-footer”,是 Bootstrap CSS 的一個 CSS class,用於為模態窗口的底部設置樣式。
- data-toggle=”modal”,HTML5 自定義的 data 屬性 data-toggle 用於打開模態窗口。
選項
有一些選項可以用來定制模態窗口(Modal Window)的外觀和感觀,它們是通過 data 屬性或 JavaScript 來傳遞的。下表列出了這些選項:
選項名稱 |
類型/默認值 |
Data 屬性名稱 |
描述 |
backdrop |
boolean 或 string ‘static’ 默認值:true |
data-backdrop |
指定一個靜態的背景,當用戶點擊模態框外部時不會關閉模態框。 |
keyboard |
boolean 默認值:true |
data-keyboard |
當按下 escape 鍵時關閉模態框,設置為 false 時則按鍵無效。 |
show |
boolean 默認值:true |
data-show |
當初始化時顯示模態框。 |
remote |
path 默認值:false |
data-remote |
使用 jQuery .load 方法,為模態框的主體注入內容。 如果添加了一個帶有有效 URL 的 href, 則會加載其中的內容。如下面的實例所示: <a data-toggle="modal" href="remote.html" data-target="#modal">請點擊我</a> |
方法
下面是一些可與 modal() 一起使用的有用的方法。
方法 |
描述 |
實例 |
Options: .modal(options) |
把內容作為模態框激活。接受一個可選的選項對象。 |
$('#identifier').modal({keyboard: false}) |
Toggle: .modal(‘toggle’) |
手動切換模態框。 |
$('#identifier').modal('toggle') |
Show: .modal(‘show’) |
手動打開模態框。 |
$('#identifier').modal('show') |
Hide: .modal(‘hide’) |
手動隱藏模態框。 |
$('#identifier').modal('hide') |
事件
下表列出了模態框中要用到事件。這些事件可在函數中當鈎子使用。
事件 |
描述 |
實例 |
show.bs.modal |
在調用 show 方法后觸發。 |
$('#identifier').on('show.bs.modal', function () {
// 執行一些動作...
}) |
shown.bs.modal |
當模態框對用戶可見時觸發(將等待 CSS 過渡效果完成)。 |
$('#identifier').on('shown.bs.modal', function () {
// 執行一些動作...
}) |
hide.bs.modal |
當調用 hide 實例方法時觸發。 |
$('#identifier').on('hide.bs.modal', function () {
// 執行一些動作...
}) |
hidden.bs.modal |
當模態框完全對用戶隱藏時觸發。 |
$('#identifier').on('hidden.bs.modal', function () {
// 執行一些動作...
}) |
關於Bootstrap 模態對話框只加載一次 remote 數據的解決辦法
可以使用 remote 選項指定一個 URL,這樣對話框在第一次彈出的時候就會自動從這個地址加載數據到 .modal-body 中,但是它只會加載一次,不過通過在事件中調用 removeData() 方法可以解決這個問題。
使用 remote 選項讓模態對話框加載頁面到 .modal-body 中
有兩種方法,一種是使用鏈接,另一種就是使用腳本。
2.1 使用鏈接
1 |
< a href = "page.jsp" data-toggle = "modal" data-target = "#myModal" >打開對話框</ a > |
當點擊此鏈接時,page.jsp 的內容會被加載到對話框的 .modal-body 中,隨即顯示對話框。
2.2 使用JS
這段腳本的效果和使用鏈接是一樣的,當這段腳本執行后,page.jsp 的內容會被加載到對話框的 .modal-body 中,隨即顯示對話框。
這兩種方法的背后,都是 Bootstrap 調用了 jQuery 的 load() 方法,從服務器端加載了 page.jsp 頁面。但這個加載只會發生一次,后面不管你點擊幾次鏈接,或者執行幾次腳本,哪怕改變傳遞給 remote 選項的值,對話框都不會重新加載頁面,這真是個讓人頭疼的事情。不過問題還是能夠解決的。
在搜索並查閱了相關文檔后,發現在對話框的 hidden 事件里寫上一條語句就可以了:
1 |
$( "#myModal" ).on( "hidden" , function () { |
2 |
$( this ).removeData( "modal" ); |
也可以在每次打開對話框之前移除數據,效果是一樣的。
注:上面的代碼基於 Bootstrap v2,如果使用 Bootstrape v3,模態對話框的 HTML 和事件的寫法有一些不同,例如對於上面的 hidden 事件,要寫成:
1 |
$( "#myModal" ).on( "hidden.bs.modal" , function () { |
2 |
$( this ).removeData( "bs.modal" ); |