ドロップダウン

Bootstrap ドロップダウンプラグインを使用して、リンクなどのリストを表示するコンテキストオーバーレイを切り替えます。

概要

ドロップダウンは、リンクのリストなどを表示するための切り替え可能なコンテキストオーバーレイです。それらは、含まれている Bootstrap ドロップダウン JavaScript プラグインを使用してインタラクティブに作成されます。ホバリングではなく、クリックすることで切り替えられます。これは意図的な設計上の決定です。

ドロップダウンは、動的ポジショニングとビューポート検出を提供するサードパーティライブラリPopper.jsに基づいて構築されています。Bootstrap の JavaScript の前に必ずpopper.min.jsを含めるか、 Popper.js を含むbootstrap.bundle.min.js/bootstrap.bundle.jsを使用してください。Popper.js は、動的な配置が必要ないため、navbars にドロップダウンを配置するために使用されません。

JavaScript をソースからビルドする場合はutil.js、 .

アクセシビリティ

WAI ARIA標準は実際の widget を定義しますrole="menu"が、これはアクションまたは機能をトリガーするアプリケーションのようなメニューに固有のものです。ARIAメニューには、メニュー項目、チェックボックスメニュー項目、ラジオボタンメニュー項目、ラジオボタングループ、およびサブメニューのみを含めることができます。

一方、Bootstrap のドロップダウンは、汎用的で、さまざまな状況やマークアップ構造に適用できるように設計されています。たとえば、検索フィールドやログインフォームなど、追加の入力やフォームコントロールを含むドロップダウンを作成できます。このため、Bootstrap は、真のARIAメニューに必要なroleおよびaria-属性のいずれも期待 (または自動的に追加) しません。作成者は、これらのより具体的な属性を自分で含める必要があります。

ただし、Bootstrap は.dropdown-item、カーソルキーを使用して個々の要素間を移動し、ESCキーでメニューを閉じる機能など、ほとんどの標準的なキーボードメニュー操作の組み込みサポートを追加します。

例

ドロップダウンのトグル (ボタンまたはリンク) とドロップダウンメニューを.dropdown、またはを宣言する別の要素でラップしposition: relative;ます。<a>ドロップダウンは、または要素からトリガーし<button>て、潜在的なニーズにより適合させることができます。

単一ボタンのドロップダウン

いくつかのマークアップを変更して、任意の単一.btnをドロップダウントグルに変えることができます。<button>どちらの要素でも動作させる方法は次のとおりです。

<div class="dropdown">
  <button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenuButton" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Dropdown button
  </button>
  <div class="dropdown-menu" aria-labelledby="dropdownMenuButton">
    <a class="dropdown-item" href="#">Action</a>
    <a class="dropdown-item" href="#">Another action</a>
    <a class="dropdown-item" href="#">Something else here</a>
  </div>
</div>

そして<a>要素で：

<div class="dropdown show">
  <a class="btn btn-secondary dropdown-toggle" href="#" role="button" id="dropdownMenuLink" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Dropdown link
  </a>

  <div class="dropdown-menu" aria-labelledby="dropdownMenuLink">
    <a class="dropdown-item" href="#">Action</a>
    <a class="dropdown-item" href="#">Another action</a>
    <a class="dropdown-item" href="#">Something else here</a>
  </div>
</div>

最良の部分は、ボタンのバリアントでもこれを実行できることです。

<!-- Example single danger button -->
<div class="btn-group">
  <button type="button" class="btn btn-danger dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Action
  </button>
  <div class="dropdown-menu">
    <a class="dropdown-item" href="#">Action</a>
    <a class="dropdown-item" href="#">Another action</a>
    <a class="dropdown-item" href="#">Something else here</a>
    <div class="dropdown-divider"></div>
    <a class="dropdown-item" href="#">Separated link</a>
  </div>
</div>

分割ボタンのドロップダウン

同様に、単一ボタンドロップダウンと実質的に同じマークアップを使用して分割ボタンドロップダウンを作成しますが.dropdown-toggle-split、ドロップダウンキャレットの周囲に適切なスペースを追加します。

この追加のクラスを使用してpadding、キャレットの両側の水平方向を 25%縮小し、margin-left通常のボタンドロップダウンに追加されたを削除します。これらの追加の変更により、キャレットが分割ボタンの中央に配置され、メインボタンの横により適切なサイズのヒット領域が提供されます。

