翻译正在进行中。

HTML <textarea> 元素表示一个多行纯文本编辑控件。 

内存形式 Flow contentphrasing contentInteractive contentlistedlabelableresettable, and submittable form-associated element.
合法内容 Text
标签省略 不允许,开始标签和结束标签都不能省略。
合法父级 Any element that accepts phrasing content.
Permitted ARIA roles None
DOM 接口 HTMLTextAreaElement

属性

这个元素包含了全局属性

autocapitalize
iOS的非标准属性(iOS上的Safari。Firefox,Chrome都支持),文本是否自动首字母大写。在iOS5和之后的版本上有效。可能的值为:
  • 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)。
resize:none
去掉文本域右下角的默认的灰色斜杠。
disabled
禁用文本域。默认为false。如果未指定,也可以从父级上如<fieldset>继承而来。
form HTML5
指定跟自身相关联的表单。值必须为本文档内的表单的ID,如果未指定,就是跟当前所在的表单元素相关联。这就允许你在文档的任意地方放置文本域元素。
maxlength HTML5
允许用户输入的最大字符长度 (Unicode) 。未指定表示无限长度。
minlength HTML5
允许用户输入的最小字符长度(Unicode) 
name
元素的名称。
placeholder HTML5
占位符,用来提示用户进行内容输入。渲染占位符文本时,换行和末位单词补全等字符(不确定是不是这样翻译)会被渲染成换行。
readonly
不允许用户修改元素内文本。和 disabled 属性不同的是,这个能让用户点击和选择元素内的文本。如果在表单里,这个元素的值还是会跟随表单一起提交。
required HTML5
提示用户这个元素的内容必填。
rows
元素的输入文本的行数(显示的高度)。
selectionDirection HTML5
The direction in which selection occurred. This is "forward" if the selection was made from left-to-right in an LTR locale or right-to-left in an RTL locale, or "backward" if the selection was made in the opposite direction. This can be "none" if the selection direction is unknown.
selectionEnd
The index to the last character in the current selection.
selectionStart
The index to the first character in the current selection.
spellcheck HTML5
Setting the value of this attribute to true indicates that the element needs to have its spelling and grammar checked. The value default indicates that the element is to act according to a default behavior, possibly based on the parent element's own spellcheck value. The value false indicates that the element should not be checked.
wrap HTML5
指定文本换行的方式。默认为soft。可能的值为:
  • hard: 在文本到达元素最大宽度的时候,浏览器自动插入换行符(CR+LF) 。比如指定 cols值。
  • soft: 在到达元素最大宽度的时候,不会自动插入换行符。

DOM 接口

本元素是 HTMLTextAreaElement接口的实例。

Resizable textareas

Requires Gecko 2.0(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Gecko 2.0支持可变大小的文本域。是由 resize进行控制。默认开启,你可以用下面的css禁用此功能:

textarea {
  resize: none;
}

与CSS的交互

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

光栅图像(raster image)相似,文本域有默认的尺寸

Example

HTML Content

<textarea name="textarea" rows="10" cols="50">Write something here</textarea>

规范

Specification Status Comment
HTML Living Standard
<textarea>
Living Standard  
HTML5
<textarea>
Recommendation  
HTML 4.01 Specification
<textarea>
Recommendation  

兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) 1.0 (1.7 or earlier) (Yes) (Yes) (Yes)
autofocus attribute (Yes) 4.0 (2.0) 10 (Yes) (Yes)
maxlength attribute (Yes) 4.0 (2.0) 10 (Yes) (Yes)
placeholder attribute (Yes) 4.0 (2.0) 10 11.50 5.0
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) 1.0 (1.0) (Yes) (Yes) (Yes)
autofocus attribute ? 4.0 (2.0) 未实现 ? ?
maxlength attribute ? 4.0 (2.0) 未实现 ? ?
placeholder attribute ? 4.0 (2.0) ? 11.50 4.0

iOS上的Safari默认给禁用的文本域添加了opacity: 0.4 。其他的浏览器没有这样做。

Gecko notes

Starting in Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3), when a <textarea> is focused, the insertion point is placed at the beginning of the text by default, instead of at the end. This change makes Gecko's behavior consistent with other popular browsers.

Firefox for Android, by default, sets a background-image gradient on all <textarea> elements. This can be disabled using background-image: none.

参考

Other form-related elements: <form>, <button>, <datalist>, <legend>, <label>, <select>, <optgroup>, <option>, <input>, <keygen>, <fieldset>, <output>, <progress> and <meter>.

文档标签和贡献者

标签: 
 此页面的贡献者: celinaYu, maicss, xgqfrms-GitHub, DeronLee, FredWe
 最后编辑者: celinaYu,