文档手册

behavior: textarea

2024-07-18 16:30:46

behavior: textarea

相对较小的多行文本的多行编辑行为。

对于可能较大的文本,请使用纯文本。

Elements

默认情况下应用了以下行为:

  • <textarea>...</textarea>

Attributes

此行为知道:

  • readonly - 声明元素是只读的。

  • spellcheck - 布尔值,“真” |“false”,启用/禁用拼写检查。

Events

与标准事件集(鼠标、键盘、焦点)行为一起:按钮生成:

  • "input""change" - 由于用户操作而更改了元素的值。发布(异步)事件。

  • "changing" event - 在元素值即将更改时发送。同步事件。

Value

字符串,反映内部编辑缓冲区的当前状态。

Special key combinations

  • LEFT, CTRL+LEFT, SHIFT+LEFT, CTRL+SHIFT+LEFT

  • RIGHT, CTRL+RIGHT, SHIFT+RIGHT, CTRL+SHIFT+RIGHT

  • HOME, SHIFT+HOME

  • END, SHIFT+END

  • BACKSPACE, ALT+BACKSPACE, CTRL+BACKSPACE

  • CTRL+A

  • DELETE, SHIFT+DELETE, CTRL+DELETE

  • INSERT, SHIFT+INSERT, CTRL+INSERT

  • CTRL+X

  • CTRL+V

  • CTRL+Z

  • CTRL+(LEFT)SHIFT and CTRL+(RIGHT)SHIFT - in forms having the dir attribute these key combinations switches between dir="ltr" and dir="rtl".

Script API

注意:可以使用 .textarea 在元素上访问明文的 API。接口修饰符:

const editor = document.$("textarea#editor");
editor.textarea.insertText("foo");

Properties

  • textarea.selectionStart, textarea.selectionEnd:

    只读、整数、所选内容开始和结束的索引。selectionEnd 是所选文本旁边的字符索引。

  • textarea.selectionText

    只读、字符串、所选文本或空 sting(如果没有选择或选择折叠)。

Methods

  • textarea.selectAll()

     选择全文。

  • textarea.selectRange(start:integer, end:integer)

    选择文本范围,结束位置不包括在选择中。

  • textarea.appendText(text:string): true|false

    在文本末尾附加文本;

  • textarea.insertText(text:string): true|false

    删除选定文本(如果有)并将文本插入到当前位置。

  • textarea.removeText() : true|false

     删除选定的文本;