HTMLInputElement
HTMLInputElement 接口提供了特殊的属性及方法(扩充了从 HTMLElement 所继承的部分)以操作 <input> 元素的显示与布局。
HTMLInputElement()
继承层次
Object.prototype
Function.prototype
EventTarget
Node
Element
HTMLElement
HTMLInputElement
构造函数
程序不能直接调用该构造函数,否则将会产生异常。
属性列表
属性 | 说明 |
---|---|
- | - |
方法列表
语法 | 说明 |
---|---|
- | - |
HTMLInputElement.prototype
继承层次
Object.prototype
EventTarget.prototype
Node.prototype
Element.prototype
HTMLElement.prototype
HTMLInputElement.prototype
属性列表
继承其父类 HTMLElement 的属性。
属性 | 说明 |
---|---|
accept | 表示 HTML 属性,包含逗号分隔的文件类型接受服务器类型是当文件列表。 |
accessKey | 一个键盘字符构成的字符串,表明用哪个键盘字符能够访问这个按钮。 |
alt | 表示 HTML 的 ALT 属性,包含替代文本时使用的是图像类型。 |
autocomplete | 是一个 DOMString 表示完成的 HTML 属性,指示该控件的值可以由浏览器自动完成。有值 off 和 on。off:用户必须明确地输入一个值到该字段的每一个使用,或该文档提供了自己的自动完成方法;浏览器不会自动完成条目。on:浏览器可以根据用户在以前使用时输入的值自动完成值。 |
autofocus | 是一个布尔值,反映了自动对焦的 HTML 属性,该值指示控件是否应该有输入焦点页面加载时,除非用户通过重写它,例如在不同的控件中键入内容。文档中只有一个 form-associated 的元素可以具有指定此属性。 |
checked | 当前单选按钮或复选框选中状态。 |
defaultChecked | 单选按钮或复选框最初创建此对象的 HTML 中指定的默认状态。 |
defaultValue | 最初创建此对象的 HTML 中指定的默认值。 |
dirName | Is a |
disabled | 表示不可点击的 HTML 属性,表明控制不可相互作用。输入值将不以表单提交。 |
files | 只读,选定文件列表。 |
form | 只读,这个按钮所关联的表单元素。如果这个按钮是一个表单元素的后代元素,那么这个属性的值就是那个表单元素。如果这个按钮不是一个表单元素的后代元素,那么这个数学可以是任意同文档中的表单元素,或者是 null 表明它没有关联任何表单。 |
formAction | 一个处理提交信息的 URI 资源地址。如果指定该属性,会覆盖拥有该元素的 <form> 元素的 action 属性。 |
formEncType | 表单要提交给服务器处理的内容的类型。如果指定该属性,会覆盖拥有该元素的 <form> 元素的 enctype 属性。 |
formMethod | 浏览器提交表单内容的 HTTP 方法。如果指定该属性,会覆盖拥有该元素的 <form> 元素的 method 属性。 |
formNoValidate | 表明这个表单提交时是否需要验证。如果指定该属性,会覆盖拥有该元素的 <form> 元素的 novalidate 属性。 |
formTarget | 一个名字或关键字,用于表明显示服务器响应的页面。如果指定该属性,会覆盖拥有该元素的 <form> 元素的 target 属性。 |
height | 表示 HTML 的高度属性,如果类型的值是图像定义为该按钮显示的图像的高度。 |
indeterminate | 表示一个复选框是既不 off 也不是 on。 |
labels | 只读,一个 <label> 元素表,说明哪些标签是归属这个 button 的。 |
list | 标识预定义的选项向用户建议的列表。值必须是同一文档中的 <datalist> 元素的 id。浏览器显示只是有效值为此输入元素的选项。此属性被忽略时,类型属性的值是隐藏的(复选框、广播、文件、或一个按钮式)。 |
max | 表示 HTML 的 max 属性,包含最大值(数字或日期时间)这个项目的价值,它必须不小于其最小值(MIN属性)。 |
maxLength | 表示 HTML 的最大长度属性,包含文本的最大长度(Unicode代码点),这个值是可以改变的。只有当值被改变时,maxLength 才被求值。 |
min | 表示HTML的最小长度属性,包含文本的最小长度(Unicode代码点),这个值是可以改变的。必须小于最大值(最大值属性)。 |
multiple | 表示多个 HTML 属性的多个值,指示是否是可行(例如,多个文件)。 |
name | 表示 HTML 的 name 属性,包含一个标识元素,当提交表单时的 name。 |
pattern | 这个 DOMString 是包含该控件的值进行对照正则表达式模式 HTML 属性。模式必须匹配整个值,不只是一些子集。使用 title 属性来描述模式来帮助用户。此属性适用类型属性的值时文本、 搜索、 电话、 url 或电子邮件;否则,它将被忽略。 |
placeholder | 是可以在控件中输入的 DOMString 占位符的 HTML 属性,包含对用户的什么的提示。占位符文本不能包含回车或换行。此属性适用类型属性的值时文本、 搜索、 电话、 url 或电子邮件;否则,它将被忽略。 |
readOnly | 表示 HTML 只读属性,该值表明用户不能修改值。 |
required | 表示 HTML 的必需属性,该值表明用户在提交表单前必须填写一个值。 |
selectionDirection | DOMString 代表选择发生的方向。这是“向前”如果选择了执行中的当前区域设置的开始到结束方向或“落后”的相反的方向。这也可以“none”如果是未知的方向“。 |
selectionEnd | 所选文本末尾处的索引。 |
selectionStart | 选定文本的开头的索引。当未选择任何内容时,是在 <input> 元素的插入符号位置。 |
size | 是一个无符号长整型大小的 HTML 属性,包含控件的大小。此值为像素,除非类型的值是文本或密码,在这种情况下,它是字符的整数。仅适用于类型设置为文本、搜索、电话、URL、电子邮件或密码时,否则将被忽略。 |
src | 表示HTML 的 src 属性,如果 type 的值是图像,它指定一个 UR I为图像在图形提交按钮的显示位置;否则被忽略。 |
step | 是一个 DOMString 表示的 HTML 属性,min 和 max 来限制可以在其中设置一个数值或日期时间值的增量。它任何可以是字符串或一个积极的浮点数。如果未对任何设置,则控件只接受大于最小值的步骤值的倍数。 |
tabIndex | 该元素为当前文档的 tab 导航命令的位置。 |
type | 表示 HTML 的 type 属性,指示显示控制的类型。查看 <input> 的类型属性。 |
validationMessage | 只读,报告该控件不满足验证要求的,提示给用户的看的信息。如果这个控件没有验证约束(willValidate 值为 false),或者满足验证的要求,那么这个属性为空字符串。 |
validity | 只读,这个控件当前的验证状态。 |
value | 这个控件当前的表单值。 |
valueAsDate | 元素的值,解释为日期,如果不能转换,则为 null。 |
valueAsNumber | 一个双精度值包含元素的值,被解释为顺序在下列情况之一︰一个时间值,一个数字,NaN表示转换是不可能的。 |
width | 表示 HTML 属性中的宽度,如果类型的值是图像定义为显示的图像的宽度。 |
willValidate | 表明这个按钮是否需要在提交前进行验证。如果不需要,这个属性值为 false 。 |
方法列表
继承其父类 HTMLElement 的方法。
语法 | 说明 |
---|---|
blur() | 从 input 移除焦点。 |
checkValidity() | 如果元素的值没有有效性问题,则返回 true,否则返回 false 并触发 invalid 事件. |
click() | 模拟在元素上的单击。 |
focus() | 输入框焦点。 |
select() | 使 <input> 元素的文本处于选中状态。 |
setCustomValidity(error) | 设置元素的自定义有效性消息。如果此消息不是空字符串,则该元素自定义有效性错误,并且不验证。 |
setSelectionRange(selectionStart, selectionEnd, [optional] selectionDirection) | 设置<input>元素中的文本选中内容的起始位置和结束位置。本方法调用会更新HTMLInputElement.selectionStart, selectionEnd, 和 selectionDirection 这3条属性。 |
setRangeText(replacement, [optional] start, [optional] end, [optional] selectMode) | 用新文本替换的文本的范围。支持的输入的类型︰ 文本、 搜索、 url、 电话、 密码。 |
HTMLInputElement实例
Object.prototype
EventTarget.prototype
Node.prototype
Element.prototype
HTMLElement.prototype
HTMLInputElement.prototype
<input> 元素