JavaScript

13 個のカスタム jQuery プラグインを使用して、Bootstrap のコンポーネントに命を吹き込みます。

個別またはコンパイル済み

プラグインは個別に (依存関係が必要なものもありますが)、または一度にすべて含めることができます。bootstrap.jsbootstrap.min.jsの両方に、すべてのプラグインが 1 つのファイルに含まれています。

データ属性

すべての Bootstrap プラグインは、JavaScript を 1 行も記述することなく、マークアップ API を介して純粋に使用できます。これは Bootstrap のファースト クラス API であり、プラグインを使用する際に最初に考慮する必要があります。

とはいえ、状況によっては、この機能をオフにすることが望ましい場合があります。したがって、`'data-api'` でネームスペース化された body のすべてのイベントのバインドを解除することにより、データ属性 API を無効にする機能も提供します。これは次のようになります。

  1. $ ( 「本体」)。オフ( 「.data-api」)

または、特定のプラグインをターゲットにするには、次のように data-api 名前空間とともにプラグインの名前を名前空間として含めるだけです。

  1. $ ( 「本体」)。オフ( 「.alert.data-api」)

プログラム API

また、すべての Bootstrap プラグインを純粋に JavaScript API を介して使用できるべきだと考えています。すべてのパブリック API は単一の連鎖可能なメソッドであり、操作対象のコレクションを返します。

  1. $ ( ".btn.danger" ). ボタン( 「トグル」)。addClass ( "脂肪" )

すべてのメソッドは、オプションのオプション オブジェクト、特定のメソッドを対象とする文字列、または何も受け入れない (デフォルトの動作でプラグインを開始する) 必要があります。

  1. $ ( "#myModal" ). modal () // デフォルトで初期化
  2. $ ( "#myModal" ). modal ({ keyboard : false }) // キーボードなしで初期化
  3. $ ( "#myModal" ). modal ( 'show' ) // すぐにショーを初期化して呼び出す

各プラグインは、`Constructor` プロパティで生のコンストラクタも公開します: $.fn.popover.Constructor. 特定のプラグイン インスタンスを取得する場合は、要素から直接取得します: $('[rel=popover]').data('popover')

競合なし

他の UI フレームワークで Bootstrap プラグインを使用する必要がある場合があります。このような状況では、名前空間の競合が発生することがあります。これが発生し.noConflictた場合は、値を元に戻したいプラグインを呼び出すことができます。

  1. var bootstrapButton = $ . fn . ボタンnoConflict () // $.fn.button を以前に割り当てられた値に戻す
  2. $ . fn . bootstrapBtn = bootstrapButton // $().bootstrapBtn にブートストラップ機能を与える

イベント

Bootstrap は、ほとんどのプラグイン固有のアクションに対してカスタム イベントを提供します。一般に、これらは不定詞と過去分詞形で提供されます。不定詞 (例: show) はイベントの開始時にトリガーされ、その過去分詞形 (例: shown) はアクションの完了時にトリガーされます。

すべての不定イベントは preventDefault 機能を提供します。これにより、アクションの実行を開始前に停止することができます。

  1. $ ( '#myModal' ). on ( 'ショー' ,関数( e ) {
  2. if (! data ) return e . preventDefault () // モーダルの表示を停止します
  3. }))

トランジションについて

シンプルなトランジション効果の場合は、bootstrap-transition.jsを他の JS ファイルと一緒に 1 回インクルードします。コンパイル済み (または圧縮済み)のbootstrap.jsを使用している場合は、これを含める必要はありません。既に存在します。

ユースケース

移行プラグインのいくつかの例:

  • モーダルでのスライドまたはフェード
  • タブのフェードアウト
  • アラートのフェードアウト
  • スライディング カルーセル ペイン

モーダルは合理化されていますが、必要最小限の機能とスマートなデフォルトを備えた柔軟なダイアログ プロンプトです。

静的な例

ヘッダー、本文、およびフッターの一連のアクションを含むレンダリングされたモーダル。

  1. <divクラス= "モーダル非表示フェード" >
  2. <divクラス= "モーダル ヘッダー" >
  3. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </ボタン>
  4. <h3>モーダル ヘッダー</h3>
  5. </div>
  6. <div class = "modal-body" >
  7. <p> 1 つの素晴らしいボディ… </p>
  8. </div>
  9. <div class = "modal-footer" >
  10. <a href = "#" class = "btn" >閉じる</a>
  11. <a href = "#" class = "btn btn-primary" >変更を保存</a>
  12. </div>
  13. </div>

ライブデモ

