Платформа 3V/Формы/Компоненты/Основные/Текстовое поле: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 1: Строка 1:
 +
{}
 
'''Текстовое поле''' - поле ввода коротких текстовых значений.  
 
'''Текстовое поле''' - поле ввода коротких текстовых значений.  
 +
<div class="NavFrame collapsed">
 +
  <div class="NavHead"> Описание настроек компонента</div>
 +
  <div class="NavContent"> </br>
  
−
{| class="wikitable"
+
{| class="wikitable" style="margin:auto; clear:both;"
−
|+ ну это
+
! Название в конструкторе !! Название в JSON !! Допустимый тип !! Что это
 
|-
 
|-
−
! Название в конструкторе !! Внешний вид !! Название в JSON !! Допустимый тип !! Что это
+
| Описание для шаблона  || templateDescription || string || Наименования настроенного шаблона компонента. Не отображается на форме.
 
|-
 
|-
−
| Описание для шаблона || [[Файл:Конструктор. Описание для шаблона.png|безрамки|центр]] || templateDescription || string || Наименования настроенного шаблона компонента. Не отображается на форме.
+
| Размер || size || small, default,<br> medium, large || Выбор размера компонента. [[Платформа_3V/Формы/Компоненты/Основные/Текстовое_поле#Изменить размер поля|Подробнее]].
 
|-
 
|-
−
| Размер || [[Файл:Конструктор. Размер.png|300px|центр]]  || size || small, default,<br> medium, large || Выбор размера компонента. [[Платформа_3V/Формы/Компоненты/Основные/Текстовое_поле# Подробнее]].
+
| Заголовок  || localizedText. defaultValue || string || Заголовок компонента. Располагается над компонентом.
 
|-
 
|-
−
| Заголовок || [[Файл:Конструктор. Заголовок.png|безрамки|центр]] || localizedText. defaultValue || string || Заголовок компонента. Располагается над компонентом.
+
| Подсказка ||  localizedHint.defaultValue || string || Текст всплывающей подсказки. Подсказка всплывает при наведении на компонент
 
|-
 
|-
−
| Подсказка || [[Файл:Конструктор. Подсказка.png|безрамки|центр]] ||  localizedHint.defaultValue || string || Текст всплывающей подсказки. Подсказка всплывает при наведении на компонент
+
| Текст заполнитель || placeholder || string || Текст, который отображается в компоненте до того, как пользователь начал с ним взаимодействовать.
 
|-
 
|-
−
| Текст заполнитель || [[Файл:Конструктор. Текст заполнитель.png|безрамки|центр]]  || placeholder || string || Текст, который отображается в компоненте до того, как пользователь начал с ним взаимодействовать.
+
| Префикс ||  prefix || string || Строка, которая ставится в начало введённого значения.  
 
|-
 
|-
−
| Префикс || [[Файл:Конструктор. Префикс.png|безрамки|центр]]  ||  prefix || string || Строка, которая ставится в начало введённого значения.  
+
| Маска ввода ||  mask || string || Шаблон ввода значения. Работает только при введении цифр.
 
|-
 
|-
−
| Маска ввода || [[Файл:Конструктор. Маска ввода.png|безрамки|центр]]  ||  mask || string || Шаблон ввода значения. Работает только при введении цифр.
+
| Отобразить маску ввода ||  showMaskTyped || bool || Флаг, при включении которого маска ввода будет отображаться до взаимодействия пользователя с компонентом.
 
|-
 
|-
−
| Отобразить маску ввода || [[Файл:Конструктор. Отобразить маску ввода.png|безрамки|центр]]  ||  showMaskTyped || bool || Флаг, при включении которого маска ввода будет отображаться до взаимодействия пользователя с компонентом.
+
| Обязательное || hasNullableValue || bool || Флаг, при включении которого поле будет обязательным для заполнения.
 
|-
 
|-
−
| Обязательное || [[Файл:Конструктор. Обязательное.png|безрамки|центр]]  || hasNullableValue || bool || Флаг, при включении которого поле будет обязательным для заполнения.
+
| Включено || enable || bool || Флаг, при выключении которого с компонентном нельзя будет взаимодействовать.
 
|-
 
|-
−
| Включено || [[Файл:Конструктор. Включено.png|безрамки|центр]]  || enable || bool || Флаг, при выключении которого с компонентном нельзя будет взаимодействовать.
+
| Отображать ||  visible || bool || Флаг, при включении которого компонент будет отображаться на форме
 
|-
 
|-
−
| Отображать || [[Файл:Конструктор. Отображать.png|безрамки|центр]]  ||  visible || bool || Флаг, при включении которого компонент будет отображаться на форме
+
| Источник данных || uiDataSource || int || Создание и выбор источника данных. Для справочника выбирается атрибут. Для отчёта ячейка.
 
|-
 
|-
−
| Источник данных || [[Файл:Конструктор. Источник данных.png|безрамки|центр]]  || uiDataSource || int || Создание и выбор источника данных. Для справочника выбирается атрибут. Для отчёта ячейка.
+
| Выполнить действие <br>при изменении значения ||  doActionOnChangeValue || bool || Флаг, включении которого изменение в компоненте будет сохраняться автоматически
 
|-
 
|-
−
| Выполнить действие <br>при изменении значения || [[Файл:Конструктор. Выполнить действие при изменении значения.png|безрамки|центр]] || doActionOnChangeValue || bool || Флаг, включении которого изменение в компоненте будет сохраняться автоматически
+
| Действия ||  action || шаблон || Создание действий на компонент.
 
|-
 
|-
−
| Действия || [[Файл:Конструктор. Действия.png|безрамки|центр]]  ||  action || шаблон || Создание действий на компонент.
+
| Правила ||  enableExpressionIds/visibleExpressionIds || шаблон || Создание правил на компонент. Существуют правила доступности редактирования и видимости.  
−
|-
 
−
| Правила || [[Файл:Конструктор. Правила.png|безрамки|центр]]  ||  enableExpressionIds/visibleExpressionIds || шаблон || Создание правил на компонент. Существуют правила доступности редактирования и видимости.  
 
 
|-
 
|-
 
|}
 
|}
  
−
{| class="wikitable"
+
</div></div> </br>
−
|+ Размер
+
 
 +
== Добавить поле ==
 +
Элемент можно добавить через конструктор<br>
 +
[[Файл:Добавление элемента через конструктор.png]] <br clear="both" /><br>
 +
== Настроить заголовок ==
 +
Для настройки заголовка достаточно задать его в настройке "Заголовок".<br>
 +
[[Файл:инпут заголовок.png]]<br clear="both"><br>
 +
== Настроить подсказку ==
 +
Для настройки всплывающего окна при наведении на поле достаточно задать его текст в настройке "Подсказка"
 +
== Изменить текст-заполнитель ==
 +
Чтобы до взаимодействия пользователя с элементом в нём отображался требуемый текст следует задать его в настройке "Текст-заполнитель"
 +
== Изменить размер поля ==
 +
Размер элемента следует задавать в настройке "Размер поля".
 +
{| class="wikitable" clear:both;"
 +
|+ Соответствие размера
 
|-
 
|-
 
! Название в конструкторе !! Название в JSON !! Размер в пикселях
 
! Название в конструкторе !! Название в JSON !! Размер в пикселях
Строка 52: Строка 68:
 
|-
 
|-
 
|}
 
|}
−
 
+
== Типизировать ==
−
== Настроить компонент ==
+
Для того, чтобы типизировать ввод в элемент требуется задать предшествующее значение вводимому и маску ввода в настройках "Префикс" и "Маска ввода".<br>
−
Чтобы создать компонент подобного вида: [[Файл:Форма. Текстовый компонент.png]] следует задать следующие настройки:
+
<br><br>
−
{| class="wikitable"
+
'''Пример'''<br>
−
|-
+
Для того, чтобы настроить компонент следующего вида [[Файл:Форма. Текстовый компонент с маской и префиксом.gif]] требуется задать следующие настройки:
−
|+ Настройки компонента
 
−
|-
 
−
! Название !! Значение
 
−
|-
 
−
| Описание для шаблона || Поле для названия организации на русском языке
 
−
|-
 
−
| Размер || По умолчанию
 
−
|-
 
−
| Заголовок || RU:
 
−
|-
 
−
| Подсказка || Организация
 
−
|-
 
−
| Текст заполнитель || Наименование организации
 
−
|-
 
−
|}
 
−
 
 
−
При наведении на компонент будет всплывать текст настройки "Подсказка". В шаблоне JSON будет надпись из настройки "Описание для шаблона", обозначающая для чего нужен компонент.
 
−
<br>
 
−
Для того, чтобы настроить компонент следующего вида [[Файл:Форма. Текстовый компонент с маской и префиксом.gif]] требуется задать Префикс и Маску ввода:
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Строка 82: Строка 79:
 
|-
 
|-
 
! Название !! Значение
 
! Название !! Значение
−
|-
 
−
| Заголовок || Телефон
 
 
|-
 
|-
 
| Префикс || +7  
 
| Префикс || +7  
Строка 93: Строка 88:
 
|}
 
|}
  
−
Чтобы настроить вывод данных в текстовое поле [[Файл:Форма. Текстовый компонент с источником данных.png]] требуется задать [[Платформа_3V/Формы/Источники_данных|источник данных]]. Шаблон источника можно создать через конструктор, вставив идентификатор требуемого объекта платформы.
+
== Настроить источник данных ==
 +
Для того, чтобы настроить источник данных нужно создать шаблон и настроить его атрибут. [[Платформа_3V/Формы/Источники_данных|Подробнее...]]
 +
<br>
 +
== Настроить действия на изменение значения поля ==
 +
Для того, чтобы настроить действия нужно создать шаблон с определёнными настройками. [[Платформа_3V/Формы/Действия|Подробнее...]]
 +
<br>
 +
== Задать правила видимости и доступности редактирования ==
 +
Для того, чтобы настроить правила нужно создать шаблон с определёнными настройками. [[Платформа_3V/Формы/Правила|Подробнее...]]
 +
<br>
 +
== Настроить права доступа ==
 +
Подробнее о правах доступа можно узнать [[Платформа_3V/Права_доступа/Права_доступа_на_элементы_формы|здесь]].
 +
<br>

Версия 13:25, 30 сентября 2021

{} Текстовое поле - поле ввода коротких текстовых значений.


Добавить поле

Элемент можно добавить через конструктор
Добавление элемента через конструктор.png

Настроить заголовок

Для настройки заголовка достаточно задать его в настройке "Заголовок".
инпут заголовок.png

Настроить подсказку

Для настройки всплывающего окна при наведении на поле достаточно задать его текст в настройке "Подсказка"

Изменить текст-заполнитель

Чтобы до взаимодействия пользователя с элементом в нём отображался требуемый текст следует задать его в настройке "Текст-заполнитель"

Изменить размер поля

Размер элемента следует задавать в настройке "Размер поля".

Соответствие размера
Название в конструкторе Название в JSON Размер в пикселях
Маленькое small 24px.
Среднее medium 40px
Большое large 48px
По умолчанию default 32px

Типизировать

Для того, чтобы типизировать ввод в элемент требуется задать предшествующее значение вводимому и маску ввода в настройках "Префикс" и "Маска ввода".


Пример
Для того, чтобы настроить компонент следующего вида Форма. Текстовый компонент с маской и префиксом.gif требуется задать следующие настройки:

Настройки компонента
Название Значение
Префикс +7
Маска ввода (000)-000-00-00
Отобразить маску ввода false

Настроить источник данных

Для того, чтобы настроить источник данных нужно создать шаблон и настроить его атрибут. Подробнее...

Настроить действия на изменение значения поля

Для того, чтобы настроить действия нужно создать шаблон с определёнными настройками. Подробнее...

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

Для того, чтобы настроить правила нужно создать шаблон с определёнными настройками. Подробнее...

Настроить права доступа

Подробнее о правах доступа можно узнать здесь.

Источник — https://wiki.3v-group.net/index.php?title=Платформа_3V/Формы/Компоненты/Основные/Текстовое_поле&oldid=4592