使用前需要加载element
模块,可通过下列方式加载
实例
静态实例
以下模态框包含了模态框的头、体和一组放置于底部的按钮,点击下面的按钮即可启动一个模态框。
增强模态框的可访问性
务必为 .modal
添加 role="dialog"
和 aria-labelledby="..."
属性,用于指向模态框的标题栏;为 .modal-dialog
添加 aria-hidden="true"
属性。
另外,你还应该通过 aria-describedby
属性为模态框 .modal
添加描述性信息。
可选尺寸
模态框提供了两个可选尺寸,通过为 .modal-dialog
增加一个样式调整类实现。
禁止动画效果
如果你不需要模态框弹出时的动画效果(淡入淡出效果),删掉 .fade
类即可。
使用栅格布局
带表单的内容
用法
通过 data 属性或 JavaScript 调用模态框插件,可以根据需要动态展示隐藏的内容。模态框弹出时还会为 <body>
元素添加 .modal-open
类,从而覆盖页面默认的滚动行为,并且还会自动生成一个 .modal-backdrop
元素用于提供一个可点击的区域,点击此区域就即可关闭模态框。
通过 data 属性
不需写 JavaScript 代码也可激活模态框。通过在一个起控制器作用的元素(例如:按钮)上添加 data-toggle="modal"
属性,或者 data-target="#foo"
属性,再或者 href="#foo"
属性,用于指向被控制的模态框。
通过 JavaScript 调用
只需一行 JavaScript 代码,即可通过元素的 id myModal
调用模态框:
参数
可以将选项通过 data 属性或 JavaScript 代码传递。对于 data 属性,需要将参数名称放到 data-
之后,例如 data-backdrop=""
。
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
backdrop | boolean 或 字符串 'static' |
true | 当用户点击模态框外部时不会关闭模态框。 |
keyboard | boolean | true | 当按下 esc键时关闭模态框,设置为 false 时则按键无效 |
show | boolean | true | 当初始化时显示模态框。 |
remote | path | false |
使用 jQuery .load 方法,为模态框的主体注入内容。如果添加了一个带有有效 URL 的 href,则会加载其中的内容。如下面的实例所示: <a data-toggle="modal" href="remote.html" data-target="#modal">请点击我</a> |
方法
.modal(options)
将页面中的某块内容作为模态框激活。接受可选参数 object
。
.modal('toggle')
手动打开或关闭模态框。在模态框显示或隐藏之前返回到主调函数中(也就是,在触发 shown.bs.modal
或 hidden.bs.modal
事件之前)。
.modal('show')
手动打开模态框。在模态框显示之前返回到主调函数中 (也就是,在触发 shown.bs.modal
事件之前)。
.modal('hide')
手动隐藏模态框。在模态框隐藏之前返回到主调函数中 (也就是,在触发 hidden.bs.modal
事件之前)。
事件
模态框类提供了一些事件用于监听并执行你自己的代码。
事件类型 | 描述 |
---|---|
show.bs.modal | show 方法调用之后立即触发该事件。如果是通过点击某个作为触发器的元素,则此元素可以通过事件的 relatedTarget 属性进行访问。 |
shown.bs.modal | 此事件在模态框已经显示出来(并且同时在 CSS 过渡效果完成)之后被触发。如果是通过点击某个作为触发器的元素,则此元素可以通过事件的 relatedTarget 属性进行访问。 |
hide.bs.modal | hide 方法调用之后立即触发该事件。 |
hidden.bs.modal | 当模态框完全对用户隐藏时触发。+ |
loaded.bs.modal | 从远端的数据源 加载完数据之后触发该事件。 |