模态框
类型
基本类型
启动方式一:通过在一个起控制器作用的页面元素(例如,按钮)上设置data-toggle="modal",并使用data-target="#foo"或href="#foo"指向特定的模态框即可。
启动方式二:只需一行JavaScript代码,即可通过id myModal调用模态框: $('#myModal').modal(options)
变化
选项
aria-labelledby="myModalTitle"属性指向模态框标题。
aria-hidden="true"告诉辅助性工具略过模态框的DOM元素。
aria-describedby='myModelBody'属性用以指向描述信息。
通过对div.modal增加data-*选项来改变模态对话框。或通过js改变$('#myModal').modal({ keyboard: false })
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
backdrop | boolean/static | true |
|
keyboard | boolean | true |
|
show | boolean | true |
|
remote | path | false | 如果提供了远程url地址,就会通过 jQuery的 |
方法和事件
方法 | 例子 | 描述 |
---|---|---|
.modal(options) | $('#myModal').modal({ keyboard: false }) |
让你指定的内容变成一个模态对话框。接受一个可选的参数object. |
.modal('toggle') | $('#myModal').modal('toggle') |
手动打开或隐藏一个模态对话框。 |
.modal('show') | $('#myModal').modal('show') |
手动打开一个模态对话框。 |
.modal('hide') | $('#myModal').modal('hide') |
手动隐藏一个模态对话框。 |
事件 | 使用 | 描述 |
---|---|---|
show.bs.modal | $('#myModal').on('show.bs.modal', function () { // do something… }) |
当show 方法被调用时,此事件将被立即触发。 |
shown.bs.modal | $('#myModal').on('shown.bs.modal', function () { // do something… }) |
当模态对话框呈现到用户面前时(会等待过渡效果执行结束)此事件被触发。 |
hide.bs.modal | $('#myModal').on('hide.bs.modal', function () { // do something… }) |
当hide 方法被调用时,此事件将被立即触发。 |
hidden.bs.modal | $('#myModal').on('hidden.bs.modal', function () { // do something… }) |
当模态对话框被隐藏(而且过渡效果执行完毕)之后,此事件将被触发。 |
改变模态框大小
通过重新定义.modal-dialog宽度.modal-dialog {width:*}
来改变模态框大小
载入效果
目前有div.modal.fade和div.modal.in效果,需要transition.js支持。