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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
 
(не показано 10 промежуточных версий 1 участника)
Строка 1: Строка 1:
−
'''Текстовое поле''' - поле ввода коротких текстовых значений.  
+
{{DISPLAYTITLE:Текстовое поле}}
 +
[[Файл:Новый компонент. Текстовое поле.png|слева|400px|border]] <br clear="both" />
 +
'''Текстовое поле''' - поле ввода коротких текстовых значений. </br>
 +
__TOC__
 +
<br>
 +
<div class="NavFrame collapsed" style="width:900px;">
 +
  <div class="NavHead"> Описание настроек компонента</div>
 +
  <div class="NavContent"> </br>
  
−
{| class="wikitable"
+
{| class="wikitable" style="margin:auto; clear:both;"
−
|+ ну это
+
! Название в конструкторе !! Название в JSON !! Допустимый тип !! Что это
−
|-
 
−
! Название в конструкторе !! Внешний вид !! Название в JSON !! Допустимый тип !! Что это
 
 
|-
 
|-
−
| Описание для шаблона || [[Файл:Конструктор. Описание для шаблона.png|безрамки|центр]] || templateDescription || string || Наименования настроенного шаблона компонента. Не отображается на форме.
+
| Описание для шаблона  || templateDescription || string || Наименования настроенного шаблона компонента. Не отображается на форме.
 
|-
 
|-
−
| Размер || [[Файл:Конструктор. Размер.png|300px|центр]] || size  || small, default,<br> medium, large || Выбор размера компонента. [[Платформа_3V/Формы/Компоненты/Основные/Текстовое_поле# Подробнее]].
+
| Размер ||  size  || small, default,<br> medium, large || Выбор размера компонента. [[Платформа_3V/Формы/Компоненты/Основные/Текстовое_поле#Изменить размер поля|Подробнее]].
 
|-
 
|-
−
| Заголовок || [[Файл:Конструктор. Заголовок.png|безрамки|центр]] || localizedText. defaultValue  || string || Заголовок компонента. Располагается над компонентом.
+
| Заголовок  || localizedText. defaultValue  || string || Заголовок компонента. Располагается над компонентом.
 
|-
 
|-
−
| Подсказка || [[Файл:Конструктор. Подсказка.png|безрамки|центр]]  ||  localizedHint.defaultValue || string || Текст всплывающей подсказки. Подсказка всплывает при наведении на компонент
+
| Подсказка ||  localizedHint.defaultValue || string || Текст всплывающей подсказки. Подсказка всплывает при наведении на компонент
 
|-
 
|-
−
| Текст заполнитель || [[Файл:Конструктор. Текст заполнитель.png|безрамки|центр]]  || placeholder  || string || Текст, который отображается в компоненте до того, как пользователь начал с ним взаимодействовать.
+
| Текст заполнитель || placeholder  || string || Текст, который отображается в компоненте до того, как пользователь начал с ним взаимодействовать.
 
|-
 
|-
−
| Префикс || [[Файл:Конструктор. Префикс.png|безрамки|центр]]  ||  prefix || string || Строка, которая ставится в начало введённого значения.  
+
| Префикс ||  prefix || string || Строка, которая ставится в начало введённого значения.  
 
|-
 
|-
−
| Маска ввода || [[Файл:Конструктор. Маска ввода.png|безрамки|центр]]  ||  mask || string || Шаблон ввода значения. Работает только при введении цифр.
+
| Маска ввода ||  mask || string || Шаблон ввода значения. Работает только при введении цифр.
 
|-
 
|-
−
| Отобразить маску ввода || [[Файл:Конструктор. Отобразить маску ввода.png|безрамки|центр]]  ||  showMaskTyped || bool || Флаг, при включении которого маска ввода будет отображаться до взаимодействия пользователя с компонентом.
+
| Отобразить маску ввода ||  showMaskTyped || bool || Флаг, при включении которого маска ввода будет отображаться до взаимодействия пользователя с компонентом.
 
|-
 
|-
−
| Обязательное || [[Файл:Конструктор. Обязательное.png|безрамки|центр]]  || hasNullableValue  || bool || Флаг, при включении которого поле будет обязательным для заполнения.
+
| Обязательное || hasNullableValue  || bool || Флаг, при включении которого поле будет обязательным для заполнения.
 
|-
 
|-
−
| Включено || [[Файл:Конструктор. Включено.png|безрамки|центр]]  || enable  || bool || Флаг, при выключении которого с компонентном нельзя будет взаимодействовать.
+
| Включено || enable  || bool || Флаг, при выключении которого с компонентном нельзя будет взаимодействовать.
 
|-
 
|-
−
| Отображать || [[Файл:Конструктор. Отображать.png|безрамки|центр]]  ||  visible || bool || Флаг, при включении которого компонент будет отображаться на форме
+
| Отображать ||  visible || bool || Флаг, при включении которого компонент будет отображаться на форме
 
|-
 
|-
−
| Источник данных || [[Файл:Конструктор. Источник данных.png|безрамки|центр]]  || uiDataSource  || int || Создание и выбор источника данных. Для справочника выбирается атрибут. Для отчёта ячейка.
+
| Источник данных || uiDataSource  || int || Создание и выбор источника данных. Для справочника выбирается атрибут. Для отчёта ячейка.
 
|-
 
|-
−
| Выполнить действие <br>при изменении значения || [[Файл:Конструктор. Выполнить действие при изменении значения.png|безрамки|центр]]  ||  doActionOnChangeValue || bool || Флаг, включении которого изменение в компоненте будет сохраняться автоматически
+
| Выполнить действие <br>при изменении значения ||  doActionOnChangeValue || bool || Флаг, включении которого изменение в компоненте будет сохраняться автоматически
 
|-
 
|-
−
| Действия || [[Файл:Конструктор. Действия.png|безрамки|центр]]  ||  action || шаблон || Создание действий на компонент.
+
| Действия ||  action || шаблон || Создание действий на компонент.
 
|-
 
|-
−
| Правила || [[Файл:Конструктор. Правила.png|безрамки|центр]]  ||  enableExpressionIds/visibleExpressionIds || шаблон || Создание правил на компонент. Существуют правила доступности редактирования и видимости.  
+
| Правила ||  enableExpressionIds/visibleExpressionIds || шаблон || Создание правил на компонент. Существуют правила доступности редактирования и видимости.  
 
|-
 
|-
 
|}
 
|}
 +
</br>
 +
</div></div>
  
−
{| class="wikitable"
+
== Добавить поле ==
−
|+ Размер
+
Элемент можно добавить через конструктор<br>
 +
[[Файл:Добавление элемента через конструктор.png]] <br clear="both" /><br>
 +
== Настроить заголовок ==
 +
Для настройки заголовка достаточно задать его в настройке "Заголовок".<br>
 +
[[Файл:инпут заголовок.png]]<br clear="both"><br>
 +
== Настроить подсказку ==
 +
Для настройки всплывающего окна при наведении на поле достаточно задать его текст в настройке "Подсказка"
 +
== Изменить текст-заполнитель ==
 +
Чтобы до взаимодействия пользователя с элементом в нём отображался требуемый текст следует задать его в настройке "Текст-заполнитель"
 +
 
 +
[[Файл:Форма. Текстовый компонент.png|слева]] <br clear = "both"> </br>
 +
 
 +
== Изменить размер поля ==
 +
Размер элемента следует задавать в настройке "Размер поля".
 +
{| class="wikitable" clear:both;"
 +
|+ Соответствие размера
 
|-
 
|-
 
! Название в конструкторе !! Название в JSON !! Размер в пикселях
 
! Название в конструкторе !! Название в JSON !! Размер в пикселях
 
|-
 
|-
−
| Маленькое ||  small || 24px.
+
| Маленькое ||  small || 24px
 +
|-
 +
| По умолчанию ||  default || 32px
 
|-
 
|-
 
| Среднее||  medium || 40px
 
| Среднее||  medium || 40px
 
|-
 
|-
 
| Большое ||  large ||  48px
 
| Большое ||  large ||  48px
−
|-
 
−
| По умолчанию ||  default || 32px
 
 
|-
 
|-
 
|}
 
|}
 +
== Типизировать ==
 +
Для того, чтобы типизировать ввод в элемент требуется задать предшествующее значение вводимому и маску ввода в настройках "Префикс" и "Маска ввода".<br>
 +
<br><br>
 +
'''Пример'''<br>
 +
Для того, чтобы настроить компонент следующего вида [[Файл:Форма. Текстовый компонент с маской и префиксом.gif]] требуется задать следующие настройки:
  
−
== Настроить компонент ==
 
−
Чтобы создать компонент подобного вида: [[Файл:Форма. Текстовый компонент.png]] следует задать следующие настройки:
 
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Строка 61: Строка 86:
 
! Название !! Значение
 
! Название !! Значение
 
|-
 
|-
−
| Описание для шаблона || Поле для названия организации на русском языке
+
| Префикс || +7
 
|-
 
|-
−
| Размер || По умолчанию
+
| Маска ввода || (000)-000-00-00
 
|-
 
|-
−
| Заголовок || RU:
+
| Отобразить маску ввода || false
−
|-
 
−
| Подсказка || Организация
 
−
|-
 
−
| Текст заполнитель || Наименование организации
 
 
|-
 
|-
 
|}
 
|}
  
−
При наведении на компонент будет всплывать текст настройки "Подсказка". В шаблоне JSON будет надпись из настройки "Описание для шаблона", обозначающая для чего нужен компонент.
+
'''Варианты настройки маски:'''
−
<br>
 
−
Для того, чтобы настроить компонент следующего вида [[Файл:Форма. Текстовый компонент с маской и префиксом.gif]] требуется задать Префикс и Маску ввода:
 
−
 
 
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
−
|+ Настройки компонента
+
! Описание !! Обозначение
 +
|-
 +
| русские буквы и цифры || F
 +
|-
 +
| только русские буквы  || W
 
|-
 
|-
−
! Название !! Значение
+
| только маленькие русские буквы || r
 
|-
 
|-
−
| Заголовок || Телефон
+
| только большие русские буквы || R
 
|-
 
|-
−
| Префикс || +7
+
| русские и английские буквы и цифры || C
 
|-
 
|-
−
| Маска ввода || (000)-000-00-00
+
| только русские и английские буквы || G
 
|-
 
|-
−
| Отобразить маску ввода || false
+
| только большие русские и английские буквы || V
 
|-
 
|-
 +
| только маленькие русские и английские буквы || v
 
|}
 
|}
  