<!-- Example split danger button -->
<div class="btn-group">
  <button type="button" class="btn btn-danger">Action</button>
  <button type="button" class="btn btn-danger dropdown-toggle dropdown-toggle-split" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    <span class="sr-only">Toggle Dropdown</span>
  </button>
  <div class="dropdown-menu">
    <a class="dropdown-item" href="#">Action</a>
    <a class="dropdown-item" href="#">Another action</a>
    <a class="dropdown-item" href="#">Something else here</a>
    <div class="dropdown-divider"></div>
    <a class="dropdown-item" href="#">Separated link</a>
  </div>
</div>

サイジング

ボタンドロップダウンは、デフォルトのドロップダウンボタンやスプリットドロップダウンボタンなど、あらゆるサイズのボタンで機能します。

<!-- Large button groups (default and split) -->
<div class="btn-group">
  <button class="btn btn-secondary btn-lg dropdown-toggle" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Large button
  </button>
  <div class="dropdown-menu">
    ...
  </div>
</div>
<div class="btn-group">
  <button class="btn btn-secondary btn-lg" type="button">
    Large split button
  </button>
  <button type="button" class="btn btn-lg btn-secondary dropdown-toggle dropdown-toggle-split" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    <span class="sr-only">Toggle Dropdown</span>
  </button>
  <div class="dropdown-menu">
    ...
  </div>
</div>

<!-- Small button groups (default and split) -->
<div class="btn-group">
  <button class="btn btn-secondary btn-sm dropdown-toggle" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Small button
  </button>
  <div class="dropdown-menu">
    ...
  </div>
</div>
<div class="btn-group">
  <button class="btn btn-secondary btn-sm" type="button">
    Small split button
  </button>
  <button type="button" class="btn btn-sm btn-secondary dropdown-toggle dropdown-toggle-split" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    <span class="sr-only">Toggle Dropdown</span>
  </button>
  <div class="dropdown-menu">
    ...
  </div>
</div>

ドロップアップバリエーション

.dropup親要素に追加して、要素の上のドロップダウンメニューをトリガーします。

<!-- Default dropup button -->
<div class="btn-group dropup">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Dropup
  </button>
  <div class="dropdown-menu">
    <!-- Dropdown menu links -->
  </div>
</div>

<!-- Split dropup button -->
<div class="btn-group dropup">
  <button type="button" class="btn btn-secondary">
    Split dropup
  </button>
  <button type="button" class="btn btn-secondary dropdown-toggle dropdown-toggle-split" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    <span class="sr-only">Toggle Dropdown</span>
  </button>
  <div class="dropdown-menu">
    <!-- Dropdown menu links -->
  </div>
</div>

ドロップライトのバリエーション

.dropright親要素に追加して、要素の右側にあるドロップダウンメニューをトリガーします。

<!-- Default dropright button -->
<div class="btn-group dropright">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Dropright
  </button>
  <div class="dropdown-menu">
    <!-- Dropdown menu links -->
  </div>
</div>

<!-- Split dropright button -->
<div class="btn-group dropright">
  <button type="button" class="btn btn-secondary">
    Split dropright
  </button>
  <button type="button" class="btn btn-secondary dropdown-toggle dropdown-toggle-split" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    <span class="sr-only">Toggle Dropright</span>
  </button>
  <div class="dropdown-menu">
    <!-- Dropdown menu links -->
  </div>
</div>

ドロップレフトのバリエーション

.dropleft親要素に追加して、要素の左側にあるドロップダウンメニューをトリガーします。

<!-- Default dropleft button -->
<div class="btn-group dropleft">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Dropleft
  </button>
  <div class="dropdown-menu">
    <!-- Dropdown menu links -->
  </div>
</div>

<!-- Split dropleft button -->
<div class="btn-group">
  <div class="btn-group dropleft" role="group">
    <button type="button" class="btn btn-secondary dropdown-toggle dropdown-toggle-split" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
      <span class="sr-only">Toggle Dropleft</span>
    </button>
    <div class="dropdown-menu">
      <!-- Dropdown menu links -->
    </div>
  </div>
  <button type="button" class="btn btn-secondary">
    Split dropleft
  </button>
</div>

従来、ドロップダウンメニューのコンテンツはリンクでなければなりませんでしたが、v4 ではそうではなくなりました。<button>オプションで、sだけでなく、ドロップダウンで要素を使用できるようになりまし<a>た。

