Bootstrap 插件概览
前に布局组件この章で説明したコンポーネントはほんの始まりにすぎません。Bootstrapには12種類のjQueryプラグインが同梱されており、機能を拡張してサイトにより多くのインタラクションを追加できます。上級のJavaScript開発者でなくても、BootstrapのJavaScriptプラグインを学び始めることができます。Bootstrap Data APIを利用すれば、ほとんどのプラグインはコードを一切書かずにトリガーすることができます。
サイトでBootstrapプラグインを参照する方法は2つあります:
- 单独引用:Bootstrap の個別のを使用*.jsファイル。一部のプラグインとCSSコンポーネントは他のプラグインに依存しています。プラグインを個別に参照する場合は、まずこれらのプラグイン間の依存関係を明確にしてください。
- 编译(同时)引用:使用bootstrap.jsまたは圧縮版のbootstrap.min.js。
同時にこれらの2つのファイルを参照しようとしないでください。なぜならbootstrap.jsとbootstrap.min.js両方ともすべてのプラグインを含んでいるからです。
data 属性
- data属性APIを使用するだけで、一行のJavaScriptコードも書かずにすべてのBootstrapプラグインを使用できます。これは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")
すべてのメソッドは、省略可能なオプションオブジェクトをパラメータとして受け付けるか、特定のメソッドを表す文字列を受け付けるか、またはパラメータなし(この場合、プラグインはデフォルトの動作で初期化されます)で受け付けることができます。次のようになります:
// 初始化为默认行为
$("#myModal").modal()
// 初始化为不支持键盘
$("#myModal").modal({ keyboard: false })
// 初始化并立即调用 show
$("#myModal").modal('show')
各プラグインはConstructor属性には元のコンストラクタも公開されています:$.fn.popover.Constructor。特定のプラグインのインスタンスを取得したい場合は、ページ要素から直接取得できます:
$('[rel=popover]').data('popover').
名前空間の衝突を避ける
場合によっては、Bootstrapプラグインを他のUIフレームワークと一緒に使用する必要があるかもしれません。このような場合、名前空間の競合が発生する可能性があります。万が一このような状況が発生した場合は、プラグインの.noConflictメソッドは元の値を復元します。
// 返回 $.fn.button 之前所赋的值 var bootstrapButton = $.fn.button.noConflict() // 为 $().bootstrapBtn 赋予 Bootstrap 功能 $.fn.bootstrapBtn = bootstrapButton
事件
Bootstrapは、ほとんどのプラグインの独自の動作に対してカスタムイベントを提供しています。一般的に、これらのイベントには2つの形式があります:
- 动词不定式:これはイベントの開始時にトリガーされます。例えばex: show。動詞不定式イベントは提供しますpreventDefault機能。これにより、イベントが開始される前に操作の実行を停止できます。
$('#myModal').on('show.bs.modal', function (e) { // 阻止模态框的显示 if (!data) return e.preventDefault() }) - 过去分词形式:これはアクションの実行が完了した後にトリガーされます。例えばex: shown。