Bootstrap 模态框（Modal）插件

ゝ一纸荒年。 2022-03-21 12:28 396阅读 0赞

### Bootstrap 模态框（Modal）插件 ###

模态框（Modal）是覆盖在父窗体上的子窗体。通常，目的是显示来自一个单独的源的内容，可以在不离开父窗体的情况下有一些互动。子窗体可提供信息、交互等。

## 选项 ##

有一些选项可以用来定制模态窗口（Modal Window）的外观和感观，它们是通过 data 属性或 JavaScript 来传递的。下表列出了这些选项：

<table> 
 <tbody> 
  <tr> 
   <th>选项名称</th> 
   <th>类型/默认值</th> 
   <th>Data 属性名称</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>backdrop</td> 
   <td>boolean 或 string 'static'<br><em>默认值：true</em></td> 
   <td>data-backdrop</td> 
   <td>指定一个静态的背景，当用户点击模态框外部时不会关闭模态框。</td> 
  </tr> 
  <tr> 
   <td>keyboard</td> 
   <td>boolean<br><em>默认值：true</em></td> 
   <td>data-keyboard</td> 
   <td>当按下 escape 键时关闭模态框，设置为 false 时则按键无效。</td> 
  </tr> 
  <tr> 
   <td>show</td> 
   <td>boolean<br><em>默认值：true</em></td> 
   <td>data-show</td> 
   <td>当初始化时显示模态框。</td> 
  </tr> 
  <tr> 
   <td>remote</td> 
   <td>path<br><em>默认值：false</em></td> 
   <td>data-remote</td> 
   <td>使用 jQuery&nbsp;<em>.load</em>&nbsp;方法，为模态框的主体注入内容。如果添加了一个带有有效 URL 的 href，则会加载其中的内容。如下面的实例所示： <pre>&lt;a data-toggle="modal" href="remote.html" data-target="#modal"&gt;请点击我&lt;/a&gt;</pre> </td> 
  </tr> 
 </tbody> 
</table>

**注意****：esc起作用，一定要在div标签里面加上 tabindex="-1"属性！ **

### 方法  ###

<table> 
 <tbody> 
  <tr> 
   <th>方法</th> 
   <th>描述</th> 
   <th>实例</th> 
  </tr> 
  <tr> 
   <td><strong>Options:</strong>&nbsp;.modal(options)</td> 
   <td>把内容作为模态框激活。接受一个可选的选项对象。</td> 
   <td> <pre>$('#identifier').modal({
keyboard: false
})</pre> </td> 
  </tr> 
  <tr> 
   <td><strong>Toggle:</strong>&nbsp;.modal('toggle')</td> 
   <td>手动切换模态框。</td> 
   <td> <pre>$('#identifier').modal('toggle')</pre> </td> 
  </tr> 
  <tr> 
   <td><strong>Show:</strong>&nbsp;.modal('show')</td> 
   <td>手动打开模态框。</td> 
   <td> <pre>$('#identifier').modal('show')</pre> </td> 
  </tr> 
  <tr> 
   <td><strong>Hide:</strong>&nbsp;.modal('hide')</td> 
   <td>手动隐藏模态框。</td> 
   <td> <pre>$('#identifier').modal('hide')</pre> </td> 
  </tr> 
 </tbody> 
</table>

### 事件  ###

<table> 
 <tbody> 
  <tr> 
   <th>事件</th> 
   <th>描述</th> 
   <th>实例</th> 
  </tr> 
  <tr> 
   <td>show.bs.modal</td> 
   <td>在调用 show 方法后触发。</td> 
   <td> <pre>$('#identifier').on('show.bs.modal', function () {
  // 执行一些动作...
})</pre> </td> 
  </tr> 
  <tr> 
   <td>shown.bs.modal</td> 
   <td>当模态框对用户可见时触发（将等待 CSS 过渡效果完成）。</td> 
   <td> <pre>$('#identifier').on('shown.bs.modal', function () {
  // 执行一些动作...
})</pre> </td> 
  </tr> 
  <tr> 
   <td>hide.bs.modal</td> 
   <td>当调用 hide 实例方法时触发。</td> 
   <td> <pre>$('#identifier').on('hide.bs.modal', function () {
  // 执行一些动作...
})</pre> </td> 
  </tr> 
  <tr> 
   <td>hidden.bs.modal</td> 
   <td>当模态框完全对用户隐藏时触发。</td> 
   <td> <pre>$('#identifier').on('hidden.bs.modal', function () {
  // 执行一些动作...
})</pre> </td> 
  </tr> 
 </tbody> 
