Comindware UI-Core API

Class: TextEditorView

module:core.form.editors. TextEditorView

Однострочный текстовый редактор. Поддерживаемый тип данных: String.

new TextEditorView(options)

Parameters:
Name Type Description
options Object Options object. All the properties of BaseEditorView class are also supported.
Properties
Name Type Argument Default Description
maxLength Number | null <optional>
 null Максимальное количество символов. Если null, не ограничено.
changeMode String <optional>
 'blur' Определяет момент обновления значения редактора:
  • 'keydown' - при нажатии клавиши.
  • 'blur' - при потери фокуса.
emptyPlaceholder String <optional>
 'Field is empty' Текст placeholder.
mask String <optional>
 null Если установлено, строка используется как опция mask плагина [jquery.inputmask](https://github.com/RobinHerbots/jquery.inputmask).
maskPlaceholder String <optional>
 '_' При установленной опции mask, используется как опция placeholder плагина.
maskOptions Object <optional>
 {} При установленной опции mask, используется для передачи дополнительных опций плагина.

Extends

Members

hasFocus

Indicates whether the editor has focus.
Inherited From:

Methods

addKeyboardListener(key, callback)

Позволяет добавить callback-функцию на ввод определенной клавиши или комбинации клавиш. Использует метод simple_combo плагина [Keypress](https://dmauro.github.io/Keypress/).
Parameters:
Name Type Description
key String Комбинация клавиш или несколько комбинаций, разделенных запятыми. Полный список с названиями клавиш указан в исходном файле плагина: [keypress.coffee](https://github.com/dmauro/Keypress/blob/master/keypress.coffee#L750-912).
callback String Callback-функция, вызываемая по срабатыванию комбо.

blur()

Clears the focus.
Inherited From:

commit( [options])

Update the model with the internal editor's value.
Parameters:
Name Type Argument Description
options Object <optional>
 Options to pass to model.set().
Properties
Name Type Argument Description
validate Boolean <optional>
 Set to true to trigger built-in model validation.
Inherited From:
Returns:
Returns an error object { type, message } if validation fails and options.forceCommit is turned off. undefined otherwise.
Type
Object | undefined

focus()

Sets the focus onto this editor.
Inherited From:

getEnabled()

Returns the value of `enabled` flag.
Inherited From:
Returns:
Type
Boolean

getModelValue()

Retrieves actual value of the bound attribute from the model.
Inherited From:
Returns:
Type
*

getReadonly()

Returns the value of `readonly` flag.
Inherited From:
Returns:
Type
Boolean

getValue()

Returns internal editor's value.
Inherited From:
Returns:
Type
*

select()

Focuses the editor's input and selects all the text in it.

setEnabled(enabled)

Sets a new value of enabled flag. While disabled, the editor's value cannot be changed or copied by the user. It's implied that the value doesn't make sense.
Parameters:
Name Type Description
enabled Boolean New flag value.
Inherited From:

setReadonly(readonly)

Sets a new value of readonly flag. While readonly, the editor's value cannot be changed but can be copied by the user.
Parameters:
Name Type Description
readonly Boolean New flag value.
Inherited From:

setValue(value)

Sets new internal editor's value.
Parameters:
Name Type Description
value * The new value.
Inherited From:

updateValue()

Manually updated editor's internal value with the value from this.model.get(this.key). Shouldn't be called normally. The method is called internally on model's change event.
Inherited From:

validate()

Check validity with built-in validator functions (initially passed into constructor options).
Inherited From:
Returns:
Returns an error object { type, message } if validation fails. undefined otherwise.
Type
Object | undefined