：输入（表单输入）元素 - HTML（超文本标记语言）

>水果：

form 属性可以让你在文档的任何地方放置一个输入控件，但在文档的其他地方包含一个表单。

备注：

一个输入只能与一个表单相关。

formaction

仅对 image 和 submit 输入类型有效。参见 submit 输入类型介绍以获得更多信息。

formenctype

仅对 image 和 submit 输入类型有效。参见 submit 输入类型介绍以获得更多信息。

formmethod

仅对 image 和 submit 输入类型有效。参见 submit 输入类型介绍以获得更多信息。

formnovalidate

仅对 image 和 submit 输入类型有效。参见 submit 输入类型介绍以获得更多信息。

formtarget

仅对 image 和 submit 输入类型有效。参见 submit 输入类型介绍以获得更多信息。

height

仅对 image 输入按钮有效。height 是要显示代表图形提交按钮的图片的高度。参见 image。

id

全局属性对所有元素有效，包括所有的输入类型，它定义了一个唯一的标识符（ID），在整个文档中必须是唯一的。其目的是为了在链接时识别该元素。该值被用作 的 for 属性的值，以便将标签与表单控件连接起来。参见 。

inputmode

对所有元素都有效的全局值，它为浏览器提供了一个提示，说明在编辑这个元素或其内容时要使用的虚拟键盘配置类型。值包括 none、text、tel、url、email、numeric、decimal 和 search。

list

给予 list 属性的值应该是位于同一文档中的

在 text、search、url、tel、email、date、month、week、time、datetime-local、number、range 和 color 上均有效。

根据规范，hidden、password、checkbox、radio、file 或任何按钮类型不支持 list 属性。

根据浏览器的不同，用户可能会看到一个建议的自定义调色板、沿着一个范围的跳动标记、甚至是一个像选择一样打开但允许非列表值的输入。查看浏览器兼容性表，了解其他输入类型。

参见

max

对 date、month、week、time、datetime-local、number 和 range 输入类型有效，定义了允许值范围内的最大值。如果输入到元素中的 value 超过此值，则该元素将无法通过约束验证。如果 max 属性的值不是数字，则元素没有最大值。

有一种特殊情况：如果数据类型是周期性的（如日期或时间），max 的值可能低于 min 的值，这表明范围可以环绕；例如，这允许你指定一个从晚上 10 点到凌晨 4 点的时间范围。

maxlength

对 text、search、url、tel、email 和 password 类型有效。它定义了用户可以输入到该字段中的最大字符数（以 UTF-16 码点为单位）。必须为大于等于 0 的整数。如果未指定 maxlength 或指定了无效的值，则该字段将没有最大值。这个值也必须大于等于 minlength 的值。

如果文本框中的字符数大于 maxlength UTF-16 编码单元长度，则输入将无法通过约束验证。默认情况下，浏览器将阻止用户输入超过 maxlength 属性所指定的值的字符。参见客户端验证一节以了解更多信息。

min

对 date、month、week、time、datetime-local、number 和 range 输入类型有效，定义了允许值范围内的最小值。如果输入到元素的 value 小于此值，则该元素将无法通过约束验证。如果 min 指定的值不是数字，则输入没有最小值。

该值必须小于或等于 max 属性的值。如果 min 属性存在但没有指定或无效，则不应用 min 值。如果 min 属性有效，并且非空值小于 min 属性所允许的最小值，约束验证将阻止表单提交。参见客户端验证一节以获取更多信息。

有一种特殊情况：如果数据类型是周期性的（如日期或时间），min 的值可能高于 max 的值，这表明范围可以环绕；例如，这允许你指定一个从晚上 10 点到凌晨 4 点的时间范围。

minlength

对 text、search、url、tel、email 和 password 类型有效。它定义了用户可以输入到该字段中的最小字符数（以 UTF-16 码点为单位）。该值必须是小于等于 maxlength 指定的值的非负整数值。如果未指定 minlength 或指定了无效的值，则该字段将没有最小值。