</table>

### 一、通过 data 属性： ###

在控制器元素（比如按钮或者链接）上设置属性 data-toggle="modal"，同时设置 data-target="\#identifier" 或 href="\#identifier" 来指定要切换的特定的模态框（带有 id="identifier"）。

**1、静态模态框**

<h2>创建模态框（Modal）</h2>
            
            <button class="btn btn-primary" data-toggle="modal" data-target="#myModal">演示模态框</button>
    
            
            <div class="modal fade" id="myModal" data-backdrop="static" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true">
                <div class="modal-dialog">
                    <div class="modal-content">
                        <div class="modal-header">
                            <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button>
                            <h4 class="modal-title">新增</h4>
                        </div>
                        <div class="modal-body">
                            模态框内容
                        </div>
                        <div class="modal-footer">
                            <button type="submit" class="btn btn-primary">提交</button>
                            <button type="button" class="btn btn-default" data-dismiss="modal">关闭</button>
                        </div>
                    </div>
                </div>
            </div>

### ![20190201165237833.png][] ###

**代码讲解：**

*  使用模态窗口，您需要有某种触发器。您可以使用按钮或链接。这里我们使用的是按钮。
 *  如果您仔细查看上面的代码，您会发现在 <button> 标签中，**data-target="\#myModal"** 是您想要在页面上加载的模态框的目标。您可以在页面上创建多个模态框，然后为每个模态框创建不同的触发器。现在，很明显，您不能在同一时间加载多个模块，但您可以在页面上创建多个在不同时间进行加载。
 *  在模态框中需要注意两点：
    
    1.  第一是 **.modal**，用来把 <div> 的内容识别为模态框。
    2.  第二是 **.fade** class。当模态框被切换时，它会引起内容淡入淡出。
 *  **aria-labelledby="myModalLabel"**，该属性引用模态框的标题。
 *  属性 **aria-hidden="true"** 用于保持模态窗口不可见，直到触发器被触发为止（比如点击在相关的按钮上）。
 *  <div class="modal-header">，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 用于打开模态窗口。

### 二、通过 JavaScript： ###

通过简单的一行 JavaScript 来调用模态框：

<h2>创建模态框（Modal）</h2>
            
            <button class="btn btn-primary" id="mymodalbtn">演示模态框</button>
    
            
            <div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true">
                <div class="modal-dialog">
                    <div class="modal-content">
                        <div class="modal-header">
                            <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button>
                            <h4 class="modal-title">新增</h4>
                        </div>
                        <div class="modal-body">
                            模态框内容
                        </div>
                        <div class="modal-footer">
                            <button type="submit" class="btn btn-primary">提交</button>
                            <button type="button" class="btn btn-default" data-dismiss="modal">关闭</button>
                        </div>
                    </div>
                </div>
            </div>

**   JavaScript：**

$(function () {
        $("#mymodalbtn").on("click",function () {
            //$("#myModal").modal();
            $("#myModal").modal("show");
        })
    });

使用选项属性，方法和事件：

$(function () {
        $("#mymodalbtn").on("click",function () {
            $("#myModal").modal({
                backdrop: "static",
                keyboard: false
            });
            $("#myModal").modal("show");
            $('#myModal').on('hide.bs.modal', function () {
                alert("myModal隐藏完成！");
            })
        })
    });

## ##

[20190201165237833.png]: /images/20220321/72d7243b0ed140feb9aba5a6b35daa28.png