下のボタンをクリックして、JavaScript でモーダルを切り替えます。ページの上部から下にスライドしてフェードインします。

  1. <!-- モーダルをトリガーするボタン -->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" >デモ モーダルを起動</a>
  3.  
  4. <!-- モーダル -->
  5. <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria- labelledby = "myModalLabel" aria-hidden = "true" >
  6. <divクラス= "モーダル ヘッダー" >
  7. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
  8. <h3 id = "myModalLabel" >モーダル ヘッダー</h3>
  9. </div>
  10. <div class = "modal-body" >
  11. <p> 1 つの素晴らしいボディ… </p>
  12. </div>
  13. <div class = "modal-footer" >
  14. <button class = "btn" data-dismiss = "modal" aria-hidden = "true" >閉じる</button>
  15. <button class = "btn btn-primary" >変更を保存</button>
  16. </div>
  17. </div>

使用法

データ属性経由

JavaScript を書かずにモーダルを有効にします。特定のモーダルを切り替え対象にするために、 ordata-toggle="modal"とともに、ボタンなどのコントローラー要素に設定します。data-target="#foo"href="#foo"

  1. <button type = "button" data-toggle = "modal" data-target = "#myModal" >モーダルを起動</button>

JavaScript 経由

myModalJavaScript の 1 行でid を使用してモーダルを呼び出します。

  1. $ ( '#myModal' ). モーダル(オプション)

オプション

オプションは、データ属性または JavaScript を介して渡すことができます。data-データ属性の場合、オプション名をのようにに追加しますdata-backdrop=""

名前 タイプ デフォルト 説明
背景 ブール値 真実 モーダル背景要素が含まれています。staticまたは、クリック時にモーダルを閉じない背景を指定します。
キーボード ブール値 真実 エスケープキーが押されたときにモーダルを閉じます
見せる ブール値 真実 初期化時にモーダルを表示します。
リモート 間違い

loadリモート URL が指定されている場合、コンテンツは jQuery のメソッドを介してロードされ、 .modal-body. データ API を使用している場合は、hrefタグを使用してリモート ソースを指定することもできます。この例を以下に示します。

  1. <a data-toggle="modal" href="remote.html" data-target="#modal">click me</a>

メソッド

.modal(オプション)

コンテンツをモーダルとしてアクティブにします。オプションのオプションを受け入れますobject

  1. $ ( '#myModal' ). モーダル({
  2. キーボード: false
  3. }))

.modal('トグル')

モーダルを手動で切り替えます。

  1. $ ( '#myModal' ). モーダル( 「トグル」)

.modal('表示')

モーダルを手動で開きます。

  1. $ ( '#myModal' ). モーダル( 「表示」)

.modal('隠す')

モーダルを手動で非表示にします。

  1. $ ( '#myModal' ). モーダル( 「非表示」)

イベント

Bootstrap のモーダル クラスは、モーダル機能にフックするためのいくつかのイベントを公開します。

イベント 説明
見せる showこのイベントは、インスタンス メソッドが呼び出されるとすぐに発生します。
示した このイベントは、モーダルがユーザーに表示されるようになったときに発生します (css トランジションが完了するのを待ちます)。
隠れる hideこのイベントは、インスタンス メソッドが呼び出されるとすぐに発生します。
隠れた このイベントは、モーダルがユーザーから非表示にされたときに発生します (css トランジションが完了するのを待ちます)。
  1. $ ( '#myModal' ). on ( 'hidden' , function () {
  2. // 何かを…
  3. }))

ナビゲーションバーの例

ScrollSpy プラグインは、スクロール位置に基づいてナビゲーション ターゲットを自動的に更新するためのものです。ナビゲーションバーの下の領域をスクロールして、アクティブなクラスの変化を確認します。ドロップダウンのサブ項目も強調表示されます。

@太い

広告レギンス キーター、ブランチ id アート パーティー ドロア 労働。彼らが売り切れる前に、Pitchfork yr enim lo-fi。Tumblrの農場から食卓への自転車の権利は何でも。アニム・ケフィヤ・カルレスのカーディガン。Velit seitan mcsweeney のフォト ブース 3 ウルフ ムーン イルレ。コスビー セーター ロモ ジーンズ ショートパンツ、ウィリアムズバーグ パーカー ミニム qui あなたはおそらくそれらについて聞いたことがないでしょう. ニヒルは刺青を入れたアキュマス、信頼できる皮肉なバイオディーゼル ケフィーヤの職人ウラムコの結果です。

@mdo

Veniam marfa 口ひげスケート ボード、adipisicing fugiat velit 熊手のひげ。フリーガンのひげアリクア キューピダット マックウィーニーのヴェロ。Cupidatat four loko nisi, ea helvetica nulla carles. タトゥーの入ったコスビー セーターのフード トラック、mcsweeney の quis non freegan ビニール。ローファイ ウェス アンダーソン +1 仕立て屋。カルレスの非審美的なエクササイズはジェントリフィケーションです。ブルックリンの adipisicing クラフト ビール vice keytar deserunt.

