HTMLInputElement

实例属性

它还继承了其父接口 HTMLElement 的属性。

某些属性仅适用于支持相应属性的输入元素类型。

align 已弃用

一个字符串，表示元素的对齐方式。请改用 CSS。

alpha 实验性

一个布尔值，表示元素的 alpha 属性，指示颜色的 alpha 分量是否可以由最终用户操作，并且不必完全不透明。

colorSpace 实验性

一个字符串，表示元素的 colorspace 属性，指示序列化 CSS 颜色的色彩空间（sRGB 或 display-p3）。

defaultValue

一个字符串，表示创建此对象时 HTML 中最初指定的默认值。

dirName

一个字符串，表示元素的文字方向。

incremental 非标准

一个布尔值，表示搜索事件的触发模式，如果为 true，则在每次按键或单击取消按钮时触发；否则，在按 Enter 键时触发。

labels 只读

返回为此元素标记的 <label> 元素列表。

list 只读

返回由 list 属性指向的元素。如果在同一树中未找到 HTML 元素，则该属性可能为 null。

multiple

一个布尔值，表示元素的 multiple 属性，指示是否可能存在多个值（例如，多个文件）。

name

一个字符串，表示元素的 name 属性，其中包含在提交表单时标识元素的名称。

popoverTargetAction

获取并设置由 type="button" 的 <input> 元素控制的浮层元素要执行的操作（"hide"、"show" 或 "toggle"）。它反映了 popovertargetaction HTML 属性的值。

popoverTargetElement

获取并设置要通过 type="button" 的 <input> 元素控制的浮层元素。与 popovertarget HTML 属性等效的 JavaScript 属性。

step

一个字符串，表示元素的 step 属性，它与 min 和 max 配合使用，以限制数字或日期时间值的增量。它可以是字符串 any 或一个正浮点数。如果未将其设置为 any，则控件只接受大于最小值的步长值倍数的值。

type

一个字符串，表示元素的 type 属性，指示要显示的控件类型。有关可能的值，请参阅 type 属性的文档。

useMap 已弃用

一个字符串，表示客户端图像映射。

value

一个字符串，表示控件的当前值。如果用户输入的值与预期值不同，则这可能会返回一个空字符串。

valueAsDate

一个 Date 对象，表示元素的值，被解释为日期，如果无法转换则为 null。

valueAsNumber

一个数字，表示元素的值，按顺序解释为以下之一：时间值、数字，如果无法转换则为 NaN。

与父表单相关的实例属性

form 只读

返回对父 <form> 元素的引用。

formAction

一个字符串，表示元素的 formaction 属性，其中包含处理元素提交的信息的程序的 URL。这会覆盖父表单的 action 属性。

formEnctype

一个字符串，表示元素的 formenctype 属性，其中包含用于将表单提交到服务器的内容类型。这会覆盖父表单的 enctype 属性。

formMethod

一个字符串，表示元素的 formmethod 属性，其中包含浏览器用于提交表单的 HTTP 方法。这会覆盖父表单的 method 属性。

formNoValidate

一个布尔值，表示元素的 formnovalidate 属性，指示在提交时不对表单进行验证。这会覆盖父表单的 novalidate 属性。

formTarget

一个字符串，表示元素的 formtarget 属性，其中包含一个名称或关键字，指示在提交表单后在何处显示收到的响应。这会覆盖父表单的 target 属性。

适用于任何非隐藏输入元素类型的实例属性

disabled

一个布尔值，表示元素的 disabled 属性，指示控件不可交互。输入值不会随表单提交。另请参见 readonly。

required

一个布尔值，表示元素的 required 属性，指示用户在提交表单前必须填写值。

validationMessage 只读

返回描述控件不满足的验证约束（如果有）的本地化消息。如果控件不是约束验证的候选对象（willValidate 为 false），或者它满足其约束，则此为空字符串。此值可以通过 setCustomValidity() 方法设置。

validity 只读

返回元素的当前有效性状态。

willValidate 只读

返回元素是否是约束验证的候选对象。如果任何条件阻止其进行约束验证，则为 false，包括：其 type 为 hidden、reset 或 button，它具有 <datalist> 祖先，或者其 disabled 属性为 true。

仅适用于复选框或单选按钮类型的实例属性

checked

一个布尔值，表示元素的当前状态。

defaultChecked

一个布尔值，表示创建此对象时 HTML 中最初指定的单选按钮或复选框的默认状态。

indeterminate

一个布尔值，表示复选框或单选按钮是否处于不确定状态。对于复选框，其效果是复选框的外观以某种方式模糊/变灰，以指示其状态不确定（未选中也未取消选中）。不影响 checked 属性的值，单击复选框将把值设置为 false。

仅适用于图像类型的实例属性

alt

一个字符串，表示元素的 alt 属性，其中包含要使用的替代文本。

