HTMLTextAreaElement
HTMLTextAreaElement 接口提供了特殊的属性和操作的布局和演示的方法 <textarea> 元素。
HTMLTextAreaElement()
继承层次
Object.prototype
Function.prototype
EventTarget
Node
Element
HTMLElement
HTMLTextAreaElement
构造函数
程序不能直接调用该构造函数,否则将会产生异常。
属性列表
属性 | 说明 |
---|---|
- | - |
方法列表
语法 | 说明 |
---|---|
- | - |
HTMLTextAreaElement.prototype
继承层次
Object.prototype
EventTarget.prototype
Node.prototype
Element.prototype
HTMLElement.prototype
HTMLTextAreaElement.prototype
属性列表
属性 | 说明 |
---|---|
form | 只读,object,返回 form 元素的引用。如果此元素不包含在表单元素,它可以是任何 <form> 内容相同的文件或 null 值。 |
type | 只读的 string,返回区域中的文本。 |
value | string, 返回/设置控件中包含的初始值。 |
textLength | 只读,long,返回该控件的值长度。与调用 value.length 相同。 |
defaultValue | string, 返回 / 设置控件的默认值,像 Node.textContent 属性。 |
placeholder | string,返回/设置元素的 placeholder(占位符)属性,包含有关如何在控件中输入的用户提示。 |
rows | unsigned long,返回/设置元素的行属性,该值指示控件的可见的文本行数。 |
cols | unsigned long,返回/设置元素的 cols 属性,该值指示文本区域的可见宽度。 |
autofocus | boolean,返回/设置元素的自动对焦功能属性,该值指示该控件应该有输入焦点在页面加载时 |
name | string,返回/设置元素的 name 属性,包含的控件的名称。 |
disabled | boolean,返回/设置元素的禁用属性,指示控件无法用于交互。 |
maxLength | long: 返回/设置元素的 maxlength 属性,指示用户可以输入的字符的最大数目。只有当值被改变时,maxLength 才被求值。 |
accessKey | string,返回/设置元素的 accesskey 属性。 |
readOnly | boolean,返回/设置元素的只读属性,该值指示用户不能修改控件的值。 |
required | boolean,返回/设置的元素所需的属性,该值指示用户必须在提交表单之前指定一个值。 |
tabIndex | long,返回/设置当前文档的 tab 键导航元素的位置。 |
selectionStart | unsigned long: 返回/设置选定文本的开头的索引。如果不选定了任何文本,包含输入的光标后面的字符的索引。对被设置,该控件的 setSelectionRange() 曾作为第一个参数和 selectionEnd 作为第二个参数。 |
selectionEnd | unsigned long: 返回/设置选定文本的末尾的索引。如果不选定了任何文本,包含输入的光标后面的字符的索引。对被设置,该控件的 setSelectionRange() 曾用这第二个参数,以及 selectionStart 作为第一个参数。 |
selectionDirection | string: 返回/设置在其中选择发生的方向。如果在当前区域的开始到结束方向执行选择,或者“向后”为相反的方向。如果是未知的方向也可以“none”。 |
validity | 只读,返回这个控件当前的验证状态。 |
willValidate | 只读,表明这个按钮是否需要在提交前进行验证。如果不需要,这个属性值为false |
validationMessage | 只读,报告该控件不满足验证要求的,提示给用户的看的信息。如果这个控件没有验证约束( willValidate 值为 false),或者满足验证的要求,那么这个属性为空字符串。 |
wrap | string,返回/设置该值指示如何控制换行 HTML 的 text 属性。 |
方法列表
语法 | 说明 |
---|---|
focus() | 控件上获取焦点。 |
blur() | 控件上移除焦点。 |
select() | 选择控件内容。 |
checkValidity() | 如果元素的值没有有效性问题,则返回 true,否则返回 false 并触发 invalid 事件. |
setCustomValidity(string) | 设置元素的自定义有效性消息。如果此消息不是空字符串,然后元素有自定义有效性错误,并不验证。 |
setSelectionRange(selectionStart, selectionEnd, [optional] selectionDirection) | 选择一段文本,并设置 selectionStart 和 selectionEnd。如果两个参数大于值的长度,它被视为指向值的末尾。如果结束小于开始,然后两者都被视为的结束值。 |
HTMLTextAreaElement实例
Object.prototype
EventTarget.prototype
Node.prototype
Element.prototype
HTMLElement.prototype
HTMLTextAreaElement.prototype
<textarea> 元素