HTMLInputElement

HTMLInputElement 接口提供了一些特殊的属性和方法,用于操作 <input> 元素的选项、布局和呈现。

EventTarget Node Element HTMLElement HTMLInputElement

实例属性

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

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

align 已弃用

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

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 属性的字符串,该属性与 minmax 协同工作,以限制可以设置数值或日期时间值的增量。它可以是字符串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属性,指示用户必须在提交表单之前填写一个值。

validationMessage 只读

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

validity 只读

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

willValidate 只读

返回元素是否为约束验证的候选对象。如果任何条件阻止它进行约束验证,则为false,包括:其typehiddenresetbutton之一,它具有<datalist>祖先或其disabled属性为true

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

选中

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

defaultChecked

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

不确定

一个布尔值,表示复选框或单选按钮是否处于不确定状态。对于复选框,其效果是复选框的外观以某种方式被遮挡/变灰,以指示其状态是不确定的(未选中但未取消选中)。不影响checked属性的值,并且单击复选框将使该值设置为false。

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

alt

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

高度

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

src

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

宽度

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

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

接受

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

files

一个FileList,表示为上传选择的文件。

webkitdirectory

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

webkitEntries 只读

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

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

自动完成

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

捕获

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

max

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

maxLength

一个数字,表示元素的maxlength属性,包含值可以具有的最大字符数(以Unicode代码点表示)。

min

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

minLength

一个数字,表示元素的minlength属性,包含值可以具有的最小字符数(以Unicode代码点表示)。

模式

一个字符串,表示元素的pattern属性,包含控件的值将针对其进行检查的正则表达式。使用title属性描述模式以帮助用户。此属性仅在type属性的值为textsearchtelurlemail时适用。

占位符

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

只读

一个布尔值,表示元素的readonly属性,指示用户无法修改控件的值。如果typehiddenrangecolorcheckboxradiofile或按钮类型,则忽略此属性。

selectionDirection

一个字符串,表示选择发生的的方向。可能的值为:forward(选择是在当前区域设置的从头到尾方向上执行的)、backward(相反的方向)或none(方向未知)。

selectionEnd

一个数字,表示所选文本的结束索引。当没有选择时,这将返回紧跟当前文本输入光标位置的字符的偏移量。

selectionStart

一个数字,表示所选文本的起始索引。当没有选择任何内容时,这将返回<input>元素内部文本输入光标(插入符号)的位置。

尺寸

一个数字,表示元素的size属性,包含控件的可视大小。此值以像素为单位,除非type的值为textpassword,在这种情况下,它是字符的整数。

实例方法

还从其父接口HTMLElement继承方法。

checkValidity()

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

reportValidity()

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

select()

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

setCustomValidity()

为元素设置自定义有效性消息。如果此消息不是空字符串,则该元素存在自定义有效性错误,并且无效。

setRangeText()

用新文本替换输入元素中的文本范围。

setSelectionRange()

选择输入元素中的文本范围(但不将其聚焦)。

showPicker()

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

stepDown()

value递减(step * n),其中n默认为1(如果未指定)。

stepUp()

value递增(step * n),其中n默认为1(如果未指定)。

事件

还从其父接口HTMLElement继承事件。

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

invalid 事件

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

type="search"<input>上启动搜索时触发。

select 事件

当选择了一些文本时触发。

selectionchange 事件 实验性

<input>元素中的文本选择发生更改时触发。

规范

规范
HTML标准
# htmlinputelement

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

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