HTMLInputElement
HTMLInputElement
接口提供了一些特殊的属性和方法,用于操作 <input>
元素的选项、布局和呈现。
实例属性
它还继承了其父接口 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
属性的字符串,该属性与min
和max
协同工作,以限制可以设置数值或日期时间值的增量。它可以是字符串any
或正浮点数。如果未将其设置为any
,则控件仅接受大于最小值的步长值的倍数。 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
必填
-
一个布尔值,表示元素的
required
属性,指示用户必须在提交表单之前填写一个值。 validationMessage
只读-
返回一个本地化的消息,描述控件不满足的验证约束(如果有)。如果控件不是约束验证的候选对象(
willValidate
为false
),或者它满足其约束,则此值为一个空字符串。此值可以通过setCustomValidity()
方法设置。 validity
只读-
返回元素当前的有效性状态。
willValidate
只读-
返回元素是否为约束验证的候选对象。如果任何条件阻止它进行约束验证,则为
false
,包括:其type
为hidden
、reset
或button
之一,它具有<datalist>
祖先或其disabled
属性为true
。
仅适用于类型为复选框或单选按钮的元素的实例属性
选中
-
一个布尔值,表示元素的当前状态。
defaultChecked
-
一个布尔值,表示单选按钮或复选框的默认状态,如最初在创建此对象的HTML中指定的。
不确定
-
一个布尔值,表示复选框或单选按钮是否处于不确定状态。对于复选框,其效果是复选框的外观以某种方式被遮挡/变灰,以指示其状态是不确定的(未选中但未取消选中)。不影响
checked
属性的值,并且单击复选框将使该值设置为false。
仅适用于类型为图像的元素的实例属性
仅适用于类型为文件的元素的实例属性
接受
-
一个字符串,表示元素的
accept
属性,包含可以选择的逗号分隔的文件类型列表。 files
-
一个
FileList
,表示为上传选择的文件。 webkitdirectory
-
一个布尔值,表示
webkitdirectory
属性。如果为true
,则文件系统选择器界面仅接受目录而不是文件。 webkitEntries
只读-
描述当前选择的文件或目录。
仅适用于包含文本或数字的可见元素的实例属性
自动完成
-
一个字符串,表示元素的
autocomplete
属性,指示浏览器是否可以自动完成控件的值。 捕获
-
一个字符串,表示元素的
capture
属性,指示文件上传控件中的媒体捕获输入方法。 max
maxLength
-
一个数字,表示元素的
maxlength
属性,包含值可以具有的最大字符数(以Unicode代码点表示)。 min
minLength
-
一个数字,表示元素的
minlength
属性,包含值可以具有的最小字符数(以Unicode代码点表示)。 模式
-
一个字符串,表示元素的
pattern
属性,包含控件的值将针对其进行检查的正则表达式。使用title
属性描述模式以帮助用户。此属性仅在type
属性的值为text
、search
、tel
、url
或email
时适用。 占位符
-
一个字符串,表示元素的
placeholder
属性,包含对用户在控件中可以输入什么的提示。占位符文本不得包含回车符或换行符。此属性仅在type
属性的值为text
、search
、tel
、url
或email
时适用。 只读
-
一个布尔值,表示元素的
readonly
属性,指示用户无法修改控件的值。如果type
为hidden
、range
、color
、checkbox
、radio
、file
或按钮类型,则忽略此属性。 selectionDirection
-
一个字符串,表示选择发生的的方向。可能的值为:
forward
(选择是在当前区域设置的从头到尾方向上执行的)、backward
(相反的方向)或none
(方向未知)。 selectionEnd
-
一个数字,表示所选文本的结束索引。当没有选择时,这将返回紧跟当前文本输入光标位置的字符的偏移量。
selectionStart
-
一个数字,表示所选文本的起始索引。当没有选择任何内容时,这将返回
<input>
元素内部文本输入光标(插入符号)的位置。 尺寸
-
一个数字,表示元素的
size
属性,包含控件的可视大小。此值以像素为单位,除非type
的值为text
或password
,在这种情况下,它是字符的整数。
实例方法
还从其父接口HTMLElement
继承方法。
checkValidity()
-
返回一个布尔值,如果元素是约束验证的候选对象,并且它不满足其约束,则该值为
false
。在这种情况下,它还会在元素上触发invalid
事件。如果元素不是约束验证的候选对象,或者它满足其约束,则返回true
。 reportValidity()
-
运行
checkValidity()
方法,如果它返回false(对于无效输入或未提供模式属性),则它会以与提交表单相同的方式向用户报告输入无效。 select()
-
选择输入元素中的所有文本,并将其聚焦,以便用户随后可以替换其所有内容。
setCustomValidity()
-
为元素设置自定义有效性消息。如果此消息不是空字符串,则该元素存在自定义有效性错误,并且无效。
setRangeText()
-
用新文本替换输入元素中的文本范围。
setSelectionRange()
-
选择输入元素中的文本范围(但不将其聚焦)。
showPicker()
-
显示浏览器的日期、时间、颜色和文件选择器。
stepDown()
stepUp()
事件
还从其父接口HTMLElement
继承事件。
使用addEventListener()
或通过将事件监听器分配到此接口的oneventname
属性来监听这些事件
规范
规范 |
---|
HTML标准 # htmlinputelement |
浏览器兼容性
BCD 表格仅在浏览器中加载
另请参阅
- 实现此接口的 HTML 元素:
<input>