1

Occaecat コモド aliqua delectus。Fap クラフト ビール deserunt スケート ボード ea。Lomo の自転車の権利は banh mi を adipisicing、velit ea sunt は次のレベルの locavore シングルオリジン コーヒーをマグナ veniam で提供します。ハイライフIDビニール、エコーパークコンセクアットキアリキップバインミーピッチフォーク。Vero VHS est adipisicing. Consectetur nisi DIY ミニムメッセンジャーバッグ。Cred ex in、持続可能な delectus consectetur ファニー パック iPhone。

2

In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.

three

Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

Keytar twee ブログ、カルパ メッセンジャー バッグ マーファ エニウェア デレクタス フード トラック。Sapiente シンセ ID は仮定だ。Locavore sed helvetica cliche 皮肉、あなたがおそらく聞いたことのないサンダーキャットは、グルテンフリーのローファイファップアリクイップを結果としてもたらします. 彼らが売り切れる前に労働者のエリートの場所、テリー・リチャードソンのプロイデント・ブランチ、ネス・コスビー・セーター・パリアトゥール・ケフィーヤ・ウット・ヘルベチカ・アーティザン. カーディガン クラフトビール セイタン レディメイド ヴェリット。VHS シャンブレーラボラリス tempor veniam. アニメーション mollit minim commodo ullamco thundercats.


使用法

データ属性経由

scrollspy 動作をトップバー ナビゲーションに簡単に追加するdata-spy="scroll"には、スパイしたい要素 (通常は本文)data-target=".navbar"に追加し、使用するナビゲーションを選択します。コンポーネントで scrollspy を使用する必要があり.navます。

  1. <body data-spy = "scroll" data-target = ".navbar" > ... </body>

JavaScript 経由

JavaScript 経由で scrollspy を呼び出します。

  1. $ ( '#navbar' ). スクロールスパイ()
注意喚起!Navbar リンクには、解決可能な ID ターゲットが必要です。たとえば、 a <a href="#home">home</a>は のような dom 内の何かに対応している必要があり <div id="home"></div>ます。

メソッド

.scrollspy('リフレッシュ')

scrollspy を DOM からの要素の追加または削除と組み合わせて使用​​する場合、次のように refresh メソッドを呼び出す必要があります。

  1. $ ( '[data-spy="scroll"]' ). それぞれ(関数() {
  2. var $spy = $ ( this ). scrollspy ( 「リフレッシュ」)
  3. });

オプション

オプションは、データ属性または JavaScript を介して渡すことができます。data-データ属性の場合、オプション名をのようにに追加しますdata-offset=""

名前 タイプ デフォルト 説明
オフセット 番号 10 スクロールの位置を計算するときに上からオフセットするピクセル。

イベント

イベント 説明
活性化 このイベントは、スクロールスパイによって新しいアイテムがアクティブになるたびに発生します。

タブの例

クイックで動的なタブ機能を追加して、ドロップダウン メニューを介しても、ローカル コンテンツのペイン間を遷移します。

おそらく聞いたことのない未加工のデニム ジーンズショーツ オースティン。ネスカント 豆腐 スタンプタウン アリクア、レトロ シンセ マスター クレンズ。口ひげのクリシェ テンポ、ウィリアムズバーグ カルレス ビーガン ヘルベチカ。Reprehenderit ブッチャー レトロ クーフィーヤ ドリームキャッチャー シンセ。Cosby セーター eu banh mi, qui irure terry Richardson ex squid. アリクイップは、サルビア・チルムのiPhoneに置きます。Seitan aliquip quis カーディガン アメリカン アパレル、ブッチャー voluptate nisi qui.

Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.


使用法

JavaScript を介してタブ可能なタブを有効にします (各タブは個別に有効にする必要があります):

  1. $ ( '#myTab a' ). クリック(関数( e ) {
  2. e . preventDefault ();
  3. $ (これ)。タブ( 「表示」);
  4. }))

いくつかの方法で個々のタブをアクティブ化できます。

  1. $ ( '#myTab a[href="#profile"]' ). タブ( 「表示」); // 名前でタブを選択
  2. $ ( '#myTab a:first' ). タブ( 「表示」); // 最初のタブを選択
  3. $ ( '#myTab a:last' ). タブ( 「表示」); // 最後のタブを選択
  4. $ ( '#myTab li:eq(2) a' ). タブ( 「表示」); // 3 番目のタブ (0-indexed) を選択します

マークアップ

