bootstrap中的模态框（modal，弹出层）

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

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

默认的modal示例：

    
    
    
    
    



    Launch demo modal



    

        

            

                
                    ×
                
                
Modal title
            
            

                
One fine body…
            
            

                Close
                Save
            
        
    

1. 为 .modal 添加 role="dialog"，用于指定模态框为对话框。
2. 为 .modal-dialog 添加 aria-hidden="true" 属性。
3. 通过 aria-describedby 属性为模态框 .modal 添加描述性信息。

关闭动画

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

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

    
    
    
    
    





    
好友列表
    

        

            张三
            
            李四
            
            王二
            
        
    



    

        

            

                ×
                
New message
            
            

                

                    

                        Recipient:
                        
                    
                    

                        Message:
                        
                    
                
            
            

                Close
                Send message
            
        
    

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

通过JavaScript调用modal

通常只需一行 JavaScript 代码，即可通过元素的 id myModal 调用模态框：

$('#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 属性指定内容来源地址。下面是一个实例： Click me

    

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

$('#myModal').modal({
  keyboard: false
})

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

$('#myModal').modal('toggle')

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

$('#myModal').modal('show')

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

$('#myModal').modal('hide')

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

$('#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	从远端的数据源加载完数据之后触发该事件。

如：

$('#myModal').on('hidden.bs.modal', function (e) {
  // do something...
})