非常教程

HTML参考手册

标签 | Elements

textarea

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)

HTML

超文本标记语言,它通过标记符号来标记要显示的网页中的各个部分。网页文件本身是一种文本文件,通过在文本文件中添加标记符,可以告诉浏览器如何显示其中的内容(如:文字如何处理,画面如何安排,图片如何显示等)。浏览器按顺序阅读网页文件,然后根据标记符解释和显示其标记的内容,对书写出错的标记将不指出其错误,且不停止其解释执行过程,编制者只能通过显示效果来分析出错原因和出错部位。但需要注意的是,对于不同的浏览器,对同一标记符可能会有不完全相同的解释,因而可能会有不同的显示效果。