Платформа 3V/Формы/Компоненты/Основные/Текстовое поле: различия между версиями
< Платформа 3V | Формы | Компоненты | Основные
Перейти к навигации
Перейти к поиску
| (не показано 6 промежуточных версий 1 участника) | |||
| Строка 1: | Строка 1: | ||
{{DISPLAYTITLE:Текстовое поле}} | {{DISPLAYTITLE:Текстовое поле}} | ||
| − | '''Текстовое поле''' | + | [[Файл:Новый компонент. Текстовое поле.png|слева|400px|border]] <br clear="both" /> |
| − | <div class="NavFrame collapsed"> | + | '''Текстовое поле''' - поле ввода коротких текстовых значений. </br> |
| + | __TOC__ | ||
| + | <br> | ||
| + | <div class="NavFrame collapsed" style="width:900px;"> | ||
<div class="NavHead"> Описание настроек компонента</div> | <div class="NavHead"> Описание настроек компонента</div> | ||
<div class="NavContent"> </br> | <div class="NavContent"> </br> | ||
{| 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: | Строка 19: | ||
| Подсказка || 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 || Флаг, включении которого изменение в компоненте будет сохраняться автоматически | ||
| Строка 33: | Строка 42: | ||
|- | |- | ||
|} | |} | ||
| + | </br> | ||
| + | </div></div> | ||
| − | + | == Добавить поле == | |
| − | |||
| − | == Добавить | ||
Элемент можно добавить через конструктор<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;" | ||
| Строка 52: | Строка 65: | ||
! Название в конструкторе !! Название в JSON !! Размер в пикселях | ! Название в конструкторе !! Название в JSON !! Размер в пикселях | ||
|- | |- | ||
| − | | Маленькое || small || 24px | + | | Маленькое || small || 24px |
| + | |- | ||
| + | | По умолчанию || default || 32px | ||
|- | |- | ||
| Среднее|| medium || 40px | | Среднее|| medium || 40px | ||
|- | |- | ||
| Большое || large || 48px | | Большое || large || 48px | ||
| − | |||
| − | |||
|- | |- | ||
|} | |} | ||
| − | == | + | == Типизировать == |
| − | Для того, чтобы <br> | + | Для того, чтобы типизировать ввод в элемент требуется задать предшествующее значение вводимому и маску ввода в настройках "Префикс" и "Маска ввода".<br> |
<br><br> | <br><br> | ||
'''Пример'''<br> | '''Пример'''<br> | ||
| + | Для того, чтобы настроить компонент следующего вида [[Файл:Форма. Текстовый компонент с маской и префиксом.gif]] требуется задать следующие настройки: | ||
| + | {| class="wikitable" | ||
| + | |- | ||
| + | |+ Настройки компонента | ||
| + | |- | ||
| + | ! Название !! Значение | ||
| + | |- | ||
| + | | Префикс || +7 | ||
| + | |- | ||
| + | | Маска ввода || (000)-000-00-00 | ||
| + | |- | ||
| + | | Отобразить маску ввода || false | ||
| + | |- | ||
| + | |} | ||
| + | '''Варианты настройки маски:''' | ||
| + | {| class="wikitable" | ||
| + | |- | ||
| + | ! Описание !! Обозначение | ||
| + | |- | ||
| + | | русские буквы и цифры || F | ||
| + | |- | ||
| + | | только русские буквы || W | ||
| + | |- | ||
| + | | только маленькие русские буквы || r | ||
| + | |- | ||
| + | | только большие русские буквы || R | ||
| + | |- | ||
| + | | русские и английские буквы и цифры || C | ||
| + | |- | ||
| + | | только русские и английские буквы || G | ||
| + | |- | ||
| + | | только большие русские и английские буквы || V | ||
| + | |- | ||
| + | | только маленькие русские и английские буквы || v | ||
| + | |} | ||
== Настроить источник данных == | == Настроить источник данных == | ||
| Строка 75: | Строка 123: | ||
<br> | <br> | ||
== Задать правила видимости и доступности редактирования == | == Задать правила видимости и доступности редактирования == | ||
| − | + | Для того, чтобы настроить правила нужно создать шаблон с определёнными настройками. [[Платформа_3V/Формы/Правила|Подробнее...]] | |
<br> | <br> | ||
== Настроить права доступа == | == Настроить права доступа == | ||
Подробнее о правах доступа можно узнать [[Платформа_3V/Права_доступа/Права_доступа_на_элементы_формы|здесь]]. | Подробнее о правах доступа можно узнать [[Платформа_3V/Права_доступа/Права_доступа_на_элементы_формы|здесь]]. | ||
<br> | <br> | ||
Текущая версия на 12:51, 6 декабря 2022
Текстовое поле - поле ввода коротких текстовых значений.
Содержание
Описание настроек компонента
| Название в конструкторе | Название в 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 |
| По умолчанию | default | 32px |
| Среднее | medium | 40px |
| Большое | large | 48px |
Типизировать
Для того, чтобы типизировать ввод в элемент требуется задать предшествующее значение вводимому и маску ввода в настройках "Префикс" и "Маска ввода".
Пример
Для того, чтобы настроить компонент следующего вида 
требуется задать следующие настройки:
| Название | Значение |
|---|---|
| Префикс | +7 |
| Маска ввода | (000)-000-00-00 |
| Отобразить маску ввода | false |
Варианты настройки маски:
| Описание | Обозначение |
|---|---|
| русские буквы и цифры | F |
| только русские буквы | W |
| только маленькие русские буквы | r |
| только большие русские буквы | R |
| русские и английские буквы и цифры | C |
| только русские и английские буквы | G |
| только большие русские и английские буквы | V |
| только маленькие русские и английские буквы | v |
Настроить источник данных
Для того, чтобы настроить источник данных нужно создать шаблон и настроить его атрибут. Подробнее...
Настроить действия на изменение значения поля
Для того, чтобы настроить действия нужно создать шаблон с определёнными настройками. Подробнее...
Задать правила видимости и доступности редактирования
Для того, чтобы настроить правила нужно создать шаблон с определёнными настройками. Подробнее...
Настроить права доступа
Подробнее о правах доступа можно узнать здесь.