height

一个字符串，表示元素的 height 属性，它定义了按钮显示图像的高度。

src

一个字符串，表示元素的 src 属性，它指定了图形提交按钮上要显示的图像位置的 URI。

width

一个字符串，表示元素的 width 属性，它定义了按钮显示图像的宽度。

仅适用于文件类型的实例属性

accept

一个字符串，表示元素的 accept 属性，其中包含逗号分隔的文件类型列表，可以选择这些文件类型。

capture

一个字符串，表示元素的 capture 属性，指示文件上传控件中的媒体捕获输入方法。

files

一个 FileList 对象，表示已选择上传的文件。

webkitdirectory

一个布尔值，表示 webkitdirectory 属性。如果为 true，则文件系统选择器界面只接受目录而不是文件。

webkitEntries 只读

描述当前选定的文件或目录。

仅适用于包含文本或数字的可见元素的实例属性

autocomplete

一个字符串，表示元素的 autocomplete 属性，指示浏览器是否可以自动完成控件的值。

max

一个字符串，表示元素的 max 属性，其中包含此项的最大（数字或日期时间）值，该值不得小于其最小值（min 属性）值。

maxLength

一个数字，表示元素的 maxlength 属性，其中包含值可以拥有的最大字符数（以 Unicode 代码点为单位）。

min

一个字符串，表示元素的 min 属性，其中包含此项的最小（数字或日期时间）值，该值不得大于其最大值（max 属性）值。

minLength

一个数字，表示元素的 minlength 属性，其中包含值可以拥有的最小字符数（以 Unicode 代码点为单位）。

pattern

一个字符串，表示元素的 pattern 属性，其中包含一个正则表达式，用于检查控件的值。使用 title 属性来描述模式以帮助用户。此属性仅在 type 属性的值为 text、search、tel、url 或 email 时适用。

placeholder

一个字符串，表示元素的 placeholder 属性，其中包含对用户的提示，说明可以在控件中输入什么。占位符文本不得包含回车符或换行符。此属性仅在 type 属性的值为 text、search、tel、url 或 email 时适用。

readOnly

一个布尔值，表示元素的 readonly 属性，指示用户无法修改控件的值。如果 type 为 hidden、range、color、checkbox、radio、file 或按钮类型，则此属性将被忽略。

selectionDirection

一个字符串，表示选择发生的方向。可能的值为：forward（选择是按照当前语言环境的从头到尾方向执行的）、backward（相反方向）或 none（方向未知）。

selectionEnd

一个数字，表示选定文本的结束索引。如果没有选择，则返回当前文本输入光标位置之后紧邻的字符的偏移量。

selectionStart

一个数字，表示选定文本的起始索引。如果没有选择，则返回 <input> 元素中文本输入光标（插入符）的位置。

size

一个数字，表示元素的 size 属性，其中包含控件的视觉大小。此值以像素为单位，除非 type 的值为 text 或 password，在这种情况下，它是整数个字符。仅当 type 设置为 text、search、tel、url、email 或 password 时适用。

实例方法

它还继承了其父接口 HTMLElement 的方法。

checkValidity()

如果元素是约束验证的候选对象且不满足其约束，则返回布尔值 false。在这种情况下，它还会向元素触发 invalid 事件。如果元素不是约束验证的候选对象，或者它满足其约束，则返回 true。

reportValidity()

运行 checkValidity() 方法，如果它返回 false（对于无效输入或未提供 pattern 属性），则以与提交表单相同的方式向用户报告输入无效。

select()

选择输入元素中的所有文本，并聚焦它，以便用户随后可以替换其所有内容。

setCustomValidity()

为元素设置自定义有效性消息。如果此消息不是空字符串，则元素存在自定义有效性错误，并且不进行验证。

setRangeText()

用新文本替换输入元素中的一段文本。

setSelectionRange()

选择输入元素中的一段文本（但不聚焦它）。

showPicker()

显示日期、时间、颜色和文件的浏览器选择器。

stepDown()

将 value 递减 (step * n)，如果未指定，n 默认为 1。

stepUp()

将 value 递增 (step * n)，如果未指定，n 默认为 1。

事件

它还继承了其父接口 HTMLElement 的事件。

使用 addEventListener() 或将事件监听器分配给此接口的 oneventname 属性来监听这些事件

cancel 事件

当用户通过 Esc 键或取消按钮取消文件选择器对话框时，以及当用户重新选择之前选择的相同文件时触发。

invalid 事件

当元素在约束验证期间不满足其约束时触发。

search 事件 非标准

当对 type="search" 的 <input> 进行搜索时触发。

select 事件

当一些文本被选中时触发。

selectionchange 事件

当 <input> 元素中的文本选择发生变化时触发。

规范

浏览器兼容性

另见

• 实现此接口的 HTML 元素：<input>