<div class="dropdown">
  <button class="btn btn-secondary dropdown-toggle" type="button" id="dropdownMenu2" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Dropdown
  </button>
  <div class="dropdown-menu" aria-labelledby="dropdownMenu2">
    <button class="dropdown-item" type="button">Action</button>
    <button class="dropdown-item" type="button">Another action</button>
    <button class="dropdown-item" type="button">Something else here</button>
  </div>
</div>

デフォルトでは、ドロップダウンメニューは親の左側に沿って上から 100% の位置に自動的に配置されます。ドロップダウンメニューを右揃え.dropdown-menu-rightにするには、aに追加します。.dropdown-menu

注意喚起！ドロップダウンは、Popper.js のおかげで配置されます (ナビゲーションバーに含まれている場合を除く)。

<div class="btn-group">
  <button type="button" class="btn btn-secondary dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Right-aligned menu
  </button>
  <div class="dropdown-menu dropdown-menu-right">
    <button class="dropdown-item" type="button">Action</button>
    <button class="dropdown-item" type="button">Another action</button>
    <button class="dropdown-item" type="button">Something else here</button>
  </div>
</div>

ヘッダーを追加して、ドロップダウンメニューのアクションのセクションにラベルを付けます。

<div class="dropdown-menu">
  <h6 class="dropdown-header">Dropdown header</h6>
  <a class="dropdown-item" href="#">Action</a>
  <a class="dropdown-item" href="#">Another action</a>
</div>

関連するメニュー項目のグループを仕切りで分けます。

<div class="dropdown-menu">
  <a class="dropdown-item" href="#">Action</a>
  <a class="dropdown-item" href="#">Another action</a>
  <a class="dropdown-item" href="#">Something else here</a>
  <div class="dropdown-divider"></div>
  <a class="dropdown-item" href="#">Separated link</a>
</div>

ドロップダウンメニュー内にフォームを配置するか、フォームをドロップダウンメニューにして、マージンまたはパディングユーティリティを使用して、必要な負のスペースをフォームに与えます。

<div class="dropdown-menu">
  <form class="px-4 py-3">
    <div class="form-group">
      <label for="exampleDropdownFormEmail1">Email address</label>
      <input type="email" class="form-control" id="exampleDropdownFormEmail1" placeholder="[email protected]">
    </div>
    <div class="form-group">
      <label for="exampleDropdownFormPassword1">Password</label>
      <input type="password" class="form-control" id="exampleDropdownFormPassword1" placeholder="Password">
    </div>
    <div class="form-check">
      <input type="checkbox" class="form-check-input" id="dropdownCheck">
      <label class="form-check-label" for="dropdownCheck">
        Remember me
      </label>
    </div>
    <button type="submit" class="btn btn-primary">Sign in</button>
  </form>
  <div class="dropdown-divider"></div>
  <a class="dropdown-item" href="#">New around here? Sign up</a>
  <a class="dropdown-item" href="#">Forgot password?</a>
</div>

<form class="dropdown-menu p-4">
  <div class="form-group">
    <label for="exampleDropdownFormEmail2">Email address</label>
    <input type="email" class="form-control" id="exampleDropdownFormEmail2" placeholder="[email protected]">
  </div>
  <div class="form-group">
    <label for="exampleDropdownFormPassword2">Password</label>
    <input type="password" class="form-control" id="exampleDropdownFormPassword2" placeholder="Password">
  </div>
  <div class="form-check">
    <input type="checkbox" class="form-check-input" id="dropdownCheck2">
    <label class="form-check-label" for="dropdownCheck2">
      Remember me
    </label>
  </div>
  <button type="submit" class="btn btn-primary">Sign in</button>
</form>

.activeドロップダウンのアイテムに追加して、それらをアクティブとしてスタイルします。

<div class="dropdown-menu">
  <a class="dropdown-item" href="#">Regular link</a>
  <a class="dropdown-item active" href="#">Active link</a>
  <a class="dropdown-item" href="#">Another link</a>
</div>

.disabledドロップダウンの項目に追加して、それらを disabled としてスタイルします。

<div class="dropdown-menu">
  <a class="dropdown-item" href="#">Regular link</a>
  <a class="dropdown-item disabled" href="#">Disabled link</a>
  <a class="dropdown-item" href="#">Another link</a>
</div>

使用法

ドロップダウンプラグインは、データ属性または JavaScript を介し.showて、親リスト項目のクラスを切り替えることにより、非表示のコンテンツ (ドロップダウンメニュー) を切り替えます。このdata-toggle="dropdown"属性は、アプリケーションレベルでドロップダウンメニューを閉じるために使用されるため、常に使用することをお勧めします。

