behavior: password

标准单行输入元素行为。此行为可以应用于具有 flow:text 和 white-space:pre 模型的任何元素。

Elements

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

• <input type="password" /> - 内联密码输入元素

• <input|password /> - 内联密码输入元素

Attributes

此行为知道：

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

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

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

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

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

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

• password-char="\*" - 密码字符占位符。

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

• element.edit.selectAll() - 选择整体内容。

• element.edit.selectRange(\[start:int \[, end:int\]\]) - 在开始（包含）和结束（排除）位置之间选择文本。如果省略 start 和 end - 删除选定内容。

• element.edit.removeText() - 删除选定的文本（如果有）。

• element.edit.insertText(text: string) - 在插入符号位置插入文本，如果选择不为空，则在插入前删除所选文本。

• element.edit.appendText(text: string) - 将文本附加到现有文本的末尾。

Properties

• selectionStart: int - 返回所选内容的起始位置，如果没有选择，则返回插入符号位置。

• selectionEnd: int - 返回选定内容的结束位置，如果没有选择，则返回插入符号位置。

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