bootstrap中的模态框(modal,弹出层)

bootstrap中的模态框(modal),不同于Tooltips,模态框以弹出对话框的形式出现,具有最小和最实用的功能集。

务必将模态框的 HTML 代码放在文档的最高层级内(也就是说,尽量作为 body 标签的直接子元素),以避免其他组件影响模态框的展现或功能。

默认的modal示例:

[html] view plain copy
 
  1. <!DOCTYPE html>  
  2. <html lang="zh-CN">  
  3. <head>  
  4.     <meta charset="utf-8">  
  5.     <meta http-equiv="X-UA-Compatible" content="IE=edge">  
  6.     <meta name="viewport" content="width=device-width, initial-scale=1">  
  7.     <title>Bootstrap Modal</title>  
  8.     <link rel="stylesheet" href="http://cdn.bootcss.com/bootstrap/3.3.5/css/bootstrap.min.css">  
  9. </head>  
  10. <body>  
  11. <button type="button" class="btn btn-primary btn-lg" data-toggle="modal" data-target="#myModal">  
  12.     Launch demo modal  
  13. </button>  
  14.   
  15. <div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel">  
  16.     <div class="modal-dialog" role="document">  
  17.         <div class="modal-content">  
  18.             <div class="modal-header">  
  19.                 <button type="button" class="close" data-dismiss="modal" aria-label="Close">  
  20.                     <span aria-hidden="true"</span>  
  21.                 </button>  
  22.                 <h4 class="modal-title" id="myModalLabel">Modal title</h4>  
  23.             </div>  
  24.             <div class="modal-body">  
  25.                 <p>One fine body…</p>  
  26.             </div>  
  27.             <div class="modal-footer">  
  28.                 <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>  
  29.                 <button type="button" class="btn btn-primary">Save</button>  
  30.             </div>  
  31.         </div>  
  32.     </div>  
  33. </div>  
  34.   
  35. <script src="http://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>  
  36. <script src="http://cdn.bootcss.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>  
  37. </body>  
  38. </html>  
  1. 为 .modal 添加 role="dialog",用于指定模态框为对话框。
  2. 为 .modal-dialog 添加 aria-hidden="true" 属性。
  3. 通过 aria-describedby 属性为模态框 .modal 添加描述性信息。

关闭动画

如果你不需要模态框弹出时的动画效果(淡入淡出效果),删掉 .fade 类即可。


通过按钮属性显示不同内容
当有一堆按钮,都要触发相同的模态框(如:向好友列表中某个人发消息),只是有用户ID不同,那么可以使用data-whatever配合event.relatedtarget来实现:

[html] view plain copy
 
  1. <!DOCTYPE html>  
  2. <html lang="zh-CN">  
  3. <head>  
  4.     <meta charset="utf-8">  
  5.     <meta http-equiv="X-UA-Compatible" content="IE=edge">  
  6.     <meta name="viewport" content="width=device-width, initial-scale=1">  
  7.     <title>Bootstrap Modal</title>  
  8.     <link rel="stylesheet" href="http://cdn.bootcss.com/bootstrap/3.3.5/css/bootstrap.min.css">  
  9. </head>  
  10. <body>  
  11.   
  12.   
  13. <div class="panel panel-default">  
  14.     <div class="panel-heading">好友列表</div>  
  15.     <div class="panel-body">  
  16.         <div class="list-group" role="group" aria-label="好友列表">  
  17.             <button type="button" class="list-group-item" data-toggle="modal" data-target="#exampleModal"  
  18.                     data-whatever="张三">张三  
  19.             </button>  
  20.             <button type="button" class="list-group-item" data-toggle="modal" data-target="#exampleModal"  
  21.                     data-whatever="李四">李四  
  22.             </button>  
  23.             <button type="button" class="list-group-item" data-toggle="modal" data-target="#exampleModal"  
  24.                     data-whatever="王二">王二  
  25.             </button>  
  26.         </div>  
  27.     </div>  
  28. </div>  
  29.   
  30. <div class="modal fade" id="exampleModal" tabindex="-1" role="dialog" aria-labelledby="exampleModalLabel">  
  31.     <div class="modal-dialog" role="document">  
  32.         <div class="modal-content">  
  33.             <div class="modal-header">  
  34.                 <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span  
  35.                         aria-hidden="true"</span></button>  
  36.                 <h4 class="modal-title" id="exampleModalLabel">New message</h4>  
  37.             </div>  
  38.             <div class="modal-body">  
  39.                 <form>  
  40.                     <div class="form-group">  
  41.                         <label for="recipient-name" class="control-label">Recipient:</label>  
  42.                         <input type="text" class="form-control" id="recipient-name">  
  43.                     </div>  
  44.                     <div class="form-group">  
  45.                         <label for="message-text" class="control-label">Message:</label>  
  46.                         <textarea class="form-control" id="message-text"></textarea>  
  47.                     </div>  
  48.                 </form>  
  49.             </div>  
  50.             <div class="modal-footer">  
  51.                 <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>  
  52.                 <button type="button" class="btn btn-primary">Send message</button>  
  53.             </div>  
  54.         </div>  
  55.     </div>  
  56. </div>  
  57. <script src="http://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>  
  58. <script src="http://cdn.bootcss.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>  
  59. <script>  
  60.     $('#exampleModal').on('show.bs.modal', function (event) {  
  61.         var button = $(event.relatedTarget) // 触发事件的按钮  
  62.         var recipient = button.data('whatever') // 解析出data-whatever内容  
  63.         var modal = $(this)  
  64.         modal.find('.modal-title').text('Message To ' + recipient)  
  65.         modal.find('.modal-body input').val(recipient)  
  66.     })  
  67. </script>  
  68. </body>  
  69. </html>  

 

