<select>: HTML 選択要素
HTML の <select>
要素は、選択式のメニューを提供するコントロールを表します。
試してみましょう
上のデモは、典型的な <select>
の利用方法を示しています。アクセシビリティのために、 <label>
と結び付けられるように id
属性が与えられています。それぞれのメニューの選択肢は、 <select>
の中の <option>
要素で定義されています。
<option>
要素は、選択肢が選択されたときにサーバーに送信するデータの値を含む value
属性を持ちます。 value
属性が含まれない場合、既定で要素の中に含まれるテキストの値が使用されます。 <option>
要素に selected
属性を付けることで、ページが最初に読み込まれたときに既定で選択状態にすることができます。
<select>
要素は、複数の選択肢を選択することができるかどうかを定める multiple
、同時にいくつの選択肢を表示することができるかを定める size
など、制御のために利用することができる固有の属性がいくつかあります。 required
, disabled
, autofocus
, などのような一般のフォーム入力属性の多くも受け付けます。
さらに、 <option>
要素を <optgroup>
要素の中に入れることで、ドロップダウンの中で選択肢をグループに分割することができます。
その他の例は、ネイティブフォームウィジェット: ドロップダウンコンテンツを参照してください。
属性
この要素はグローバル属性を持ちます。
autocomplete
-
DOMString
で、ユーザーエージェントの自動補完機能のヒントを提供します。値の完全なリストや自動補完の使い方の詳細は、 HTML の autocomplete 属性を参照してください。 autofocus
-
真偽値属性で、ページが読み込まれた時にこのフォームコントロールが入力フォーカスを持つべきであることを指定することができます。文書内で
autofocus
属性を持つことができるフォーム要素は一つだけです。 disabled
-
真偽値属性で、ユーザーがそのコントロールを利用することができないことを示します。もしこの属性が指定されていない場合、コントロールはその設定を親要素、例えば
<fieldset>
要素から継承します。もし親要素にdisabled
属性を持つものがなければ、そのコントロールは利用可能です。 form
-
<select>
を関連付ける<form>
要素 (フォームオーナー) です。この属性の値は、同じ文書内のform
要素のid
でなければなりません。 (この属性が設定されていない場合は、<select>
はその祖先である<form>
が存在すればそれと関連付けられます。)この属性によって、
<select>
要素は、<form>
要素の子孫に限らず、文書内のどこの<form>
と結び付けることもできます。これは祖先の<form>
を上書きすることもできます。 multiple
-
真偽値属性で、リストの複数の選択肢を選択することができることを示します。指定されていない場合は、一度に選択することができる選択肢は一つだけです。
multiple
が指定されている場合、多くのブラウザーは単一行のドロップダウンの代わりに、スクロールするリストボックスを表示します。 name
-
この属性は、コントロールの名前を指定するために使用します。
required
-
真偽値属性で、空ではない文字列の値の選択肢を選択しなければならないことを示します。
size
-
コントロールがスクロールするリストボックスとして表示される場合 (つまり、
multiple
が指定されている場合)、この属性は一度に見えるべきリストの行数を表します。ブラウザーは、 select 要素をスクロールリストボックスとして提供する必要はありません。既定値は0
です。メモ: HTML5 の仕様によると、 size 属性の初期値は
1
であるべきとされています。しかしながら、実際のところは、このことによっていくつかのウェブサイトを壊してしまうことがわかり、他のブラウザーでも現在そうしているものはなく、 Mozilla は当分の間、 Firefox でも0
を返し続けることを選択しました。
使用上の注意
複数の項目の選択
デスクトップコンピューターでは、 <select>
要素に multiple
属性がついている場合に、複数の項目を選択する方法がいくつもあります。
マウスを使用すると、 Ctrl, Command, Shift キー (オペレーティングシステムによって異なります) を押しながらクリックすることで、複数の項目を選択または解除することができます。
警告: キーボードから連続していない複数の項目を選択する仕組みは、今のところ Firefox でしか動作しないようです。
注: macOS では、 Ctrl + ↑ および Ctrl + ↓ のショートカットが、 OS 既定の Mission Control および Application windows のショートカットと競合するため、動作させるためにはこれらをオフにしなければならないでしょう。
キーボードを使用して、連続した複数の項目を選択するには以下のようにします。
-
<select>
要素にフォーカスを移動します。 (例えば Tab を使用するなど)。 - ↑ および ↓ のカーソルキーを使用して、項目を上下に移動し、選択したい範囲の先頭または末尾の項目を選択する。
- Shift キーを押したまま ↑ および ↓ のカーソルキーを使用して、項目を選択する範囲を増加または減少させる。
キーボードを使用して、連続していない複数の項目を選択するには以下のようにします。
-
<select>
要素にフォーカスを移動します。 (例えば Tab を使用するなど)。 - Ctrl キーを押したまま ↑ および ↓ のカーソルキーを使用して「フォーカスのある」選択肢を、選択したいものに移動します。「フォーカスのある」選択肢は、キーボードでリンクをフォーカスしたときと同様に、点線の輪郭線で強調されます。
- スペース を押して「フォーカスのある」選択肢を選択または解除します。
CSS のスタイル付け
<select>
要素は、 CSS を使って生産的にスタイル付けすることが困難です。他の要素のように、特定の側面で影響を与えることはできます。 — 例えば、ボックスモデルや表示されるフォントを操作する、 appearance
プロパティを使用してシステムの既定の appearance
を削除することができます。
しかし、これらのプロパティはブラウザー間で一貫した結果が得られませんし、異なる種類のフォーム要素を互いに一列に並べたりするのは困難なことです。 <select>
要素の内部構造は複雑で、制御するのは困難です。完全に制御したいのであれば、スタイル付けをするのに優れた機能を備えたライブラリを使用するか、非意味的要素や JavaScript や WAI-ARIA をを使用して独自のドロップダウンメニューを実装することを検討してください。
<select>
のスタイル付けについてのさらなる有益な情報は、以下を参照してください。
Also see the "Customizing select styles" example below for an example of you could attempt a simple <select>
styling.
例
基本的な select
以下の例では、とても簡単なドロップダウンメニューを生成し、既定で第二の選択肢を選択状態にしておきます。
<!-- 最初に Second Value が選択されます。 -->
<select name="choice">
<option value="first">First Value</option>
<option value="second" selected>Second Value</option>
<option value="third">Third Value</option>
</select>
高度な複数選択の機能
以下の例はもっと複雑で、 <select>
要素で使用できる機能をもっと示しています。
<label>Please choose one or more pets:
<select name="pets" multiple size="4">
<optgroup label="4-legged pets">
<option value="dog">Dog</option>
<option value="cat">Cat</option>
<option value="hamster" disabled>Hamster</option>
</optgroup>
<optgroup label="Flying pets">
<option value="parrot">Parrot</option>
<option value="macaw">Macaw</option>
<option value="albatross">Albatross</option>
</optgroup>
</select>
</label>
次のことが分かるでしょう。
multiple
属性を入れてあるので、複数のオプションを選択することができます。size
属性は、同時に 4 行だけ表示できるようにします。スクロールしてすべての選択肢を表示することができます。<optgroup>
を入れることで、選択肢を複数のグループに分割しています。これは純粋に視覚的なグループ化であり、視覚表現は通常、太字のグループ名と字下げした選択肢で構成されます。- "Hamster" の選択肢には
disabled
属性が入っているので、選択することができません。
select のスタイルのカスタマイズ
この例では、 CSS と JavaScript を使用して <select>
ボックスに広範な独自スタイルを適用する方法を示しています。
この例では基本的に以下のことを行います。
- 親ラッパーの
<select>
のコンテキスト (<option>
}) を複製し、追加の HTML 要素と JavaScript を使用して標準の期待される動作を再実装します。これには、キーボードアクセシビリティを提供するための基本的なタブの動作が含まれます。 - 状態と CSS を管理するために、いくつかの標準ネイティブの
属性
を新しい要素のdata-attributes
に対応付けします。
メモ: すべてのネイティブ機能をサポートしているわけではありません。これは標準的な HTML から始まりますが、 JSON データ、カスタム HTML、または他のソリューションから始めても同じ結果を得ることができます。
HTML
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Select</title>
</head>
<body>
<form>
<fieldset>
<legend>Standard controls</legend>
<select
name=1A
id=select
autocomplete=off
required
>
<option>Carrots</option>
<option>Peas</option>
<option>Beans</option>
<option>Pneumonoultramicroscopicsilicovolcanoconiosis</option>
</select>
<label for="1B">1B</label>
<select name="1B" multiple size="4" required>
<optgroup label="4-legged pets">
<option value="dog">Dog</option>
<option value="cat">Cat</option>
<option value="hamster" disabled>Hamster</option>
</optgroup>
<optgroup label="Flying pets">
<option value="parrot">Parrot</option>
<option value="macaw">Macaw</option>
<option value="albatross">Albatross</option>
</optgroup>
<option value="albatross">Albatross</option>
</select>
<label for="1C">1C</label>
<select name="1C" required>
<option value="first">First Value</option>
<option value="second" selected>Second Value</option>
<option value="third">Third Value</option>
</select>
</fieldset>
<fieldset id=custom>
<legend>Custom controls</legend>
<select
name="2A"
id="select"
autocomplete="off"
required
>
<option>Carrots</option>
<option>Peas</option>
<option>Beans</option>
<option>Pneumonoultramicroscopicsilicovolcanoconiosis</option>
</select>
<label for=2B>2B</label>
<select id=2B name="2B" multiple size="4" required>
<optgroup label="4-legged pets">
<option value="dog">Dog</option>
<option value="cat">Cat</option>
<option value="hamster" disabled>Hamster</option>
</optgroup>
<optgroup label="Flying pets">
<option value="parrot">Parrot</option>
<option value="macaw">Macaw</option>
<option value="albatross">Albatross</option>
</optgroup>
</select>
<label for="2C">2C</label>
<select name="2C" required>
<option value="first">First Value</option>
<option value="second" selected>Second Value</option>
<option value="third">Third Value</option>
</select>
</fieldset>
<button type="reset">Reset</button>
<button type="submit">Submit</button>
</form>
<code id=submit></code>
<link rel=stylesheet href=style.css>
<script src="script.js"></script>
</body>
</html>
CSS
body {
font-family: Cambria, Cochin, Georgia, Times, 'Times New Roman', serif
}
.select:focus {
border-color: blue;
}
html body form fieldset#custom div.select[data-multiple] div.header {
display: none;
}
html body form fieldset#custom div.select div.header {
content: '↓';
display: -webkit-inline-box;
display: -ms-inline-flexbox;
display: inline-flex;
-webkit-box-align: center;
-ms-flex-align: center;
align-items: center;
padding: 0;
position: relative;
}
html body form fieldset#custom div.select div.header::after {
content: '↓';
align-self: stretch;
display: flex;
align-content: center;
justify-content: center;
justify-items: center;
align-items: center;
padding: .5em;
}
html body form fieldset#custom div.select div.header:hover:after {
background-color: blue;
}
.select .header select {
-webkit-appearance: none;
-moz-appearance: none;
appearance: none;
font-family: inherit;
font-size: inherit;
padding: 0;
border-width: 0;
width: 100%;
flex: 1;
display: none;
}
.select .header select optgroup {
display: none;
}
.select select div.option {
display: none;
}
html body form fieldset#custom div.select {
user-select: none;
box-sizing: border-box;
position: relative;
border-radius: 4px;
border-style: solid;
border-width: 0;
border-color: gray;
width: auto;
display: inline-block;
}
html body form fieldset#custom div.select:focus {
border-color: blue;
}
html body form fieldset#custom div.select:hover {
border-color: blue;
}
html body form fieldset#custom div.select[data-open] {
border-bottom-left-radius: 0;
border-bottom-right-radius: 0;
}
html body form fieldset#custom div.select[data-open] datalist {
display: initial;
}
html body form fieldset#custom div.select datalist {
-webkit-appearance: none;
-moz-appearance: none;
appearance: none;
position: absolute;
border-style: solid;
border-width: 1px;
border-color: gray;
left: 0;
display: none;
width: 100%;
box-sizing: border-box;
z-index: 2;
border-bottom-left-radius: 4px;
border-bottom-right-radius: 4px;
}
html body form fieldset#custom div.select datalist div.option {
background-color: white;
margin-bottom: 1px;
cursor: pointer;
padding: 0.5em;
border-width: 0;
}
html body form fieldset#custom div.select datalist div.option:hover {
background-color: blue;
color: white;
}
html body form fieldset#custom div.select datalist div.option:focus {
background-color: blue;
color: white;
}
html body form fieldset#custom div.select datalist div.option:checked {
background-color: blue;
color: white;
}
html body form fieldset#custom div.select div.optgroup div.option[data-disabled] {
color: gray;
}
html body form fieldset#custom div.select div.optgroup div.option[data-checked] {
background-color: blue;
color: white;
}
html body form fieldset#custom div.select div.optgroup div.label {
font-weight: bold;
}
html body form fieldset#custom div.select div.optgroup div.option div.label {
font-weight: normal;
padding: .25em;
}
html body form fieldset#custom div.select div.header {
flex: 1;
display: flex;
width: auto;
box-sizing: border-box;
border-width: 1px;
border-style: inherit;
border-color: inherit;
border-radius: inherit;
}
html body form fieldset#custom div.select div.header span {
flex: 1;
padding: .5em;
}
JavaScript
const selects = custom.querySelectorAll('select');
for (const select of selects) {
const div = document.createElement('div');
const header = document.createElement('div');
const datalist = document.createElement('datalist');
const optgroups = select.querySelectorAll('optgroup');
const span = document.createElement('span');
const options = select.options;
const parent = select.parentElement;
const multiple = select.hasAttribute('multiple');
const onclick = function(e) {
const disabled = this.hasAttribute('data-disabled');
select.value = this.dataset.value;
span.innerText = this.dataset.label;
if (disabled) return;
if (multiple) {
if (e.shiftKey) {
const checked = this.hasAttribute("data-checked");
if (checked) {
this.removeAttribute("data-checked");
} else {
this.setAttribute("data-checked", "");
};
} else {
const options = div.querySelectorAll('.option');
for (i = 0; i < options.length; i++) {
const option = options[i];
option.removeAttribute("data-checked");
};
this.setAttribute("data-checked", "");
};
};
};
const onkeyup = function(e) {
e.preventDefault();
e.stopPropagation();
if (e.keyCode === 13) {
this.click();
}
};
div.classList.add('select');
header.classList.add('header');
div.tabIndex = 1;
select.tabIndex = -1;
span.innerText = select.label;
header.appendChild(span);
for (attribute of select.attributes) div.dataset[attribute.name] = attribute.value;
for (i = 0; i < options.length; i++) {
const option = document.createElement('div');
const label = document.createElement('div');
const o = options[i];
for (attribute of o.attributes) option.dataset[attribute.name] = attribute.value;
option.classList.add('option');
label.classList.add('label');
label.innerText = o.label;
option.dataset.value = o.value;
option.dataset.label = o.label;
option.onclick = onclick;
option.onkeyup = onkeyup;
option.tabIndex = i + 1;
option.appendChild(label);
datalist.appendChild(option);
}
div.appendChild(header);
for (o of optgroups) {
const optgroup = document.createElement('div');
const label = document.createElement('div');
const options = o.querySelectorAll('option');
Object.assign(optgroup, o);
optgroup.classList.add('optgroup');
label.classList.add('label');
label.innerText = o.label;
optgroup.appendChild(label);
div.appendChild(optgroup);
for (o of options) {
const option = document.createElement('div');
const label = document.createElement('div');
for (attribute of o.attributes) option.dataset[attribute.name] = attribute.value;
option.classList.add('option');
label.classList.add('label');
label.innerText = o.label;
option.tabIndex = i + 1;
option.dataset.value = o.value;
option.dataset.label = o.label;
option.onclick = onclick;
option.onkeyup = onkeyup;
option.tabIndex = i + 1;
option.appendChild(label);
optgroup.appendChild(option);
};
};
div.onclick = function(e) {
e.preventDefault();
}
parent.insertBefore(div, select);
header.appendChild(select);
div.appendChild(datalist);
datalist.style.top = header.offsetTop + header.offsetHeight + 'px';
div.onclick = function(e) {
if (multiple) {
} else {
const open = this.hasAttribute("data-open");
e.stopPropagation();
if (open) {
this.removeAttribute("data-open");
} else {
this.setAttribute("data-open", "");
}
}
};
div.onkeyup = function(event) {
event.preventDefault();
if (event.keyCode === 13) {
this.click();
}
};
document.addEventListener('click', function(e) {
if (div.hasAttribute("data-open")) div.removeAttribute("data-open");
});
const width = Math.max(...Array.from(options).map(function(e) {
span.innerText = e.label;
return div.offsetWidth;
}));
console.log(width)
div.style.width = width + 'px';
}
document.forms[0].onsubmit = function(e) {
const data = new FormData(this);
e.preventDefault();
submit.innerText = JSON.stringify([...data.entries()]);
}
Result
技術的概要
コンテンツカテゴリ | フローコンテンツ、記述コンテンツ、対話型コンテンツ、リスト化、ラベル付け可能、リセット可能、及びサブミット可能なフォーム関連要素 |
---|---|
許可されている内容 |
0 個以上の <option> 要素または
<optgroup> 要素
|
タグの省略 | 不可。開始と終了タグの両方が必要。 |
許可されている親要素 | 記述コンテンツを受け入れるすべての要素 |
暗黙の ARIA ロール |
multiple 属性がなく、 1 よりも大きい
size 属性がないならば
combobox (en-US) 、それ以外の場合は
listbox
|
許可されている ARIA ロール |
multiple 属性がなく、 1 よりも大きい
size 属性がないならば
menu (en-US) 、それ以外の場合は許可されている
role はなし
|
DOM インターフェイス | HTMLSelectElement |
仕様書
Specification |
---|
HTML Standard # the-select-element |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
<select>
で発生するイベント:change
,input
<option>
要素<optgroup>
要素