©
本文档使用
php.cn手册 发布
HTML<textarea> 元素
表示一个
多行纯文本编辑控件。
内容类别 | Flow content, phrasing content, Interactive content, listed, labelable, resettable, and submittable form-associated element. |
---|---|
允许的内容 | Text |
标记遗漏 | 没有,起始和结束标签都是强制性的。 |
允许的父母 | 任何接受 phrasing content 的元素。 |
允许ARIA角色 | 没有 |
DOM接口 | HTMLTextAreaElement |
这个元素包含全局属性。
autocapitalize
这是由iOS上的WebKit支持的非标准属性(因此几乎所有在iOS上运行的浏览器,包括Safari,Firefox和Chrome)都控制着用户输入/编辑文本值时是否应自动大写。iOS 5及更高版本中提供了不推荐使用的值。可能的值是:
none
: 禁用首字母大写。
sentences
: 句子的首字母大写。
words
: 单词或者字母的首字母大写。
characters
: 全部大写。
on
:自iOS 5以来已弃用。
off
: 自iOS 5以来已弃用。
autocomplete
HTML5
此属性表示控件的值是否可以由浏览器自动完成。可能的值是:
off
: 不使用浏览器的记忆自动填充,使用者必须输入他们想要输入的所有内容。或者网页提供了自己的自动填充方法。
on
: 浏览器根据用户之前输入的内容或者习惯,在用户输入的时候给出相应输入提示。
如果不指明autocomplete属性,浏览器会从父级的表单元素上解析是不是开启这个属性。表单元素可以是`textarea`元素的父级<form>
或者`textarea`有跟表单相同的id(参见下面的form属性)。更多请查看<form>
的autocomplete
属性。
autofocus
HTML5页面加载完毕之后是否自动给本元素添加焦点。只有跟表格关联的才能使本属性生效。
cols
文本域的可是宽度。必须为正数,默认为20 (HTML5)。
disabled
禁用文本域。默认为false。如果未指定,也可以从父级上如<fieldset>
继承而来。
form
HTML5指定跟自身相关联的表单。值必须为本文档内的表单的ID,如果未指定,就是跟当前所在的表单元素相关联。这就允许你在文档的任意地方放置文本域元素。
maxlength
HTML5允许用户输入的最大字符长度 (Unicode) 。未指定表示无限长度。
minlength
HTML5允许用户输入的最小字符长度(Unicode)
name
元素的名称。
placeholder
HTML5占位符,用来提示用户进行内容输入。当呈现提示时,占位符文本中的回车或换行回作为换行符。
readonly
不允许用户修改元素内文本。和disabled
属性不同的是,这个能让用户点击和选择元素内的文本。如果在表单里,这个元素的值还是会跟随表单一起提交。
required
HTML5 提示用户这个元素的内容必填。
rows
元素的输入文本的行数(显示的高度)。
selectionDirection
HTML5 选择 selection 发生的方向。如果选择是在LTR语言环境中从左到右进行选择,或若在RTL语言环境中从右到左进行选择,选择“forward”。如果选择在相反的方向上进行,则“backward”。如果选择方向未知,则“none”
selectionEnd
在当前选择的最后一个字符的索引。
selectionStart
在当前选择的第一个字符的索引。
spellcheck
HTML5HTML5 将此属性的值设置为true表示元素需要检查其拼写和语法。valuedefault指示元素是根据默认行为执行的,可能是基于父元素自身的拼写检查值。valuefalse指示元素不应该被检查。
wrap
HTML5指定文本换行的方式。默认为soft。可能的值为:
hard: 在文本到达元素最大宽度的时候,浏览器自动插入换行符(CR+LF) 。比如指定 cols
值。
soft: 在到达元素最大宽度的时候,不会自动插入换行符。
off
:就像可以soft
改变外观white-space: pre,
所以线段cols能够
不包裹且区域能变成水平滚动。
如果未指定此属性,soft
则为其默认值。
需要Gecko 2.0(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)
Gecko 2.0引入了对可调整大小的textareas的支持。这由resize
CSS属性控制。默认情况下,textareas的大小已启用,但您可以通过包含以下CSS来显式禁用它:
textarea { resize: none;}
从CSS的角度来看<textarea>
是可被替换的元素。HTML 规范没有指定<textarea>
的基线。所以不同的浏览器可以在任何位置渲染文本域。在Gecko内核的浏览器中<textarea>
的基线是文本的第一行的基线。其他的浏览器可能把元素的底部设置为基线。所以不要使用vertical-align
: baseline
,在不同浏览器中的外观是不确定的。
和点阵图像相似,文本域有默认的尺寸
<textarea name="textarea" rows="10" cols="50">Write something here</textarea>
Specification | Status | Comment |
---|---|---|
HTML Living StandardThe definition of '<textarea>' in that specification. | Living Standard | |
HTML5The definition of '<textarea>' in that specification. | Recommendation | |
HTML 4.01 SpecificationThe definition of '<textarea>' in that specification. | Recommendation |
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes)1 2 | (Yes) | (Yes) | (Yes) |
autocapitalize | No | No | No | No | No | No |
autocomplete | No | No | No | No | No | No |
autofocus | (Yes) | (Yes) | 4 | 10 | (Yes) | (Yes) |
cols | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
disabled | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
form | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
maxlength | (Yes) | (Yes) | 4 | 10 | (Yes) | (Yes) |
minlength | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
name | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
placeholder | (Yes) | (Yes) | 4 | 10 | 11.5 | 5 |
readonly | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
required | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
rows | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
spellcheck | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
wrap | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes)1 2 | (Yes) | (Yes) | (Yes)3 |
autocapitalize | No | No | No | No | No | No | No |
autocomplete | No | No | ? | No | No | No | No |
autofocus | ? | ? | ? | 4 | ? | ? | ? |
cols | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
disabled | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
form | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
maxlength | ? | ? | (Yes) | 4 | ? | ? | ? |
minlength | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
name | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
placeholder | ? | ? | (Yes) | 4 | ? | 11.5 | 4 |
readonly | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
required | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
rows | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
spellcheck | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
wrap | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |