<select>: HTML 選択要素

試してみましょう

<label for="pet-select">ペットを選択してください:</label>

<select name="pets" id="pet-select">
  <option value="">--1 つ選択してください--</option>
  <option value="dog">犬</option>
  <option value="cat">猫</option>
  <option value="hamster">ハムスター</option>
  <option value="parrot">オウム</option>
  <option value="spider">クモ</option>
  <option value="goldfish">金魚</option>
</select>

label {
  font-family: sans-serif;
  font-size: 1rem;
  padding-right: 10px;
}

select {
  font-size: 0.9rem;
  padding: 2px 5px;
}

上の例は、典型的な <select> の利用方法を示しています。 id 属性を指定して、アクセシビリティのために <label> と関連付けられるようにするとともに、 name 属性を指定して、サーバーに送信されるデータポイントと関連付ける名前を表します。それぞれのメニューの選択肢は、 <select> の中の <option> 要素で定義されます。

それぞれの <option> 要素には、選択肢が選択されたときにサーバーに送信するデータの値を持つ value 属性があります。 value 属性が含まれていない場合は、既定で要素の中に含まれるテキストの値が使用されます。 selected 属性を<option> 要素に付けることで、ページが最初に読み込まれたときに既定で選択状態にすることができます。 selected 属性が指定されていない場合、最初の <option> 要素が既定で選択されます。

<select> 要素は JavaScript では HTMLSelectElement オブジェクトで表され、このオブジェクトの value プロパティは、選択された <option> の値を持っています。

<select> 要素は、複数の選択肢を選択することができるかどうかを定める multiple、同時にいくつの選択肢を表示することができるかを定める size など、制御のために利用することができる固有の属性がいくつかあります。 required、disabled、autofocus などのような一般のフォーム入力属性の多くも受け付けます。

さらに、 <option> 要素を <optgroup> 要素の中に入れることで、ドロップダウンの中で選択肢をグループに分割することができます。また、<hr> 要素を含めることで、選択肢間に視覚的な区切りを追加することができます。

その他の例は、ネイティブフォームウィジェット: ドロップダウンコンテンツを参照してください。

属性

この要素にはグローバル属性があります。

autocomplete

文字列で、ユーザーエージェントの自動補完機能のヒントを提供します。値の完全なリストや自動補完の使い方の詳細は、 HTML の autocomplete 属性を参照してください。

autofocus

論理属性で、ページが読み込まれた時にこのフォームコントロールが入力フォーカスを持つべきであることを指定することができます。文書内で autofocus 属性を持つことができるフォーム要素は一つだけです。

disabled

論理属性で、ユーザーがそのコントロールを利用することができないことを示します。もしこの属性が指定されていない場合、コントロールはその設定を親要素、例えば <fieldset> 要素から継承します。もし親要素に disabled 属性を持つものがなければ、そのコントロールは利用可能です。

form

この <select> を関連付ける <form> 要素（フォームオーナー）です。この属性の値は、同じ文書内の <form> 要素の id でなければなりません。（この属性が設定されていない場合は、 <select> はその祖先である <form> が存在すれば、それと関連付けられます。）

この属性によって、 <select> 要素は、 <form> 要素の子孫に限らず、文書内のどこの <form> と結び付けることもできます。これは祖先の <form> を上書きすることもできます。

multiple

論理属性で、リストの複数の選択肢を選択することができることを示します。指定されていない場合は、一度に選択することができる選択肢は一つだけです。 multiple が指定されている場合、多くのブラウザーは単一行のドロップダウンの代わりに、スクロールするリストボックスを表示します。複数選択された選択肢は、 URLSearchParams の配列の規約、つまり name=value1&name=value2 の形式を使用して送信されます。

name

この属性は、コントロールの名前を指定するために使用します。

required

論理属性で、空ではない文字列の値の選択肢を選択しなければならないことを示します。

size

コントロールがスクロールするリストボックスとして表示される場合（つまり、 multiple が指定されている場合）、この属性は一度に見えるべきリストの行数を表します。ブラウザーは、 select 要素をスクロールリストボックスとして提供する必要はありません。既定値は 0 です。

メモ: HTML 仕様書によると、 size 属性の初期値は 1 であるべきとされています。しかしながら、実際のところは、このことによっていくつかのウェブサイトを壊してしまうことがわかり、他のブラウザーでも現在そうしているものはなく、 Mozilla は当分の間、 Firefox でも 0 を返し続けることを選択しました。

使用上の注意

複数の選択肢の選択

デスクトップコンピューターでは、 <select> 要素に multiple 属性がついている場合に、複数の選択肢を選択する方法がいくつもあります。

マウスを使用すると、 Ctrl、Command、Shift キー（オペレーティングシステムによって異なります）を押しながらクリックすることで、複数の選択肢を選択または解除することができます。

キーボードを使用して、連続した複数の選択肢を選択するには以下のようにします。

• <select> 要素にフォーカスを移動します（例えば Tab を使用して）。
• ↑ および ↓ のカーソルキーを使用して、項目を上下に移動し、選択したい範囲の先頭または末尾の項目を選択する。
• Shift キーを押したまま ↑ および ↓ のカーソルキーを使用して、項目を選択する範囲を増加または減少させる。