data-toggle="tab"要素にまたはを指定するだけで、JavaScript を記述することなく、タブまたはピル ナビゲーションを有効にすることができますdata-toggle="pill"navおよびnav-tabsクラスをタブに追加するとul、Bootstrap タブのスタイルが適用されます。

  1. <ul class = "nav nav-tabs" >
  2. <li><a href = "#home" data-toggle = "tab" >ホーム</a></li>
  3. <li><a href = "#profile" data-toggle = "tab" >プロフィール</a></li>
  4. <li><a href = "#messages" data-toggle = "tab" >メッセージ</a></li>
  5. <li><a href = "#settings" data-toggle = "tab" >設定</a></li>
  6. </ul>

メソッド

$().tab

タブ要素とコンテンツ コンテナーをアクティブにします。タブには、DOM 内のコンテナ ノードを対象とするdata-targetまたはが必要です。href

  1. <ul class = "nav nav-tabs" id = "myTab" >
  2. <li class = "active" ><a href = "#home" >ホーム</a></li>
  3. <li><a href = "#profile" >プロフィール</a></li>
  4. <li><a href = "#messages" >メッセージ</a></li>
  5. <li><a href = "#settings" >設定</a></li>
  6. </ul>
  7.  
  8. <div class = "tab-content" >
  9. <divクラス= "タブ ペイン アクティブ" id = "ホーム" > ... </div>
  10. <divクラス= "タブペイン" id = "プロファイル" > ... </div>
  11. <divクラス= "タブペイン" id = "メッセージ" > ... </div>
  12. <divクラス= "タブペイン" id = "設定" > ... </div>
  13. </div>
  14.  
  15. <スクリプト>
  16. $ (関数() {
  17. $ ( '#myTab a:last' ). タブ( 「表示」);
  18. }))
  19. </script>

イベント

イベント 説明
見せる このイベントは、タブの表示時に発生しますが、新しいタブが表示される前です。と を使用event.targetevent.relatedTargetて、それぞれアクティブなタブと以前のアクティブなタブ (利用可能な場合) をターゲットにします。
示した このイベントは、タブが表示された後にタブ表示で発生します。と を使用event.targetevent.relatedTargetて、それぞれアクティブなタブと以前のアクティブなタブ (利用可能な場合) をターゲットにします。
  1. $ ( 'a[data-toggle="タブ"]' ). on ( '示された' ,関数( e ) {
  2. e . ターゲット// アクティブ化されたタブ
  3. e . relatedTarget // 前のタブ
  4. }))

Jason Frame によって書かれた優れた jQuery.tipsy プラグインに触発されました。ツールチップは更新されたバージョンで、画像に依存せず、アニメーションに CSS3 を使用し、ローカル タイトル ストレージにデータ属性を使用します。

パフォーマンス上の理由から、ツールチップとポップオーバーのデータ API はオプトインされています。つまり、自分で初期化する必要があります

以下のリンクにカーソルを合わせると、ツールヒントが表示されます。

タイト パンツ ネクスト レベルのケフィーヤ、おそらく聞いたことがないでしょう。フォトブースヒゲ生デニム活版ヴィーガンメッセンジャーバッグスタンプタウン。農場から食卓までのセイタン、mcsweeney's fixie の持続可能なキノア 8 ビット アメリカン アパレルには、テリー リチャードソンのビニール シャンブレーがあります。ビアード スタンプタウン、カーディガン banh mi lomo サンダーキャッツ。豆腐のバイオディーゼル ウィリアムズバーグ マーファ、フォーロコ マックウィーニーのクレンズ ビーガン シャンブレー。キーターが何であれ、本当に皮肉な職人、シーンスター、農場から食卓までのバンクシー、オースティンのツイッター、フリーガンの信条、生のデニム、シングルオリジンのコーヒーのバイラル。

四方

入力グループのツールチップ

Bootstrap 入力グループでツールチップとポップオーバーを使用する場合、container不要な副作用を避けるために (以下に記載されている) オプションを設定する必要があります。


使用法

JavaScript を介してツールチップをトリガーします。

  1. $ ( '#例' ). ツールチップ(オプション)

オプション

オプションは、データ属性または JavaScript を介して渡すことができます。data-データ属性の場合、オプション名をのようにに追加しますdata-animation=""

名前 タイプ デフォルト 説明
アニメーション ブール値 真実 ツールチップに CSS フェード トランジションを適用する
html ブール値 間違い ツールチップに html を挿入します。false の場合、jquery のtextメソッドを使用してコンテンツを dom に挿入します。XSS 攻撃が心配な場合は、テキストを使用してください。
配置 文字列 | 関数 '上' ツールチップの配置方法 - トップ | ボトム | 左 | 左 | 右
セレクタ ストリング 間違い セレクターが提供されている場合、ツールチップ オブジェクトは指定されたターゲットに委譲されます。
題名 文字列 | 関数 '' `title` タグが存在しない場合のデフォルトのタイトル値
引き金 ストリング 「ホバーフォーカス」 ツールチップのトリガー方法 - クリック | ホバー | フォーカス | マニュアル。トリガーを複数、スペースで区切って、トリガーの種類を渡す場合に注意してください。
遅れ 数 | 物体 0

