单个还是全部引入
JavaScript 插件可以单个引入(使用 Bootstrap 提供的单个 *.js
文件),或者一次性全部引入(使用 bootstrap.js 或压缩版的 bootstrap.min.js)。
建议使用压缩版的 JavaScript 文件
bootstrap.js 和 bootstrap.min.js 都包含了所有插件,你在使用时,只需选择一个引入页面就可以了。
插件之间的依赖关系
某些插件和 CSS 组件依赖于其它插件。如果你是单个引入每个插件的,请确保在文档中检查插件之间的依赖关系。注意,所有插件都依赖 jQuery (也就是说,jQuery必须在所有插件之前引入页面)。 bower.json 文件中列出了 Bootstrap 所支持的 jQuery 版本。
data 属性
你可以仅仅通过 data 属性 API 就能使用所有的 Bootstrap 插件,无需写一行 JavaScript 代码。这是 Bootstrap 中的一等 API,也应该是你的首选方式。
话又说回来,在某些情况下可能需要将此功能关闭。因此,我们还提供了关闭 data 属性 API 的方法,即解除以 data-api 为命名空间并绑定在文档上的事件。就像下面这样:
$(document).off('.data-api')
另外,如果是针对某个特定的插件,只需在 data-api 前面添加那个插件的名称作为命名空间,如下:
$(document).off('.alert.data-api')
编程方式的 API
我们为所有 Bootstrap 插件提供了纯 JavaScript 方式的 API。所有公开的 API 都是支持单独或链式调用方式,并且返回其所操作的元素集合(注:和jQuery的调用形式一致)。
$('.btn.danger').button('toggle').addClass('fat')
所有方法都可以接受一个可选的 option 对象作为参数,或者一个代表特定方法的字符串,或者什么也不提供(在这种情况下,插件将会以默认值初始化):
$('#myModal').modal() // 以默认值初始化
$('#myModal').modal({ keyboard: false }) // initialized with no keyboard
$('#myModal').modal('show') // 初始化后立即调用 show 方法
每个插件还通过 Constructor 属性暴露了其原始的构造函数:\(.fn.popover.Constructor。如果你想获取某个插件的实例,可以直接通过页面元素获取:\)('[rel="popover"]').data('popover')。
默认设置
每个插件都可以通过修改其自身的 Constructor.DEFAULTS 对象从而改变插件的默认设置:
$.fn.modal.Constructor.DEFAULTS.keyboard = false // 将模态框插件的 `keyboard` 默认选参数置为 false
避免命名空间冲突
某些时候可能需要将 Bootstrap 插件与其他 UI 框架共同使用。在这种情况下,命名空间冲突随时可能发生。如果不幸发生了这种情况,你可以通过调用插件的 .noConflict 方法恢复其原始值。
var bootstrapButton = $.fn.button.noConflict() // return $.fn.button to previously assigned value
$.fn.bootstrapBtn = bootstrapButton // give $().bootstrapBtn the Bootstrap functionality
事件
Bootstrap 为大部分插件所具有的动作提供了自定义事件。一般来说,这些事件都有不定式和过去式两种动词的命名形式,例如,不定式形式的动词(例如 show)表示其在事件开始时被触发;而过去式动词(例如 shown )表示在动作执行完毕之后被触发。
从 3.0.0 版本开始,所有 Bootstrap 事件的名称都采用命名空间方式。
所有以不定式形式的动词命名的事件都提供了 preventDefault 功能。这就赋予你在动作开始执行前将其停止的能力。
$('#myModal').on('show.bs.modal', function (e) {
if (!data) return e.preventDefault() // 阻止模态框的展示
})
获得版本号
$.fn.tooltip.Constructor.VERSION // => "3.3.5"
未对禁用 JavaScript 的浏览器提供补救措施
Bootstrap 插件未对禁用 JavaScript 的浏览器提供补救措施。如果你对这种情况下的用户体验很关心的话,请添加 <noscript>
标签向你的用户进行解释(并告诉他们如何启用 JavaScript),或者按照你自己的方式提供补救措施。
第三方工具库
Bootstrap 官方不提供对第三方 JavaScript 工具库的支持,例如 Prototype 或 jQuery UI。除了 .noConflict 和为事件名称添加命名空间,还可能会有兼容性方面的问题,这就需要你自己来处理了。
Bootstrap提供了常见插件
1.模态对话框(Modal)
2.下拉项(Dropdown):实现下拉功能,如下拉菜单、下拉按钮、下拉工具条等。
3.滚动监听(Scrollspy):实现滚动条位置的效果,如在导航中有多个标签,点击其中一个标签,滚动条会自动定位到导航中标签对应的文本位置。
4.Tab标签页(Tab):快速实现本地内容的切换,动态切换标签页对应的本地内容。
5.工具提示(ToolTip):无需加在任何图片,采用CSS3新技术,动态显示data-attributes存储的标题信息。
6.弹出提示(Popover):用来显示一些叠加内容的提示效果,此插件需要配合Tooltips使用。
7.警告框(Alert):用来关闭警告信息块。
8.按钮(Button):用来控制按钮状态货更多组件功能,如复选框、单选按钮,以及载入状态条等。
9.折叠(Collapse):手风琴效果,用来制作折叠面板或菜单等效果。
10.轮播(Carousel):实现图片播放功能。
11.输入提示(Typeahead):可以记住文本框输入的文本,下次输入时可以及时自动补全。
12.过渡效果(Transition):为一些动画效果增加过渡。
更多Bootstrap优秀插件
1.Sco.js(http://www.bootcss.com/p/sco.js/) :对Bootstrap中Js插件的增强实现。
2.Chart.js(http://www.bootcss.com/p/chart.js):图标绘制工具库。
3.bsie(http://www.bootcss.com/p/bsie/):能在IE6上支持Bootstrap的大部分特性。
4.jQuery UI Bootstrap(http://www.bootcss.com/p/jquery-ui-bootstrap/):使Bootstrap和jQuery UI可以完美融合。
5.Flat UI(http://www.bootcss.com/p/flat-ui/):基于Bootstrap做的Metro化改造。Flat UI包含了很多Bootstrap提供的组件,但是外观更加漂亮。
6.Metro UI CSS(http://www.bootcss.com/p/metro-ui-css/):用来创建类似于Windows 8 Metro UI风格网站的样式。
7.HTML5Boilerplate(http://www.bootcss.com/p/html5boilerplate/)用来开发快速、健壮、适应性强的App或网站。