タッチ対応デバイスでドロップダウンを開くと、要素の直接の子に空の ( $.noop)ハンドラーが追加されます。この確かに醜いハックは、iOS のイベントデリゲーションの癖を回避するために必要です。そうしないと、ドロップダウンの外側のどこかをタップしても、ドロップダウンを閉じるコードがトリガーされなくなります。ドロップダウンが閉じられると、これらの追加の空のハンドラーは削除されます。mouseover<body>mouseover

データ属性経由

data-toggle="dropdown"リンクまたはボタンに追加して、ドロップダウンを切り替えます。

<div class="dropdown">
  <button id="dLabel" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Dropdown trigger
  </button>
  <div class="dropdown-menu" aria-labelledby="dLabel">
    ...
  </div>
</div>

JavaScript 経由

JavaScript を介してドロップダウンを呼び出します。

$('.dropdown-toggle').dropdown()

`data-toggle="dropdown"`まだ必要

JavaScript を介してドロップダウンを呼び出すか、代わりに data-api を使用するかに関係なく、data-toggle="dropdown"常にドロップダウンのトリガー要素に存在する必要があります。

オプション

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

名前	タイプ	デフォルト	説明
オフセット	数 \| 文字列 \| 関数	0	ターゲットに対するドロップダウンのオフセット。詳細については、Popper.js のオフセットドキュメントを参照してください。
フリップ	ブール値	真実	参照要素が重なっている場合に、ドロップダウンが反転できるようにします。詳細については、Popper.js のフリップドキュメントを参照してください。
境界	文字列 \| エレメント	「スクロール親」	ドロップダウンメニューのオーバーフロー制約境界。`'viewport'`、`'window'`、`'scrollParent'`、または HTMLElement 参照 (JavaScript のみ)の値を受け入れます。詳細については、Popper.js のpreventOverflow docsを参照してください。

boundaryを以外の値に設定する'scrollParent'と、スタイルがコンテナにposition: static適用されることに注意してください。.dropdown

メソッド

方法	説明
`$().dropdown('toggle')`	特定のナビゲーションバーまたはタブ付きナビゲーションのドロップダウンメニューを切り替えます。
`$().dropdown('update')`	要素のドロップダウンの位置を更新します。
`$().dropdown('dispose')`	要素のドロップダウンを破棄します。

イベント

すべてのドロップダウンイベントは.dropdown-menuの親要素で発生しrelatedTarget、トグルアンカー要素を値とするプロパティがあります。

イベント	説明
`show.bs.dropdown`	このイベントは、show インスタンスメソッドが呼び出されるとすぐに発生します。
`shown.bs.dropdown`	このイベントは、ドロップダウンがユーザーに表示されるようになったときに発生します (CSS トランジションが完了するのを待ちます)。
`hide.bs.dropdown`	このイベントは、hide インスタンスメソッドが呼び出されるとすぐに発生します。
`hidden.bs.dropdown`	このイベントは、ドロップダウンがユーザーから非表示にされたときに発生します (CSS トランジションが完了するのを待ちます)。

$('#myDropdown').on('show.bs.dropdown', function () {
  // do something…
})

ドロップダウン

概要

アクセシビリティ

例

単一ボタンのドロップダウン

分割ボタンのドロップダウン

サイジング

ドロップアップバリエーション

ドロップライトのバリエーション

ドロップレフトのバリエーション

メニュー項目

メニューの配置

メニューヘッダー

メニュー仕切り

メニューフォーム

アクティブなメニュー項目

無効なメニュー項目

使用法

データ属性経由

JavaScript 経由

`data-toggle="dropdown"`まだ必要

オプション

メソッド

イベント

ドロップダウン

概要

アクセシビリティ

例

単一ボタンのドロップダウン

分割ボタンのドロップダウン

サイジング

ドロップアップバリエーション

ドロップライトのバリエーション

ドロップレフトのバリエーション

メニュー項目

メニューの配置

メニュー ヘッダー

ドロップダウン ヘッダー

メニュー仕切り

メニューフォーム

アクティブなメニュー項目

無効なメニュー項目

使用法

データ属性経由

JavaScript 経由

data-toggle="dropdown"まだ必要

オプション

メソッド

イベント

メニューヘッダー

ドロップダウンヘッダー

`data-toggle="dropdown"`まだ必要