<select>

HTML <select> 元素表示一个提供选项菜单的控件:

尝试一下

上述例子展示了 <select> 的典型用法。元素中设置了 id 属性以将其与 <label> 元素关联在一起,提高可及性(accessibility)。name 属性表示提交到服务器的相关数据点的名字。每个菜单选项由 <select> 中的一个 <option> 元素定义。

每个 <option> 元素都应该有一个 value 属性,其中包含被选中时需要提交到服务器的数据值。如果不含 value 属性,则 value 值默认为元素中的文本。你可以在 <option> 元素中设置一个 selected 属性以将其设置为页面加载完成时默认选中的元素。

<select> 元素有一些用于控制元素的特有属性,例如 multiple 规定了能不能同时选中多个选项,size 规定了一次性显示多少选项。这个元素也支持大多数常见的表单输入元素属性,如 required, disabled, autofocus 等。

你还可以将 <option> 元素放在 <optgroup> 元素中以为下拉菜单创建不同的选项分组。

原生表单部件 中查看更多示例。

属性

包括下列全局属性

autocomplete

一个 DOMString,为 用户代理 提供自动填充功能的线索。关于该值的完整列表以及如何使用自动填充的详细信息,请参阅 HTML 自动完成属性

autofocus

这个布尔值属性能够让一个对象在页面加载的时候获得焦点。一个文档中只有一个对象可以有这个属性。

disabled

这个布尔值的属性表示用户不能与该表单控件交互。如果没有声明这个属性,则从它的父元素继承,例如 fieldset;如果没有父元素设置了 disabled 属性,那么默认该表单对象可用。

form

<select> 所关联的<form> (它的"表单拥有者")。其值必须是在同一文档中的 <form> 元素的id(如果没有设置这个属性, <select> 元素则与其任何存在的祖先 <form> 元素关联)。 这个属性让你将 <select> 元素与文档中任意位置的 <form> 元素相关联,而不仅仅是包含 <select> 元素的 <form> 元素。这个属性还可以覆盖元素的祖先 <form> 元素。

multiple

这个布尔值属性表示列表中的选项是否支持多选。没有声明该值时,一次只能选中一个选项。声明这个属性后,大多数浏览器都会显示一个可滚动的列表框,而非一个下拉菜单。

name

该属性规定了控件的名称。

required

一个布尔值属性,表示必须选中一个有非空字符串值的选项。

size

如果控件显示为滚动列表框(如声明了 multiple),则此属性表示为控件中同时可见的行数。浏览器不需要将选择元素呈现为滚动列表框。默认值为 0。

备注: 根据 HTML5 规范,默认值应该为 1;但是,在实践中,这样会影响到一些网站,同时其他浏览器也没有那么处理,所以 Mozilla 在 Firefox 中选择继续使用默认值 0。

使用笔记

选择多个选项

在桌面电脑中,有几种方式在设置了 multiple 属性的 <select> 元素中选中多个选项:

鼠标用户可以按住 Ctrl, Command, 或 Shift 键(取决于你的操作系统)然后点击不同选项以选择或取消选择。

警告: 以下所述的通过键盘选择多个不连续选项的方法目前只在 Firefox 有效(译者注:Chrome 81 也已支持)。另请注意:在 macOS 中, Ctrl + UpCtrl + Down 组合键会与系统默认用于任务管理和应用窗口的组合键冲突。所以如果要使用这些组合键,你需要关掉系统默认的组合键。

键盘用户可以这样选中多个连续的选项:

  • 聚焦于 <select> 元素(如使用 Tab
  • 使用 UpDown 方向键以从下向上或从上向下选择选项。
  • 按住 Shift 键然后使用 UpDown 方向键来增加或减少选中的方向。

键盘用户还可以这样选中多个不连续的选项:

  • 聚焦于 <select> 元素(例如使用 Tab )。
  • 按住 Ctrl 键,然后使用 UpDown 方向键来改变聚焦的选项,聚焦的选项使用虚线轮廓高亮,和使用键盘聚焦链接的方式一样。
  • 按下 Space 以选择或取消选择聚焦的选项。

应用 CSS 样式

众所周知,<select>元素很难用 CSS 进行高效的设计。你可以像其他元素一样改变某些方面——例如,调整 盒模型显示的字体 等,你还可以使用 appearance 属性来去除默认的系统外观。

但是,这些属性的表现在不同浏览器之间并不一致,而且有些事情难以很好地处理,例如在一列中顺序排列不同类型的表单元素。 <select>元素的内部结构复杂,难以控制。如果你想完全控制,你应该考虑使用一个在修改表单部件样式方面拥有强大能力的库,或者尝试使用非语义元素和 JavaScript 来制作下拉菜单,再使用 WAI-ARIA 来提供语义。

有关样式<select>的更多有用信息,请参阅:

示例

基本选择

html

<!-- 第二项会默认选中 -->
<select name="select">
  <option value="value1">Value 1</option>
  <option value="value2" selected>Value 2</option>
  <option value="value3">Value 3</option>
</select>

结果

使用多选的进阶选择

下面的例子更加复杂,展示了可用在 <select> 元素上的更多功能:

html

<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 属性,因此不能被选中。

技术概览

内容分类 Flow content, phrasing content, interactive content, listed, labelable, resettable, and submittable form-associated element
允许的内容 Zero or more <option> or <optgroup> elements.
标签省略 不允许,开始标签和结束标签都不能省略。
允许的父元素 Any element that accepts phrasing content.
Implicit ARIA role combobox (en-US) with no multiple attribute and no size attribute greater than 1, otherwise listbox
Permitted ARIA roles menu (en-US) with no multiple attribute and no size attribute greater than 1, otherwise no role permitted
DOM 接口 HTMLSelectElement (en-US)

规范

Specification
HTML Standard
# the-select-element

浏览器兼容性

BCD tables only load in the browser

参见