−
Чтобы настроить вывод данных в текстовое поле [[Файл:Форма. Текстовый компонент с источником данных.png]] требуется задать [[Платформа_3V/Формы/Источники_данных|источник данных]]. Шаблон источника можно создать через конструктор, вставив идентификатор требуемого объекта платформы.
+
== Настроить источник данных ==
 +
Для того, чтобы настроить источник данных нужно создать шаблон и настроить его атрибут. [[Платформа_3V/Формы/Источники_данных|Подробнее...]]
 +
<br>
 +
== Настроить действия на изменение значения поля ==
 +
Для того, чтобы настроить действия нужно создать шаблон с определёнными настройками. [[Платформа_3V/Формы/Действия|Подробнее...]]
 +
<br>
 +
== Задать правила видимости и доступности редактирования ==
 +
Для того, чтобы настроить правила нужно создать шаблон с определёнными настройками. [[Платформа_3V/Формы/Правила|Подробнее...]]
 +
<br>
 +
== Настроить права доступа ==
 +
Подробнее о правах доступа можно узнать [[Платформа_3V/Права_доступа/Права_доступа_на_элементы_формы|здесь]].
 +
<br>

Текущая версия на 12:51, 6 декабря 2022

Новый компонент. Текстовое поле.png


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


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

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

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

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

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

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

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

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

Форма. Текстовый компонент.png



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

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

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

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

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


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

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

Варианты настройки маски:

Описание Обозначение
русские буквы и цифры F
только русские буквы W
только маленькие русские буквы r
только большие русские буквы R
русские и английские буквы и цифры C
только русские и английские буквы G
только большие русские и английские буквы V
только маленькие русские и английские буквы v

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

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

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

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

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

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

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

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

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