behavior: edit

Standard single line input element behavior. This behavior can be applied to any element that has flow:text and white-space:pre model.

Elements

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

• <input type="text" /> - 直列式单线

Attributes

此行为知道：

• value="text" - 输入元素的初始值

• size=integer - 确定元素的（固有和默认）宽度的值。

• maxlength=integer - 此元素可以包含的最大字符数。

• filter="filter-expr" - 限制允许在字段中输入的字符集。 filter-expr 字符串接受单个字符和字符范围。示例：“.@0~9a~zA~Z” - 所有字母数字字符，'.' 和 '@'。如果您只想排除某些字符，则可以在过滤器前面加上“^”号。因此，此 filter="^.,-" 过滤器将允许输入除“.”、“”和“-”之外的任何字符。

• placeholder="text" - 如果 TextBox 为空，则显示 NoValue 属性提供的文本。您可以使用 :empty CSS 选择器设置此状态的样式。

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

• spellcheck="yes" - 在元素中启用拼写检查。

Events

与标准事件集（鼠标、键盘、焦点）行为一起：按钮生成：

• "input" 或 "change" /EDIT_VALUE_CHANGED事件 - 由于用户操作而更改元素的值。发布（异步）事件。

• "changing" / EDIT_VALUE_CHANGING 事件 - 在对元素的值进行任何更改之前发送。通过处理此事件，可以在将字符插入编辑器之前对其进行筛选。同步事件，其中：

•  event.reason 是其中之一

• 常量 BY_INS_CHAR = 3;通过键入单个字符进行更改。

• 常量 BY_INS_CHARS = 4;从剪贴板粘贴

• 常量 BY_DEL_CHAR = 5;通过 DELETE/BACKSPACE 单击

• 常量 BY_DEL_CHARS = 6;通过选择删除

• event.data - 字符串，读/写。包含要插入的字符（如果 reason 是 BY_INS_*** 值之一;

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".

Methods

selectAll

element.edit.selectAll()

 选择全部内容

selectRange

element.edit.selectRange([start:integer [, end:integer]])

在开始（包含）和结束（排除）位置之间选择文本。如果省略 start 和 end - 删除选定内容。

removeText

element.edit.removeText()

删除选定的文本（如果有）。

insertText

element.edit.insertText(text: string)

在插入符号位置插入文本，如果所选内容不为空，则在插入前删除所选文本。

appendText

element.edit.appendText(text: string)

将文本追加到现有文本的末尾。

Properties

selectionStart

element.edit.selectionStart: int

返回选定内容的起始位置，如果没有选择，则返回插入符号位置。

selectionEnd

element.edit.selectionEnd: int

返回所选内容的结束位置，如果没有选择，则返回插入符号位置。

selectionText

element.edit.selectionText: string

如果没有选择，则返回选定的文本或空字符串。

isStandalone

element.edit.isStandalone: bool

读/写，定义“独立”模式： isStandalone = true 导致导航键始终被使用。默认情况下，如果插入符号移出内容，则不会处理 ArrowLeft、ArrowRight 键。