キーボードを使用して、連続していない複数の選択肢を選択するには以下のようにします。

• <select> 要素にフォーカスを移動します（例えば Tab を使用するなど）。
• Ctrl キーを押したまま ↑ および ↓ のカーソルキーを使用して選択肢の「フォーカス」を移動します。つまり、選択したいものに移動します。「フォーカス」のある選択肢は、キーボードでリンクをフォーカスしたときと同様に、点線の輪郭線で強調されます。
• スペース を押して「フォーカス」のある選択肢を選択または解除します。

CSS によるスタイル設定

<select> 要素は、従来は CSS を使って生産的にスタイル設定することが困難であったため、完全にカスタマイズ可能な select 要素が作成できる機能が導入されつつあります。

従来の select のスタイル設定

最新のカスタマイズ機能に対応していないブラウザー（またはそれらを使用できない古いコードベース）では、ボックスモデルや表示されるフォントの操作に限定されています。 appearance プロパティを使用して、システムの既定の appearance を削除することもできます。

しかし、従来の <select> 要素では、ブラウザー間で一貫した結果を得ることは困難です。完全に制御したいのであれば、スタイル設定をするのに優れた機能を備えたライブラリーを使用するか、非意味的要素や JavaScript や WAI-ARIA を使用して独自のドロップダウンメニューを実装することを検討してください。

:open 擬似クラスを使用することで、 <select> 要素が開いた状態（つまり選択肢のドロップダウンリストが表示されている状態）のスタイルを設定できます。これは複数行の <select> 要素（multiple 属性が設定されているもの）には適用されません。これらはドロップダウンではなくスクロール可能なリストボックスとしてレンダリングされる傾向があるため、開いた状態がありません。

<select> のスタイル設定についての従来の情報は、以下を参照してください。

• HTML フォームのスタイル設定
• HTML フォームの高度なスタイル設定
• field-sizing プロパティは、 <select> 要素が格納する選択肢との相対的なサイズを決めるかを制御します。

アクセシビリティ

<select> 内の <hr> は、純粋に装飾的なものとみなすべきです。なぜなら、現在、アクセシビリティツリー内に公開されておらず、支援技術にも公開されていないからです。

例

基本的な select

以下の例では、 3 つの選択肢があるドロップダウンメニューを生成し、既定で 2 番目の選択肢を選択状態にしておきます。

<!-- 最初に 2 番目の値が選択されます。 -->
<select name="choice">
  <option value="first">1 番目の値</option>
  <option value="second" selected>2 番目の値</option>
  <option value="third">3 番目の値</option>
</select>

結果

グループ化された選択肢のある select

次の例では、ドロップダウンメニューをグループ化つきで作成し、<optgroup> と <hr> を使用して、ドロップダウン内のコンテンツをユーザーが理解しやすくしています。

<label for="hr-select">好きな食べ物</label> <br />

<select name="foods" id="hr-select">
  <option value="">食べ物を選んでください</option>
  <hr />
  <optgroup label="果物">
    <option value="apple">りんご</option>
    <option value="banana">バナナ</option>
    <option value="cherry">さくらんぼ</option>
    <option value="damson">ダムソンプラム</option>
  </optgroup>
  <hr />
  <optgroup label="野菜">
    <option value="artichoke">アーティチョーク</option>
    <option value="broccoli">ブロッコリー</option>
    <option value="cabbage">キャベツ</option>
  </optgroup>
  <hr />
  <optgroup label="肉">
    <option value="beef">牛肉</option>
    <option value="chicken">鶏肉</option>
    <option value="pork">豚肉</option>
  </optgroup>
  <hr />
  <optgroup label="魚">
    <option value="cod">タラ</option>
    <option value="haddock">コダラ</option>
    <option value="salmon">鮭</option>
    <option value="turbot">カレイ</option>
  </optgroup>
</select>

結果

高度な複数選択の機能

以下の例はもっと複雑で、 <select> 要素で使用できる機能をもっと示しています。

<label>
  1 つ以上のペットを選択してください:
  <select name="pets" multiple size="4">
    <optgroup label="4 本足のペット">
      <option value="dog">犬</option>
      <option value="cat">猫</option>
      <option value="hamster" disabled>ハムスター</option>
    </optgroup>
    <optgroup label="飛ぶペット">
      <option value="parrot">オウム</option>
      <option value="macaw">インコ</option>
      <option value="albatross">アホウドリ</option>
    </optgroup>
  </select>
</label>

結果

次のことが分かるでしょう。

• multiple 属性を設定してあるので、複数の選択肢を選択することができます。
• size 属性は、同時に 4 行だけ表示できるようにします。スクロールしてすべての選択肢を表示することができます。
• <optgroup> を入れることで、選択肢を複数のグループに分割しています。これは純粋に視覚的なグループ化であり、視覚表現は通常、太字のグループ名と字下げした選択肢で構成されます。
• "Hamster" の選択肢には disabled 属性が設定されているので、選択することができません。

技術的概要

仕様書

ブラウザーの互換性

関連情報

• <select> で発生するイベント: change, input
• <option> 要素
• <optgroup> 要素
• カスタマイズ可能な select 要素