Перейти к содержанию

NumberInput#

NumberInput - элемент управления, предназначенный для отображения чисел.

Свойства#

id#

Идентификатор контрола.

Отнаследовано от Control.

hint#

Всплывающая подсказка, которая появляется при наведении на контрол.

Отнаследовано от Control.

tags#

Позволяет объединять контролы в группы, возвращает массив имен.

Отнаследовано от Control.

captionWidth#

Ширина заголовка в колонках (для Bootstrap-верстки).

Отнаследовано от Control. По умолчанию значение 1

editorWidth#

Ширина контрола в колонках (для Bootstrap-верстки).

отнаследовано от Control. По умолчанию значение 2

captionTextAlign#

тип значение по умолчанию допустимые значения
string left left, right

Выравнивание текста заголовка контрола

доступно с версии 3.26.0

denyRoles#

Список ролей без прав на данный элемент.

Отнаследовано от Control.

readRoles#

Список ролей на чтение данных.

Отнаследовано от Control

writeRoles#

Список ролей на изменение данных.

Отнаследовано от Control

visible#

Видимость контрола.

Отнаследовано от Control

width#

Ширина контрола.

Отнаследовано от Control

caption#

тип значение по умолчанию допустимые значения
string -

Заголовок контрола

placeholder#

тип значение по умолчанию допустимые значения
string -

Вспомогательный текст в поле ввода контрола

bind#

тип значение по умолчанию допустимые значения
string -

Свойство, к которому биндится контрол

value#

тип значение по умолчанию допустимые значения
string -

Задает значение контрола

enabled#

тип значение по умолчанию допустимые значения
bool true true/false

Доступность контрола для редактирования

readOnly#

тип значение по умолчанию допустимые значения
bool false true/false

Режим "только для чтения"

min#

тип значение по умолчанию допустимые значения
float -999999999999999

Минимально допустимое значение

max#

тип значение по умолчанию допустимые значения
float 999999999999999

Максимально допустимое значение

digits#

тип значение по умолчанию допустимые значения
int 12

Количество знаков целой части

decimalDigits#

тип значение по умолчанию допустимые значения
int 0

Количество знаков дробной части

symbol#

тип значение по умолчанию допустимые значения
string ''

Символ отображающийся рядом со значением

symbolPosition#

тип значение по умолчанию допустимые значения
string left left, right

Положение символа относительно значения

доступно с версии 3.26.0

groupping#

тип значение по умолчанию допустимые значения
bool true true/false

Отвечает за то, нужно ли применять "денежное форматирование" с разделением по разрядам

showSpinButtons#

тип значение по умолчанию допустимые значения
bool false true/false

Позволяет скрыть/отобразить кнопки для изменения значения целой части числа на 1

Методы#

focus#

Устанавливает фокус на контрол.

Отнаследовано от Control.

События#

valueChanged#

Возникает при смене значения

параметр тип описание
s NumberInput экземпляр класса контрола
e object
e.args object аргументы события
e.args.value string цифра в контроле 
1
2
3
4
5
6
7
8
s = NumberInput {
    ... // экземпляр класса NumberInput
},
e = {
    args: {
        value: 'Цифра контрола'
    }
}
Пример 
1
<NumberInput ... valueChanged="test" />

1
2
3
4
test (s, e) {
    console.log('s', s)
    console.log('e', e)
}

Пример#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
<Group caption="NumberInput">
    <NumberInput id="limitedNumberInput" caption="Пределы значений" 
        min="-100" max="100"
        editorWidth="2" captionWidth="3" />
    <NumberInput id="decimalNumberInput" caption="Знаки до и после запятой" 
        digits="6" decimalDigits="6"
        editorWidth="2" captionWidth="3" />
    <NumberInput id="moneyNumberInput" caption="Денежное форматирование" 
        decimalDigits="2" groupping="true"
        editorWidth="2" captionWidth="3" />
    <NumberInput id="moneyNumberInput" caption="Денежное форматирование и символ" 
        decimalDigits="2" groupping="true" symbol="$ " symbolPosition="left" hint="Символ слева"
        editorWidth="2" captionWidth="3" />
    <NumberInput id="moneyNumberInput" caption="Денежное форматирование и символ" 
        decimalDigits="2" groupping="true" symbol=" $" symbolPosition="right" hint="Символ справа"
        editorWidth="2" captionWidth="3" />
</Group>

Для ввода числовых значений используется контрол NumberInput. Он, также как и TextBox, позволяет устанавливать определенные правила для ввода и отображения значений:

  • ограничение максимального и минимального значений - свойства max и min;
  • количество знаков до и после запятой для дробных чисел - свойства digits и decimalDigits;
  • включать отображение разрядов числа - свойство groupping;
  • настраивать денежный символ и его расположение - свойства symbol и symbolPosition.