通常不需写 JavaScript 代码也可激活模态框。通过在一个起控制器作用的元素(例如:按钮)上添加 data-toggle="modal" 属性,或者 data-target="#foo" 属性,再或者 href="#foo" 属性,用于指向被控制的模态框。

通过JavaScript调用modal

通常只需一行 javascript 代码,即可通过元素的 id myModal 调用模态框:

 

[html] view plain copy
 
  1. $('#myModal').modal(options)  

 

JavaScript参数

可以将选项通过 data 属性或 JavaScript 代码传递。对于 data 属性,需要将参数名称放到 data- 之后,例如 data-backdrop=""。

 

名称类型默认值描述
backdrop boolean或'static' true 默认情况下,点击其它位置,模态框自动关闭,你可以设置此属性为false或者"static"防止模态框自动关闭
keyboard boolean true 键盘上的 esc 键被按下时关闭模态框。
show path true 模态框初始化之后就立即显示出来。
remote path false 这个参数在v4里会去掉(可以自己写ajax请求来实现)如果提供的是 URL,将利用 jQuery 的 load 方法从此 URL 地址加载要展示的内容(只加载一次)并插入 .modal-content 内。如果使用的是 data 属性 API,还可以利用 href 属性指定内容来源地址。下面是一个实例:
<a data-toggle="modal" href="remote.html" data-target="#modal">Click me</a>

 

    

调用示例
1.将页面中的某块内容作为模态框激活。接受可选参数 object。

[html] view plain copy
 
  1. $('#myModal').modal({  
  2.   keyboard: false  
  3. })  


2.手动打开或关闭模态框。在模态框显示或隐藏之前返回到主调函数中(也就是,在触发 shown.bs.modal 或 hidden.bs.modal 事件之前)。

[html] view plain copy
 
  1. $('#myModal').modal('toggle')  


3.手动打开模态框。在模态框显示之前返回到主调函数中 (也就是,在触发 shown.bs.modal 事件之前)。

[html] view plain copy
 
  1. $('#myModal').modal('show')  


4.手动隐藏模态框。在模态框隐藏之前返回到主调函数中 (也就是,在触发 hidden.bs.modal 事件之前)。

[html] view plain copy
 
  1. $('#myModal').modal('hide')  


5.更新模态框,在模态框动态添加或删除内容时:

[html] view plain copy
 
  1. $('#myModal').modal('handleUpdate')  


绑定事件
Bootstrap 的模态框类提供了一些事件用于监听并执行你自己的代码。

事件类型描述
show.bs.modal show 方法调用之后立即触发该事件。如果是通过点击某个作为触发器的元素,则此元素可以通过事件的 relatedTarget 属性进行访问。
shown.bs.modal 此事件在模态框已经显示出来(并且同时在 CSS 过渡效果完成)之后被触发。如果是通过点击某个作为触发器的元素,则此元素可以通过事件的 relatedTarget 属性进行访问。
hide.bs.modal hide 方法调用之后立即触发该事件。
hidden.bs.modal 此事件在模态框被隐藏(并且同时在 CSS 过渡效果完成)之后被触发。
loaded.bs.modal 从远端的数据源加载完数据之后触发该事件。

如:

[html] view plain copy
 
    1. $('#myModal').on('hidden.bs.modal', function (e) {  
    2.   // do something...  
    3. })  
posted @ 2017-06-30 18:03  疯子110  阅读(9075)  评论(0编辑  收藏  举报