textarea - [ HTML 中文开发手册 ] - 在线原生手册

简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)

目录搜索

Attributes accesskey (attribute) class (attribute) contenteditable (attribute) contextmenu (attribute) data-* (attribute) dir (attribute) draggable (attribute) dropzone (attribute) Global attributes hidden (attribute) id (attribute) itemid (attribute) itemprop (attribute) itemref (attribute) itemscope (attribute) itemtype (attribute) lang (attribute) slot (attribute) spellcheck (attribute) style (attribute) tabindex (attribute) title (attribute) translate (attribute) Elements a abbr address area article aside audio b base bdi bdo blockquote body br button canvas caption cite code col colgroup data datalist dd del details dfn dialog div dl dt em embed fieldset figcaption figure footer form h1 head header hr html i iframe img input input type="button" input type="checkbox" input type="color" input type="date" input type="datetime"-local input type="email" input type="file" input type="hidden" input type="image" input type="month" input type="number" input type="password" input type="radio" input type="range" input type="reset" input type="search" input type="submit" input type="tel" input type="text" input type="time" input type="url" input type="week" ins kbd label legend li link main map mark menu menuitem meta meter nav noscript object ol optgroup option output p param picture pre progress q rp rt rtc ruby s samp script section select slot small source span strong style sub summary sup table tbody td template textarea tfoot th thead time title tr track u ul var video wbr Miscellaneous Attributes Block-level elements CORS enabled image CORS settings attributes Element Inline elements Kinds of HTML content Link types Microdata Optimizing your pages for speculative parsing Preloading content Reference Supported media formats Using the application cache Obsolete acronym applet basefont big blink center command content dir element font frame frameset hgroup image input type="datetime" isindex keygen listing marquee nextid noframes plaintext strike tt xmp

文字

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以来已弃用。

autocompleteHTML5

此属性表示控件的值是否可以由浏览器自动完成。可能的值是：

off: 不使用浏览器的记忆自动填充，使用者必须输入他们想要输入的所有内容。或者网页提供了自己的自动填充方法。

on: 浏览器根据用户之前输入的内容或者习惯，在用户输入的时候给出相应输入提示。

如果不指明autocomplete属性，浏览器会从父级的表单元素上解析是不是开启这个属性。表单元素可以是`textarea`元素的父级<form>或者`textarea`有跟表单相同的id（参见下面的form属性）。更多请查看<form>的autocomplete属性。

autofocusHTML5页面加载完毕之后是否自动给本元素添加焦点。只有跟表格关联的才能使本属性生效。

cols文本域的可是宽度。必须为正数，默认为20 (HTML5)。

disabled禁用文本域。默认为false。如果未指定，也可以从父级上如<fieldset>继承而来。

formHTML5指定跟自身相关联的表单。值必须为本文档内的表单的ID，如果未指定，就是跟当前所在的表单元素相关联。这就允许你在文档的任意地方放置文本域元素。

maxlengthHTML5允许用户输入的最大字符长度 (Unicode) 。未指定表示无限长度。

minlengthHTML5允许用户输入的最小字符长度(Unicode)

name元素的名称。

placeholderHTML5占位符，用来提示用户进行内容输入。当呈现提示时，占位符文本中的回车或换行回作为换行符。

readonly不允许用户修改元素内文本。和disabled属性不同的是，这个能让用户点击和选择元素内的文本。如果在表单里，这个元素的值还是会跟随表单一起提交。

requiredHTML5 提示用户这个元素的内容必填。

rows元素的输入文本的行数（显示的高度）。

selectionDirection HTML5 选择 selection 发生的方向。如果选择是在LTR语言环境中从左到右进行选择，或若在RTL语言环境中从右到左进行选择，选择“forward”。如果选择在相反的方向上进行，则“backward”。如果选择方向未知，则“none”

selectionEnd在当前选择的最后一个字符的索引。

selectionStart在当前选择的第一个字符的索引。

spellcheckHTML5HTML5 将此属性的值设置为true表示元素需要检查其拼写和语法。valuedefault指示元素是根据默认行为执行的，可能是基于父元素自身的拼写检查值。valuefalse指示元素不应该被检查。

wrapHTML5指定文本换行的方式。默认为soft。可能的值为：

hard: 在文本到达元素最大宽度的时候，浏览器自动插入换行符(CR+LF) 。比如指定 cols值。

soft: 在到达元素最大宽度的时候，不会自动插入换行符。

off：就像可以soft改变外观white-space: pre，所以线段cols能够不包裹且区域能变成水平滚动。

如果未指定此属性，soft则为其默认值。

可调整的textareas

需要Gecko 2.0（Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1）

Gecko 2.0引入了对可调整大小的textareas的支持。这由resizeCSS属性控制。默认情况下，textareas的大小已启用，但您可以通过包含以下CSS来显式禁用它：

textarea {
  resize: none;}

与CSS的交互

从CSS的角度来看<textarea>是可被替换的元素。HTML 规范没有指定<textarea>的基线。所以不同的浏览器可以在任何位置渲染文本域。在Gecko内核的浏览器中<textarea>的基线是文本的第一行的基线。其他的浏览器可能把元素的底部设置为基线。所以不要使用vertical-align: baseline，在不同浏览器中的外观是不确定的。

和点阵图像相似，文本域有默认的尺寸

例子

HTML内容

<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)