HTML DOM
HTMLInputElement 接口提供了特定的属性和方法,用于管理 input 元素的选项、布局和外观。
实例属性
还从其父接口 HTMLElement 继承属性。
某些属性仅适用于支持相应属性的输入元素类型。
- HTMLInputElement.align
- : 一个表示元素对齐方式的字符串。请改用 CSS。
- HTMLInputElement.defaultValue
- : 一个表示元素默认值的字符串,该值最初是在创建此对象的 HTML 中指定的。
- HTMLInputElement.dirName
- : 一个表示元素方向的字符串。
- HTMLInputElement.incremental
- : 一个表示搜索事件触发模式的布尔值,如果为
true,则在每次按键或单击取消按钮时触发;否则在按下 <kbd>Enter</kbd> 键时触发。
- : 一个表示搜索事件触发模式的布尔值,如果为
- HTMLInputElement.labels
- : 返回一个 label 元素的列表,这些元素是当前元素的标签。
- HTMLInputElement.list
- : 返回由
list属性指向的元素。如果在同一树中找不到 HTML 元素,则该属性可能为null。
- : 返回由
- HTMLInputElement.multiple
- : 一个表示元素的
multiple属性的布尔值,表示是否可能有多个值(例如,多个文件)。
- : 一个表示元素的
- HTMLInputElement.name
- : 一个表示元素的
name属性的字符串,包含在提交表单时标识元素的名称。
- : 一个表示元素的
- HTMLInputElement.popoverTargetAction
- : 获取或设置要在由
type="button"的 input 元素控制的弹出窗口元素上执行的操作("hide"、"show"或"toggle")。它反映了popovertargetactionHTML 属性的值。
- : 获取或设置要在由
- HTMLInputElement.popoverTargetElement
- : 获取或设置要通过
type="button"的 input 元素控制的弹出窗口元素。它反映了popovertargetHTML 属性的值。
- : 获取或设置要通过
- HTMLInputElement.step
- HTMLInputElement.type
- HTMLInputElement.useMap
- : 一个表示客户端图像映射的字符串。
- HTMLInputElement.value
- : 一个表示控件当前值的字符串。如果用户输入与预期不同的值,则可能返回空字符串。
- HTMLInputElement.valueAsDate
- : 一个表示元素的值的 Date,以日期形式解释,如果无法转换,则为
null。
- : 一个表示元素的值的 Date,以日期形式解释,如果无法转换,则为
- HTMLInputElement.valueAsNumber
- : 一个表示元素的值的数字,以以下顺序解释:时间值、数字或
NaN(如果无法转换)。
- : 一个表示元素的值的数字,以以下顺序解释:时间值、数字或
与父表单相关的实例属性
- HTMLInputElement.form
- : 返回一个父表单(form)元素的引用。
- HTMLInputElement.formAction
- : 一个表示元素的
formaction属性的字符串,包含处理元素提交信息程序的 URI。这会覆盖父表单的action属性。
- : 一个表示元素的
- HTMLInputElement.formEnctype
- : 一个表示元素的
formenctype属性的字符串,包含将表单提交到服务器的内容类型。这会覆盖父表单的enctype属性。
- : 一个表示元素的
- HTMLInputElement.formMethod
- : 一个表示元素的
formmethod属性的字符串,包含浏览器用于提交表单的 HTTP 方法。这会覆盖父表单的method属性。
- : 一个表示元素的
- HTMLInputElement.formNoValidate
- : 一个表示元素的
formnovalidate属性的布尔值,表示在提交表单时不对其进行验证。这会覆盖父表单的novalidate属性。
- : 一个表示元素的
- HTMLInputElement.formTarget
- : 一个表示元素的
formtarget属性的字符串,包含一个名称或关键字,表示在提交表单后接收响应的显示位置。这会覆盖父表单的target属性。
- : 一个表示元素的
适用于任何类型的非隐藏输入元素的实例属性
- HTMLInputElement.disabled
- HTMLInputElement.required
- : 一个表示元素的
required属性的布尔值,表示用户必须在提交表单之前填写值。
- : 一个表示元素的
- HTMLInputElement.validationMessage
- : 返回一条描述控件不满足时的验证约束的本地化消息。如果控件不是约束验证的候选项(
willValidate为false),或者它满足其约束,则为空字符串。此值可以通过 HTMLInputElement.setCustomValidity() 方法设置。
- : 返回一条描述控件不满足时的验证约束的本地化消息。如果控件不是约束验证的候选项(
- HTMLInputElement.validity
- : 返回元素当前的有效状态。
- HTMLInputElement.willValidate
- : 返回元素是否是约束验证的候选项。如果任何条件阻止它进行约束验证,则为
false,包括:它的type是hidden、reset或button之一,它的祖先中有 datalist 或者它的disabled属性为true。
- : 返回元素是否是约束验证的候选项。如果任何条件阻止它进行约束验证,则为
仅适用于复选框和单选按钮元素的实例属性
- HTMLInputElement.checked
- : 一个表示元素当前状态的布尔值。
- HTMLInputElement.defaultChecked
- : 一个表示单选按钮或复选框的默认状态的布尔值,该值最初是在创建此对象的 HTML 中指定的。
- HTMLInputElement.indeterminate
- : 一个表示复选框或单选按钮是否处于不确定状态的布尔值。对于复选框,效果是复选框的外观被某种方式遮挡/变灰,以表示其状态是不确定的(既不选中也不未选中)。不会影响
checked属性的值,单击复选框将其值设置为假。
- : 一个表示复选框或单选按钮是否处于不确定状态的布尔值。对于复选框,效果是复选框的外观被某种方式遮挡/变灰,以表示其状态是不确定的(既不选中也不未选中)。不会影响
仅适用于图像类型的元素的实例属性
- HTMLInputElement.alt
- : 一个表示元素的
alt属性的字符串,包含要使用的替代文本。
- : 一个表示元素的
- HTMLInputElement.height
- : 一个表示元素的
height属性的字符串,包含要显示为按钮的图像的高度。
- : 一个表示元素的
- HTMLInputElement.src
- : 一个表示元素的
src属性的字符串,包含要显示为图形提交按钮上的图像的位置的 URI。
- : 一个表示元素的
- HTMLInputElement.width
- : 一个表示元素的
width属性的字符串,包含要显示为按钮的图像的宽度。
- : 一个表示元素的
仅适用于文件类型的元素的实例属性
- HTMLInputElement.accept
- : 一个表示元素的
accept属性的字符串,包含可以选择的文件类型的以逗号分隔的列表。
- : 一个表示元素的
- HTMLInputElement.files
- : 一个 FileList,表示选择的要上传的文件。
- HTMLInputElement.webkitdirectory
- : 一个表示
webkitdirectory属性的布尔值。如果为true,则文件系统选择器接口仅接受目录而不是文件。
- : 一个表示
- HTMLInputElement.webkitEntries
- : 描述当前选择的文件或目录。
仅适用于包含文本或数字的可见元素的实例属性
- HTMLInputElement.autocomplete
- : 一个表示元素的
autocomplete属性的字符串,表示控件的值是否可以由浏览器自动填充。
- : 一个表示元素的
- HTMLInputElement.capture
- : 一个表示元素的
capture属性的字符串,指示文件上传控件中的媒体捕获输入方法。
- : 一个表示元素的
- HTMLInputElement.max
- HTMLInputElement.maxLength
- : 一个表示元素的
maxlength属性的数字,包含值可以具有的最大字符数(以 Unicode 码点表示)。
- : 一个表示元素的
- HTMLInputElement.min
- HTMLInputElement.minLength
- : 一个表示元素的
minlength属性的数字,包含值可以具有的最小字符数(以 Unicode 码点表示)。
- : 一个表示元素的
- HTMLInputElement.pattern
- HTMLInputElement.placeholder
- : 一个表示元素的
placeholder属性的字符串,包含一个提示,告诉用户可以在控件中输入什么。占位符文本不能包含回车或换行符。此属性仅适用于type属性的值为text、search、tel、url或email的情况。
- : 一个表示元素的
- HTMLInputElement.readOnly
- HTMLInputElement.selectionDirection
- : 一个表示选择发生的方向的字符串。可能的值为:
forward(选择是从当前区域设置的起始到结束方向上执行的)、backward(相反的方向)或none(方向未知)。
- : 一个表示选择发生的方向的字符串。可能的值为:
- HTMLInputElement.selectionEnd
- : 一个表示选择文本的结束索引的数字。当没有选择时,它返回当前文本输入光标位置后面的字符的偏移量。
- HTMLInputElement.selectionStart
- : 一个表示选择文本的开始索引的数字。当没有选择时,它返回当前文本输入光标位置的偏移量。
- HTMLInputElement.size
实例方法
也从其父接口 HTMLElement 继承方法。
- HTMLInputElement.checkValidity()
- : 返回一个布尔值,如果元素是约束验证的候选项,并且它不满足其约束,则为
false。在这种情况下,它还会在元素上触发 HTMLInputElement/invalid_event 事件。如果元素不是约束验证的候选项,或者它满足其约束,则返回true。
- : 返回一个布尔值,如果元素是约束验证的候选项,并且它不满足其约束,则为
- HTMLInputElement.reportValidity()
- : 运行
checkValidity()方法,如果它返回 false(对于无效输入或未提供模式属性),则以与提交表单相同的方式向用户报告输入无效。
- : 运行
- HTMLInputElement.select()
- : 选择输入元素中的所有文本,并将其聚焦,以便用户随后可以替换其所有内容。
- HTMLInputElement.setCustomValidity()
- : 设置元素的自定义有效性消息。如果此消息不是空字符串,则元素存在自定义有效性错误,且其值无效。
- HTMLInputElement.setRangeText()
- : 替换输入元素中的一段文本为新文本。
- HTMLInputElement.setSelectionRange()
- : 选择输入元素中的一段文本(但不聚焦)。
- HTMLInputElement.showPicker()
- : 显示浏览器的日期、时间、颜色和文件选择器。
- HTMLInputElement.stepDown()
- HTMLInputElement.stepUp()
事件
也从其父接口 HTMLElement 继承事件。
使用 EventTarget.addEventListener 或通过将事件监听器赋值给此接口的 oneventname 属性来监听这些事件:
- HTMLInputElement/invalid_event 事件
- : 当元素在约束验证期间不满足其约束时触发。
- HTMLInputElement/search_event 事件
- : 当在
type="search"的 input 上开始搜索时触发。
- : 当在
- HTMLInputElement/select_event 事件
- : 当选中了一些文本时触发。
- HTMLInputElement/selectionchange_event 事件
- : 在 input 元素中的文本选择发生更改后触发。
规范
浏览器兼容性
参见
- 实现了该接口的 HTML 元素:input
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
