：输入（表单输入）元素

Fruit:

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属性允许的最小值，则约束验证将阻止表单提交。有关更多信息，请参阅客户端验证。

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

minlength

适用于text、search、url、tel、email和password，它定义了用户可以在输入字段中输入的最小字符串长度（以UTF-16代码单元计）。这必须是一个非负整数，且小于或等于maxlength指定的值。如果没有指定minlength，或指定了无效值，则输入没有最小长度。

如果输入到字段中的文本长度少于minlength个UTF-16代码单元，则输入将导致约束验证失败，从而阻止表单提交。只有当用户更改值时才会应用约束验证。有关更多信息，请参阅客户端验证。

multiple

如果设置了布尔型multiple属性，则表示用户可以在电子邮件窗口小部件中输入以逗号分隔的电子邮件地址，或者可以使用file输入选择多个文件。请参阅电子邮件和文件输入类型。

name

一个字符串，用于指定输入控件的名称。当表单数据提交时，此名称将与控件的值一起提交。

将name视为必填属性（即使它不是）。如果输入没有指定name，或name为空，则输入的值不会随表单一起提交！（禁用的控件、未选中的单选按钮、未选中的复选框和重置按钮也不会发送）。

有两种特殊情况

_charset_：如果用作类型为hidden的

元素的名称，则输入的value将由用户代理自动设置为用于提交表单的字符编码。

isindex：出于历史原因，不允许使用名称isindex。

name属性为单选按钮创建了一个独特的行为。

同一命名组中的单选按钮一次只能选中一个。选择该组中的任何单选按钮都会自动取消选择该组中当前选中的任何单选按钮。如果提交表单，则该选中的单选按钮的值将与名称一起发送。

当在同一命名组的单选按钮序列中进行Tab键切换时，如果选中了一个按钮，则该按钮将获得焦点。如果它们在源代码中没有分组在一起，如果该组中的一个按钮被选中，则从遇到该组中的第一个按钮开始进行Tab键切换，跳过所有未选中的按钮。换句话说，如果选中了一个按钮，则Tab键切换会跳过该组中未选中的单选按钮。如果没有选中任何按钮，则当到达同一名称组中的第一个按钮时，单选按钮组将获得焦点。

一旦该组中的一个单选按钮获得焦点，使用箭头键将导航到所有具有相同名称的单选按钮，即使这些单选按钮在源代码中没有分组在一起。

当输入元素被赋予一个name时，该名称将成为拥有表单元素的HTMLFormElement.elements属性的一个属性。如果您有一个name设置为guest的输入和另一个name设置为hat-size的输入，则可以使用以下代码

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

let guestName = form.elements.guest;

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

当此代码运行后，guestName将是guest字段的HTMLInputElement，而hatSize将是hat-size字段的对象。

警告：避免为表单元素提供与表单的内置属性相对应的name，因为您将用对相应输入的引用覆盖预定义的属性或方法。

pattern

适用于text、search、url、tel、email和password，pattern属性定义了一个正则表达式，输入的value必须匹配该正则表达式才能通过约束验证。它必须是一个有效的JavaScript正则表达式，如RegExp类型所使用，以及我们在正则表达式指南中所记录的那样；编译正则表达式时会指定'u'标志，以便将模式视为Unicode代码点的序列，而不是ASCII。模式文本周围不应指定正斜杠。

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

注意：如果使用pattern属性，请通过在附近包含解释性文本来告知用户预期的格式。您还可以包含一个title属性来解释匹配模式的要求；大多数浏览器会将此标题显示为工具提示。可见的解释对于可访问性是必需的。工具提示是一种增强功能。

有关更多信息，请参阅客户端验证。

placeholder

适用于text、search、url、tel、email、password和number，placeholder属性为用户提供了一个简短的提示，说明在字段中期望哪种信息。它应该是一个单词或短语，提示预期的数据类型，而不是解释或提示。文本不得包含回车符或换行符。例如，如果一个字段预期捕获用户的姓氏，并且其标签为“姓氏”，则合适的占位符可能是“例如，张三”。

注意：placeholder属性在语义上不如其他解释表单的方法有用，并且可能导致内容出现意外的技术问题。有关更多信息，请参阅标签。

popovertarget

将元素转换为弹出窗口控件按钮；将要控制的弹出窗口元素的ID作为其值。有关更多详细信息，请参阅弹出窗口API登录页面。

popovertargetaction

指定在由控件控制的弹出窗口元素上执行的操作。可能的值为

"hide"

该按钮将隐藏显示的弹出窗口。如果尝试隐藏已隐藏的弹出窗口，则不会执行任何操作。

"show"

该按钮将显示隐藏的弹出窗口。如果尝试显示已显示的弹出窗口，则不会执行任何操作。

"toggle"

该按钮将在显示和隐藏之间切换弹出窗口。如果弹出窗口隐藏，则会显示；如果弹出窗口显示，则会隐藏。如果省略了popovertargetaction，则"toggle"是控件按钮将执行的默认操作。

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输入按钮，src是指定要显示的图像文件的URL的字符串，以表示图形提交按钮。请参阅图像输入类型。

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

全局属性，对所有元素（包括所有输入类型）有效，一个整数属性，指示元素是否可以获取输入焦点（是否可聚焦），以及它是否应该参与顺序键盘导航。由于除类型为hidden的输入外的所有输入类型都是可聚焦的，因此不应在表单控件上使用此属性，因为这样做需要管理文档中所有元素的焦点顺序，如果操作不当，则存在损害可用性和可访问性的风险。

title

全局属性，对所有元素（包括所有输入类型）有效，包含一个文本，表示与其所属元素相关的建议信息。此类信息通常（但并非必须）可以作为工具提示呈现给用户。标题不应作为表单控件目的的主要解释。相反，请使用for属性设置为表单控件的id属性的元素。请参阅下面的标签。

type

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

允许的值列在上面的输入类型中。

value

输入控件的值。当在HTML中指定时，这是初始值，从那时起，可以使用JavaScript访问相应的HTMLInputElement对象的value属性随时更改或检索它。value属性始终是可选的，但对于checkbox、radio和hidden应视为必需的。

width

仅适用于image输入按钮，width是要显示的图像文件的宽度，以表示图形提交按钮。请参阅图像输入类型。