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 中指定的默认值。
dirNameIs 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 的必需属性,该值表明用户在提交表单前必须填写一个值。
selectionDirectionDOMString 代表选择发生的方向。这是“向前”如果选择了执行中的当前区域设置的开始到结束方向或“落后”的相反的方向。这也可以“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实例

参考

相关页面

外部链接