如果输入字段的文本长度小于 minlength UTF-16 代码单元的长度，输入将无法通过约束验证，阻止表单提交。参见客户端验证一节以了解更多信息。

multiple

如果设置了布尔值 multiple 属性，意味着用户可以在电子邮件部件中输入逗号分隔的电子邮件地址，或者可以通过 file 输入选择多个文件。参见 email 和 file 输入类型。

name

一个指定输入控件名称的字符串。当表单数据被提交时，这个名字会和控件的值一起提交。

通常把 name 看作是一个必需的属性（即使它不是）。如果一个输入没有指定 name，或者 name 是空的，那么这个输入的值就不会和表单一起提交！禁用的控件、未选中的单选按钮、未选中的复选框和重置按钮也不会被发送。

考虑这两个特殊情况：

_charset_：如果被用作 hidden 类型的 元素的名称，该输入的 value 会被用户代理自动设置为提交表单时使用的字符编码。

isindex：由于历史原因，不允许使用 isindex 这个名字。

name 属性对单选按钮的行为完全不同。

在一个同名的单选按钮组中，一次只能选中一个单选按钮。选择该组中的任何一个单选按钮会自动取消对同一组中当前被选中的单选按钮的选择。如果表单被提交，这一个被选中的单选按钮的值会和名称一起被发送。

当标签进入一系列同名的单选按钮组时，如果有一个被选中，将聚焦该单选按钮。如果它们没有按源顺序分组，如果组中有一个被选中，当遇到组中的第一个时，标签进入组开始，跳过所有没有选中的。换句话说，如果有一个被选中，标签就会跳过该组中未被选中的单选按钮。如果没有勾选，当到达同名组中的第一个按钮时，就会聚焦该单选按钮组。

一旦组中的一个单选按钮有了焦点，使用箭头键将浏览所有同名的单选按钮，即使这些单选按钮在源顺序中没有被分组。

如果一个输入元素具有 name，该名称成为包含它的表单元素的 HTMLFormElement.elements 属性。如果有两个 name 分别设置为 guest 和 hat-size 的输入元素，可以使用如下代码：

jslet form = document.querySelector("form");

let guestName = form.elements.guest;

let hatSize = form.elements["hat-size"];

此段代码运行后，guestName 将成为 guest 字段的 HTMLInputElement，hatSize 将成为 hat-size 字段的 HTMLInputElement。

警告：

避免给表单元素一个与表单内置属性相对应的 name，因为这样你就会用这个对相应输入的引用来覆盖预定义的属性或方法。

pattern

对 text、search、url、tel、email 和 password 类型有效。为了使 value 通过约束验证，必须满足 pattern 属性给定的正则表达式。它必须是 RegExp 类型的有效 JavaScript 正则表达式，并且已在我们的正则表达式指南中进行了说明；在编译正则表达式时指定了 'u' 标志，因此该模式被视为 Unicode 代码点的序列，而不是 ASCII。模式文本周围无需指定正斜杠。

如果 pattern 属性存在，但是未指定模式或无效，则不应用任何正则表达式，并且将完全忽略此属性。如果模式属性是有效的，并且该非空值与模式不匹配，约束验证将阻止表单提交。

备注：

如果使用了 pattern 属性，要在附近告知用户所期望的输入格式。你可以包含 title 属性来解释满足模式的需求说明，大多数浏览器将它们显示为工具提示（tooltip）。对于无障碍来说，视觉的解释是必要的，工具提示是一种改进点。

参见客户端验证一节以了解更多信息。

placeholder

对 text、search、url、tel、email、password 和 number 有效。placeholder 属性可向用户提供有关该字段中需要什么样的信息的简短提示。它应该是一个单词或短语来说明预期的数据类型，而不是说明性消息。文本中不得包含回车符或换行符。例如，某个字段需要收集用户的姓氏，其标签为“First Name”，一个适合的占位文字可能是“如 Mustafa”。