ツールチップの表示と非表示の遅延 (ミリ秒) - 手動トリガー タイプには適用されません

数値が指定されている場合、表示/非表示の両方に遅延が適用されます

オブジェクト構造は次のとおりです。delay: { show: 500, hide: 100 }

容器 文字列 | 間違い 間違い

ツールチップを特定の要素に追加しますcontainer: 'body'

注意喚起!個々のツールチップのオプションは、データ属性を使用して指定することもできます。

マークアップ

  1. <a href = "#" data-toggle = "tooltip" title = "最初のツールヒント" >ホバー</a>

メソッド

$().tooltip(オプション)

ツールヒント ハンドラーを要素コレクションにアタッチします。

.tooltip('表示')

要素のツールチップを表示します。

  1. $ ( 「#要素」)。ツールチップ( 'show' )

.tooltip('非表示')

要素のツールチップを非表示にします。

  1. $ ( 「#要素」)。ツールチップ( '隠す' )

.tooltip('トグル')

要素のツールチップを切り替えます。

  1. $ ( 「#要素」)。ツールチップ( 'トグル' )

.tooltip('破壊')

要素のツールチップを非表示にして破棄します。

  1. $ ( 「#要素」)。ツールチップ( 「破棄」)

二次情報を格納するために、iPad のようなコンテンツの小さなオーバーレイを任意の要素に追加します。ボタンにカーソルを合わせると、ポップオーバーがトリガーされます。ツールチップを含める必要があります。

静的ポップオーバー

上揃え、右揃え、下揃え、左揃えの 4 つのオプションを使用できます。

ポップオーバートップ

Sed posuere consectetur est at lobortis. Aenean eu leo quam。Pellentesque ornare sem lacinia quam venenatis vestibulum.

ポップオーバー右

Sed posuere consectetur est at lobortis. Aenean eu leo quam。Pellentesque ornare sem lacinia quam venenatis vestibulum.

ポップオーバーボトム

Sed posuere consectetur est at lobortis. Aenean eu leo quam。Pellentesque ornare sem lacinia quam venenatis vestibulum.

ポップオーバー左

Sed posuere consectetur est at lobortis. Aenean eu leo quam。Pellentesque ornare sem lacinia quam venenatis vestibulum.

ポップオーバーとして表示されるマークアップは、JavaScript およびdata属性内のコンテンツから生成されません。

ライブデモ

四方


使用法

JavaScript を介してポップオーバーを有効にします。

  1. $ ( '#例' ). ポップオーバー(オプション)

オプション

オプションは、データ属性または JavaScript を介して渡すことができます。data-データ属性の場合、オプション名をのようにに追加しますdata-animation=""

名前 タイプ デフォルト 説明
アニメーション ブール値 真実 ツールチップに CSS フェード トランジションを適用する
html ブール値 間違い ポップオーバーに html を挿入します。false の場合、jquery のtextメソッドを使用してコンテンツを dom に挿入します。XSS 攻撃が心配な場合は、テキストを使用してください。
配置 文字列 | 関数 '右' ポップオーバーの配置方法 - トップ | ボトム | 左 | 左 | 右
セレクタ ストリング 間違い セレクターが提供されている場合、ツールチップ オブジェクトは指定されたターゲットに委譲されます。
引き金 ストリング 'クリック' ポップオーバーのトリガー方法 - クリック | ホバー | フォーカス | マニュアル
題名 文字列 | 関数 '' `title` 属性が存在しない場合のデフォルトのタイトル値
コンテンツ 文字列 | 関数 '' `data-content` 属性が存在しない場合のデフォルトのコンテンツ値
遅れ 数 | 物体 0

ポップオーバーの表示と非表示の遅延 (ミリ秒) - 手動トリガー タイプには適用されません

数値が指定されている場合、表示/非表示の両方に遅延が適用されます

オブジェクト構造は次のとおりです。delay: { show: 500, hide: 100 }

容器 文字列 | 間違い 間違い

ポップオーバーを特定の要素に追加しますcontainer: 'body'

注意喚起!個々のポップオーバーのオプションは、データ属性を使用して指定することもできます。

マークアップ

パフォーマンス上の理由から、Tooltip および Popover データ API はオプトインされています。これらを使用する場合は、セレクター オプションを指定するだけです。

メソッド

$().popover(オプション)

要素コレクションのポップオーバーを初期化します。

.popover('表示')

要素のポップオーバーを表示します。

  1. $ ( 「#要素」)。ポップオーバー( '表示' )

.popover('隠す')

要素のポップオーバーを非表示にします。

  1. $ ( 「#要素」)。ポップオーバー( '隠す' )

.popover('トグル')

要素のポップオーバーを切り替えます。

  1. $ ( 「#要素」)。ポップオーバー( 'トグル' )

.popover('破棄')

要素のポップオーバーを非表示にして破棄します。

  1. $ ( 「#要素」)。ポップオーバー( 「破棄」)

アラートの例

このプラグインを使用して、すべてのアラート メッセージに却下機能を追加します。

聖ワカモレ!自分でチェックするのが一番です、あなたはあまり見栄えがよくありません。

ああスナップ!エラーが発生しました。

あれこれ変えて、やり直してください。Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

このアクションを実行 またはこれを行う


使用法

JavaScript によるアラートの却下を有効にします。

  1. $ ( ".alert" ). アラート()

マークアップ

閉じるボタンに追加data-dismiss="alert"するだけで、アラートを閉じる機能が自動的に提供されます。

  1. <a class = "close" data-dismiss = "alert" href = "#" > × </a>

メソッド

$().アラート()

すべてのアラートをクローズ機能でラップします。閉じたときにアラートがアニメーション化されるようにするには、アラートに.fadeand.inクラスが既に適用されていることを確認してください。

.alert('閉じる')

アラートを閉じます。

  1. $ ( ".alert" ). アラート( 「閉じる」)

イベント

Bootstrap のアラート クラスは、アラート機能にフックするためのいくつかのイベントを公開します。

イベント 説明
近い closeこのイベントは、インスタンス メソッドが呼び出されるとすぐに発生します。
閉まっている このイベントは、アラートが閉じられたときに発生します (css トランジションが完了するまで待機します)。
  1. $ ( '#my-アラート' ). bind ( 'closed' , function () {
  2. // 何かを…
  3. }))

使用例

ボタンをもっと活用しましょう。ボタンの状態を制御したり、ツールバーなどのその他のコンポーネント用にボタンのグループを作成したりします。

ステートフル

data-loading-text="Loading..."ボタンの読み込み状態を使用するために追加します。

  1. <button type = "button" class = "btn btn-primary" data-loading-text = "Loading..." > Loading state </button>

シングルトグル

data-toggle="button"単一のボタンでトグルを有効にするために追加します。

  1. <button type = "button" class = "btn btn-primary" data-toggle = "button" >シングル トグル</button>

チェックボックス

data-toggle="buttons-checkbox"btn-group にチェックボックス スタイルの切り替えを追加します。

  1. <div class = "btn-group" data-toggle = "buttons-checkbox" >
  2. <button type = "button" class = "btn btn-primary" ></button>
  3. <button type = "button" class = "btn btn-primary" > Middle </button>
  4. <button type = "button" class = "btn btn-primary" ></button>
  5. </div>

無線

data-toggle="buttons-radio"btn-group でのラジオ スタイルの切り替えを追加します。

  1. <div class = "btn-group" data-toggle = "buttons-radio" >
  2. <button type = "button" class = "btn btn-primary" ></button>
  3. <button type = "button" class = "btn btn-primary" > Middle </button>
  4. <button type = "button" class = "btn btn-primary" ></button>
  5. </div>

使用法

JavaScript 経由でボタンを有効にします。

  1. $ ( 「.nav-tabs」)。ボタン()

マークアップ

データ属性は、ボタン プラグインに不可欠です。さまざまなマークアップ タイプについては、以下のサンプル コードを確認してください。

オプション

なし

メソッド

$().button('トグル')

プッシュ状態を切り替えます。アクティブ化されたボタンの外観を与えます。

注意喚起!data-toggle属性 を使用して、ボタンの自動切り替えを有効にでき ます。
  1. <button type = "button" class = "btn" data-toggle = "button" > </button>

$().button('読み込み中')

ボタンの状態を読み込み中に設定します - ボタンを無効にし、テキストを読み込み中のテキストに切り替えます。読み込み中のテキストは、ボタン要素で data 属性を使用して定義する必要がありますdata-loading-text

  1. <button type = "button" class = "btn" data-loading-text = "loading stuff..." > ... </button>
注意喚起! Firefox は、ページをロードしても無効な状態を維持します。これを回避するには、 を使用します autocomplete="off"

$().button('リセット')

ボタンの状態をリセット - テキストを元のテキストに入れ替えます。

$().ボタン(文字列)

ボタンの状態をリセット - テキストを任意のデータ定義のテキスト状態にスワップします。

  1. <button type = "button" class = "btn" data-complete-text = "finished!" > ... </button>
  2. <スクリプト>
  3. $ ( '.btn' )。ボタン( 「完了」)
  4. </script>

アコーディオンやナビゲーションなどの折りたたみ可能なコンポーネントの基本スタイルと柔軟なサポートを取得します。

*トランジション プラグインが含まれている必要があります。

アコーディオンの例

collapse プラグインを使用して、シンプルなアコーディオン スタイルのウィジェットを作成しました。

アニメーションのクリシェの表現者、エニム エウスモッド ハイ ライフ アキュマスス テリー リチャードソンとイカ。3 ウルフ ムーン オフィシア オーテ、ノン キューピダット スケートボード ドロール ブランチ。フード トラック キノア nesciunt labourum eiusmod。ブランチ 3 オオカミの月の一時、サント アリクア、鳥を乗せたイカ、シングルオリジンのコーヒー ヌラ、アセンダ、ショアディッチなど。Nihil anim keffiyeh helvetica, クラフト ビール労働者 wes anderson cred nesciunt sapiente ea proident. Adveganexcepteurブッチャーバイスロモ。レギンスは、農場から食卓までのクラフトビール、生のデニムの美的シンセ、おそらく聞いたことがないかもしれません。
アニメーションのクリシェの表現者、エニム エウスモッド ハイ ライフ アキュマスス テリー リチャードソンとイカ。3 ウルフ ムーン オフィシア オーテ、ノン キューピダット スケートボード ドロール ブランチ。フード トラック キノア nesciunt labourum eiusmod。ブランチ 3 オオカミの月の一時、サント アリクア、鳥を乗せたイカ、シングルオリジンのコーヒー ヌラ、アセンダ、ショアディッチなど。Nihil anim keffiyeh helvetica, クラフト ビール労働者 wes anderson cred nesciunt sapiente ea proident. Adveganexcepteurブッチャーバイスロモ。レギンスは、農場から食卓までのクラフトビール、生のデニムの美的シンセ、おそらく聞いたことがないかもしれません。
アニメーションのクリシェの表現者、エニム エウスモッド ハイ ライフ アキュマスス テリー リチャードソンとイカ。3 ウルフ ムーン オフィシア オーテ、ノン キューピダット スケートボード ドロール ブランチ。フード トラック キノア nesciunt labourum eiusmod。ブランチ 3 オオカミの月の一時、サント アリクア、鳥を乗せたイカ、シングルオリジンのコーヒー ヌラ、アセンダ、ショアディッチなど。Nihil anim keffiyeh helvetica, クラフト ビール労働者 wes anderson cred nesciunt sapiente ea proident. Adveganexcepteurブッチャーバイスロモ。レギンスは、農場から食卓までのクラフトビール、生のデニムの美的シンセ、おそらく聞いたことがないかもしれません。
  1. <div class = "accordion" id = "accordion2" >
  2. <divクラス= "アコーディオン グループ" >
  3. <div class = "accordion-heading" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
  5. 折りたたみ可能なグループ アイテム #1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "アコーディオン本体の折りたたみ" >
  9. <div class = "accordion-inner" >
  10. アニメーションパリトゥールクリシェ...
  11. </div>
  12. </div>
  13. </div>
  14. <divクラス= "アコーディオン グループ" >
  15. <div class = "accordion-heading" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
  17. 折りたたみ可能なグループ アイテム #2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "アコーディオン本体の折りたたみ" >
  21. <div class = "accordion-inner" >
  22. アニメーションパリトゥールクリシェ...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

アコーディオン マークアップなしでプラグインを使用することもできます。別の要素の展開と折りたたみを切り替えるボタンを作成します。

  1. <button type = "button" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
  2. シンプルな折りたたみ式
  3. </ボタン>
  4.  
  5. <div id = "デモ"クラス= "折りたたむ" > </div>

使用法

データ属性経由

data-toggle="collapse"要素にとを追加するだけdata-targetで、折りたたみ可能な要素の制御を自動的に割り当てることができます。このdata-target属性は、折りたたみを適用する CSS セレクターを受け入れます。collapse折りたたみ可能な要素にクラスを必ず追加してください。デフォルトで開くようにしたい場合は、追加の class を追加しますin

折りたたみ可能なコントロールにアコーディオンのようなグループ管理を追加するには、 data 属性を追加しますdata-parent="#selector"。実際の動作については、デモを参照してください。

JavaScript 経由

次を使用して手動で有効にします。

  1. $ ( ".collapse" ). 折りたたむ()

オプション

オプションは、データ属性または JavaScript を介して渡すことができます。data-データ属性の場合、オプション名をのようにに追加しますdata-parent=""

名前 タイプ デフォルト 説明
セレクタ 間違い セレクターの場合、この折りたたみ可能なアイテムが表示されると、指定された親の下にあるすべての折りたたみ可能な要素が閉じられます。(従来のアコーディオンの動作に似ています)
トグル ブール値 真実 呼び出し時に折りたたみ可能な要素を切り替えます

メソッド

.collapse(オプション)

折りたたみ可能な要素としてコンテンツをアクティブにします。オプションのオプションを受け入れますobject

  1. $ ( '#myCollapsible' ). 崩壊({
  2. トグル: false
  3. }))

.collapse('トグル')

折りたたみ可能な要素を表示または非表示に切り替えます。

.collapse('表示')

折りたたみ可能な要素を示します。

.collapse('隠す')

折りたたみ可能な要素を非表示にします。

イベント

Bootstrap の collapse クラスは、collapse 機能にフックするためのいくつかのイベントを公開します。

イベント 説明
見せる showこのイベントは、インスタンス メソッドが呼び出されるとすぐに発生します。
示した このイベントは、折りたたみ要素がユーザーに表示されると発生します (css トランジションが完了するのを待ちます)。
隠れる hideこのイベントは、メソッドが呼び出されるとすぐに発生します。
隠れた このイベントは、折りたたみ要素がユーザーから隠されているときに発生します (css トランジションが完了するのを待ちます)。
  1. $ ( '#myCollapsible' ). on ( 'hidden' , function () {
  2. // 何かを…
  3. }))

任意のフォーム テキスト入力でエレガントな先行入力をすばやく作成するための基本的で簡単に拡張できるプラグイン。

  1. <input type = "text" data-provide = "typeahead" >

autocomplete="off"デフォルトのブラウザー メニューが Bootstrap の先行入力ドロップダウンに表示されないように設定する必要があります。


使用法

データ属性経由

上記の例に示すように、データ属性を追加して、先行入力機能を持つ要素を登録します。

JavaScript 経由

次を使用して手動で先行入力を呼び出します。

  1. $ ( '.typeahead' ). 先行入力()

オプション

オプションは、データ属性または JavaScript を介して渡すことができます。data-データ属性の場合、オプション名をのようにに追加しますdata-source=""

名前 タイプ デフォルト 説明
ソース 配列、関数 [ ] クエリ対象のデータ ソース。文字列の配列または関数の場合があります。queryこの関数には、入力フィールドの値とprocessコールバックの 2 つの引数が渡されます。processこの関数は、データ ソースを直接返すことによって同期的に使用することも、コールバックの単一の引数を介して非同期的に使用することもできます。
アイテム 番号 8 ドロップダウンに表示する項目の最大数。
最小の長さ 番号 1 オートコンプリート候補をトリガーする前に必要な最小文字長
マッチャー 関数 大文字小文字を区別しません クエリがアイテムに一致するかどうかを判断するために使用される方法。itemクエリをテストする単一の引数を受け入れます。で現在のクエリにアクセスしますthis.querytrueクエリが一致する場合はブール値を返します。
ソーター 関数 完全一致、
大文字と小文字を区別、
大文字と小文字を区別しない
オートコンプリート結果の並べ替えに使用されるメソッド。単一の引数itemsを受け入れ、先行入力インスタンスのスコープを持ちます。で現在のクエリを参照しますthis.query
アップデーター 関数 選択したアイテムを返します 選択したアイテムを返すために使用されるメソッド。単一の引数を受け入れ、先行item入力インスタンスのスコープを持ちます。
蛍光ペン 関数 すべてのデフォルトの一致を強調表示します オートコンプリートの結果を強調表示するために使用されるメソッド。単一の引数itemを受け入れ、先行入力インスタンスのスコープを持ちます。html を返す必要があります。

メソッド

.typeahead(オプション)

先行入力で入力を初期化します。

左側のサブナビゲーションは接辞プラグインのライブ デモです。


使用法

データ属性経由

接辞動作を任意の要素に簡単に追加するdata-spy="affix"には、スパイしたい要素に追加するだけです。次に、オフセットを使用して、要素の固定のオンとオフをいつ切り替えるかを定義します。

  1. <div data-spy = "affix" data-offset-top = "200" > ... </div>
注意喚起!固定された要素の位置とその直接の親の動作を管理する必要があります。位置は affixaffix-top、および によって制御されaffix-bottomます。ページの通常のフローからコンテンツを削除するため、接辞が適用されたときに折りたたまれている可能性のある親を確認することを忘れないでください。

JavaScript 経由

JavaScript 経由で接辞プラグインを呼び出します。

  1. $ ( '#navbar' ). 接辞()

オプション

オプションは、データ属性または JavaScript を介して渡すことができます。data-データ属性の場合、オプション名をのようにに追加しますdata-offset-top="200"

名前 タイプ デフォルト 説明
オフセット 数 | 関数 | 物体 10 スクロールの位置を計算するときに画面からオフセットするピクセル。単一の数値が指定された場合、オフセットは上方向と左方向の両方に適用されます。単一の方向または複数の一意のオフセットをリッスンするには、オブジェクトを提供するだけoffset: { x: 10 }です。オフセットを動的に提供する必要がある場合は、関数を使用します (一部のレスポンシブ デザインに役立ちます)。