Платформа 3V/Формы/Компоненты/Основные/Текстовое поле: различия между версиями
< Платформа 3V | Формы | Компоненты | Основные
Перейти к навигации
Перейти к поиску
(Отмена правки 4595, сделанной A.kazanceva (обсуждение)) Метка: отмена |
|||
| Строка 1: | Строка 1: | ||
| − | { | + | {} |
| − | '''Текстовое поле''' | + | '''Текстовое поле''' - поле ввода коротких текстовых значений. |
<div class="NavFrame collapsed"> | <div class="NavFrame collapsed"> | ||
<div class="NavHead"> Описание настроек компонента</div> | <div class="NavHead"> Описание настроек компонента</div> | ||
| Строка 6: | Строка 6: | ||
{| class="wikitable" style="margin:auto; clear:both;" | {| class="wikitable" style="margin:auto; clear:both;" | ||
| − | ! Название в конструкторе !! Название в JSON !! Допустимый тип !! | + | ! Название в конструкторе !! Название в JSON !! Допустимый тип !! Что это |
|- | |- | ||
| Описание для шаблона || templateDescription || string || Наименования настроенного шаблона компонента. Не отображается на форме. | | Описание для шаблона || templateDescription || string || Наименования настроенного шаблона компонента. Не отображается на форме. | ||
| + | |- | ||
| + | | Размер || size || small, default,<br> medium, large || Выбор размера компонента. [[Платформа_3V/Формы/Компоненты/Основные/Текстовое_поле#Изменить размер поля|Подробнее]]. | ||
|- | |- | ||
| Заголовок || localizedText. defaultValue || string || Заголовок компонента. Располагается над компонентом. | | Заголовок || localizedText. defaultValue || string || Заголовок компонента. Располагается над компонентом. | ||
| Строка 14: | Строка 16: | ||
| Подсказка || localizedHint.defaultValue || string || Текст всплывающей подсказки. Подсказка всплывает при наведении на компонент | | Подсказка || localizedHint.defaultValue || string || Текст всплывающей подсказки. Подсказка всплывает при наведении на компонент | ||
|- | |- | ||
| − | | | + | | Текст заполнитель || placeholder || string || Текст, который отображается в компоненте до того, как пользователь начал с ним взаимодействовать. |
|- | |- | ||
| − | | | + | | Префикс || prefix || string || Строка, которая ставится в начало введённого значения. |
|- | |- | ||
| − | | | + | | Маска ввода || mask || string || Шаблон ввода значения. Работает только при введении цифр. |
|- | |- | ||
| − | | | + | | Отобразить маску ввода || showMaskTyped || bool || Флаг, при включении которого маска ввода будет отображаться до взаимодействия пользователя с компонентом. |
| + | |- | ||
| + | | Обязательное || hasNullableValue || bool || Флаг, при включении которого поле будет обязательным для заполнения. | ||
|- | |- | ||
| Включено || enable || bool || Флаг, при выключении которого с компонентном нельзя будет взаимодействовать. | | Включено || enable || bool || Флаг, при выключении которого с компонентном нельзя будет взаимодействовать. | ||
|- | |- | ||
| Отображать || visible || bool || Флаг, при включении которого компонент будет отображаться на форме | | Отображать || visible || bool || Флаг, при включении которого компонент будет отображаться на форме | ||
| + | |- | ||
| + | | Источник данных || uiDataSource || int || Создание и выбор источника данных. Для справочника выбирается атрибут. Для отчёта ячейка. | ||
|- | |- | ||
| Выполнить действие <br>при изменении значения || doActionOnChangeValue || bool || Флаг, включении которого изменение в компоненте будет сохраняться автоматически | | Выполнить действие <br>при изменении значения || doActionOnChangeValue || bool || Флаг, включении которого изменение в компоненте будет сохраняться автоматически | ||
| Строка 36: | Строка 42: | ||
</div></div> </br> | </div></div> </br> | ||
| − | == Добавить | + | == Добавить поле == |
Элемент можно добавить через конструктор<br> | Элемент можно добавить через конструктор<br> | ||
[[Файл:Добавление элемента через конструктор.png]] <br clear="both" /><br> | [[Файл:Добавление элемента через конструктор.png]] <br clear="both" /><br> | ||
== Настроить заголовок == | == Настроить заголовок == | ||
| − | Для настройки заголовка достаточно задать его в настройке "Заголовок". | + | Для настройки заголовка достаточно задать его в настройке "Заголовок".<br> |
[[Файл:инпут заголовок.png]]<br clear="both"><br> | [[Файл:инпут заголовок.png]]<br clear="both"><br> | ||
== Настроить подсказку == | == Настроить подсказку == | ||
Для настройки всплывающего окна при наведении на поле достаточно задать его текст в настройке "Подсказка" | Для настройки всплывающего окна при наведении на поле достаточно задать его текст в настройке "Подсказка" | ||
| + | == Изменить текст-заполнитель == | ||
| + | Чтобы до взаимодействия пользователя с элементом в нём отображался требуемый текст следует задать его в настройке "Текст-заполнитель" | ||
| + | |||
| + | [[Файл:Форма. Текстовый компонент.png|слева]] <br clear = "both"> </br> | ||
| − | == Изменить размер | + | == Изменить размер поля == |
Размер элемента следует задавать в настройке "Размер поля". | Размер элемента следует задавать в настройке "Размер поля". | ||
{| class="wikitable" clear:both;" | {| class="wikitable" clear:both;" | ||
| Строка 61: | Строка 71: | ||
|- | |- | ||
|} | |} | ||
| − | == | + | == Типизировать == |
| − | Для того, чтобы <br> | + | Для того, чтобы типизировать ввод в элемент требуется задать предшествующее значение вводимому и маску ввода в настройках "Префикс" и "Маска ввода".<br> |
<br><br> | <br><br> | ||
'''Пример'''<br> | '''Пример'''<br> | ||
| + | Для того, чтобы настроить компонент следующего вида [[Файл:Форма. Текстовый компонент с маской и префиксом.gif]] требуется задать следующие настройки: | ||
| − | + | {| class="wikitable" | |
| + | |- | ||
| + | |+ Настройки компонента | ||
| + | |- | ||
| + | ! Название !! Значение | ||
| + | |- | ||
| + | | Префикс || +7 | ||
| + | |- | ||
| + | | Маска ввода || (000)-000-00-00 | ||
| + | |- | ||
| + | | Отобразить маску ввода || false | ||
| + | |- | ||
| + | |} | ||
== Настроить источник данных == | == Настроить источник данных == | ||
| Строка 75: | Строка 98: | ||
<br> | <br> | ||
== Задать правила видимости и доступности редактирования == | == Задать правила видимости и доступности редактирования == | ||
| − | + | Для того, чтобы настроить правила нужно создать шаблон с определёнными настройками. [[Платформа_3V/Формы/Правила|Подробнее...]] | |
<br> | <br> | ||
== Настроить права доступа == | == Настроить права доступа == | ||
Подробнее о правах доступа можно узнать [[Платформа_3V/Права_доступа/Права_доступа_на_элементы_формы|здесь]]. | Подробнее о правах доступа можно узнать [[Платформа_3V/Права_доступа/Права_доступа_на_элементы_формы|здесь]]. | ||
<br> | <br> | ||
Версия 08:33, 1 октября 2021
{} Текстовое поле - поле ввода коротких текстовых значений.
Описание настроек компонента
| Название в конструкторе | Название в JSON | Допустимый тип | Что это |
|---|---|---|---|
| Описание для шаблона | templateDescription | string | Наименования настроенного шаблона компонента. Не отображается на форме. |
| Размер | size | small, default, medium, large |
Выбор размера компонента. Подробнее. |
| Заголовок | localizedText. defaultValue | string | Заголовок компонента. Располагается над компонентом. |
| Подсказка | localizedHint.defaultValue | string | Текст всплывающей подсказки. Подсказка всплывает при наведении на компонент |
| Текст заполнитель | placeholder | string | Текст, который отображается в компоненте до того, как пользователь начал с ним взаимодействовать. |
| Префикс | prefix | string | Строка, которая ставится в начало введённого значения. |
| Маска ввода | mask | string | Шаблон ввода значения. Работает только при введении цифр. |
| Отобразить маску ввода | showMaskTyped | bool | Флаг, при включении которого маска ввода будет отображаться до взаимодействия пользователя с компонентом. |
| Обязательное | hasNullableValue | bool | Флаг, при включении которого поле будет обязательным для заполнения. |
| Включено | enable | bool | Флаг, при выключении которого с компонентном нельзя будет взаимодействовать. |
| Отображать | visible | bool | Флаг, при включении которого компонент будет отображаться на форме |
| Источник данных | uiDataSource | int | Создание и выбор источника данных. Для справочника выбирается атрибут. Для отчёта ячейка. |
| Выполнить действие при изменении значения |
doActionOnChangeValue | bool | Флаг, включении которого изменение в компоненте будет сохраняться автоматически |
| Действия | action | шаблон | Создание действий на компонент. |
| Правила | enableExpressionIds/visibleExpressionIds | шаблон | Создание правил на компонент. Существуют правила доступности редактирования и видимости. |
Содержание
Добавить поле
Элемент можно добавить через конструктор
Настроить заголовок
Для настройки заголовка достаточно задать его в настройке "Заголовок".
Настроить подсказку
Для настройки всплывающего окна при наведении на поле достаточно задать его текст в настройке "Подсказка"
Изменить текст-заполнитель
Чтобы до взаимодействия пользователя с элементом в нём отображался требуемый текст следует задать его в настройке "Текст-заполнитель"
Изменить размер поля
Размер элемента следует задавать в настройке "Размер поля".
| Название в конструкторе | Название в JSON | Размер в пикселях |
|---|---|---|
| Маленькое | small | 24px. |
| Среднее | medium | 40px |
| Большое | large | 48px |
| По умолчанию | default | 32px |
Типизировать
Для того, чтобы типизировать ввод в элемент требуется задать предшествующее значение вводимому и маску ввода в настройках "Префикс" и "Маска ввода".
Пример
Для того, чтобы настроить компонент следующего вида 
требуется задать следующие настройки:
| Название | Значение |
|---|---|
| Префикс | +7 |
| Маска ввода | (000)-000-00-00 |
| Отобразить маску ввода | false |
Настроить источник данных
Для того, чтобы настроить источник данных нужно создать шаблон и настроить его атрибут. Подробнее...
Настроить действия на изменение значения поля
Для того, чтобы настроить действия нужно создать шаблон с определёнными настройками. Подробнее...
Задать правила видимости и доступности редактирования
Для того, чтобы настроить правила нужно создать шаблон с определёнными настройками. Подробнее...
Настроить права доступа
Подробнее о правах доступа можно узнать здесь.