备注：

placeholder 属性在语义上不如其他解释表单的方式有用，而且会对你的内容造成意想不到的技术问题。参见标签以获得更多信息。

readonly

一个布尔属性，如果存在，则表示该字段不能由用户编辑。readonly 属性支持 text、search、url、tel、email、date、month、week、time、datetime-local、number 和 password 输入类型。

参见 HTML 属性：readonly 以了解更多信息。

required

required 是一个布尔属性，如果存在，则表示用户必须在提交表单之前指定一个非空值。required 属性支持 text、search、url、tel、email、date、month、week、time、datetime-local、number、password、checkbox、radio 和 file 输入类型。

参见客户端验证和 HTML 属性：required以了解更多信息。

size

对 email、password、tel、url 和 text 有效。size 属性指示显示输入控件的多少。基本上创建了与设置 CSS width属性相同的结果，但有一些特殊性，值的具体单位取决于输入类型。对于 password 和 text，它是字符数量（或 em 单位大小），默认值是 20。对于其他情况，是像素值（或 px 单位大小）。CSS width 的优先级会高于 size 属性。

src

仅对 image 输入按钮有效。指定将要在提交按钮上显示的图像的 URL。参见 image 输入类型。

step

对 date、month、week、time、datetime-local、number 和 range 输入类型有效。step 属性指定了值必须满足的粒度。

如果没有明确包含它：

step 对于类型为 number 和 range 的默认值为 1。

每一种日期/事件输入类型有一个适合的默认 step 值，请查阅相关的页面以获取：date、datetime-local、month、time 和 week。

值必须为一个正数（整数或小数）或特殊值 any（意味着不指定任何步进值，任意值都可以接受（除其他制约因素如 min 或 max 之外））。

如果没有明确设置 any，number、日期/时间输入类型和 range 输入类型的有效值等于步进的基础——min值和步进值的增量，如果指定的话，最高为max值。

例如，如果存在这样一个元素 ，那么任何大于等于 10 的偶整数都是有效的。如果省略（），任何整数都有效，但浮点数（如 4.2）无效，因为 step 默认为1。为了使 4.2 有效，step 必须被设置为 any、0.1、0.2 或任何 min 值以 .2 结尾的数字，例如 。

备注：

当用户输入的数据不符合步进配置时，该值在约束验证中被认为是无效的，将匹配 :invalid 伪类。

参见客户端验证以获取更多信息。

tabindex

对所有元素有效的全局属性，包括所有的输入类型，是一个整数属性，表示该元素如果参与顺序键盘导航，是否可以接受输入焦点（可聚焦）。由于除了隐藏类型的输入外，所有的输入类型都是可聚焦的，这个属性不应该用在表单控件上，因为这样做需要管理文档中所有元素的聚焦顺序，如果设置错误，就有可能损害可用性和无障碍性。

title

对所有元素有效的全局属性，包括所有的输入类型，包含一个代表与它所属的元素相关的咨询信息的文本。这样的信息通常以工具提示的形式呈现给用户（但不必要）。标题不应作为表单控件用途的主要解释。相反，可以使用 元素，其 for 属性设置为表单控件的 id 属性。参见下面的标签。

type

一个字符串，指定要渲染的控件的类型。例如，要创建一个复选框，使用 checkbox 的值。如果省略（或指定一个未知值），则使用输入类型 text，创建一个纯文本输入字段。

允许的值列在了上方的 Input 类型中。

value

输入控件的值。当在 HTML 中指定时，这是初始值。从那时起，它可以在任何时候用 JavaScript 访问相应的 HTMLInputElement 对象的 value 属性，用于改变或检索。value 属性总是可选的，不过对于 checkbox、radio 和 hidden 来说，应该被认为是必须的。

width

仅对 image 输入按钮有效。width 是呈现在图片提交按钮上的图片宽度。参见 image 输入类型。