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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
 
(не показано 5 промежуточных версий 1 участника)
Строка 1: Строка 1:
 
{{DISPLAYTITLE:Кнопка}}
 
{{DISPLAYTITLE:Кнопка}}
 
'''Кнопка''' - компонент представляющий собой командную кнопку, с помощью которой пользователь может вызывать выполнение какого-либо действия.
 
'''Кнопка''' - компонент представляющий собой командную кнопку, с помощью которой пользователь может вызывать выполнение какого-либо действия.
 +
[[Файл:Новый компонент.Кнопка.png|слева|450px|border]] <br clear="both" /><br>
 
<div class="NavFrame collapsed">
 
<div class="NavFrame collapsed">
 
   <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 !! Допустимый тип !! Описание
Строка 18: Строка 18:
 
| Размер ||  size  || small, default,<br> medium, large || Выбор размера компонента. [[Платформа_3V/Формы/Компоненты/Основные/Кнопка#Изменить размер кнопки|Подробнее...]].
 
| Размер ||  size  || small, default,<br> medium, large || Выбор размера компонента. [[Платформа_3V/Формы/Компоненты/Основные/Кнопка#Изменить размер кнопки|Подробнее...]].
 
|-
 
|-
| Иконка ||  faIcon || string ||  Иконка на кнопку. Источник [https://fonts.google.com/icons?selected=Material+Icons Material Icons]. [[Платформа_3V/Формы/Компоненты/Основные/Кнопка#Настроить иконку|Подробнее...]].
+
| Иконка ||  icon || string ||  Иконка на кнопку. Источник [https://fonts.google.com/icons?selected=Material+Icons Material Icons]. [[Платформа_3V/Формы/Компоненты/Основные/Кнопка#Настроить иконку|Подробнее...]].
 
|-
 
|-
| Расположение иконки ||  iconPosition|| left, right|| Расположение иконки в области кнопки.  
+
| Расположение иконки ||  iconPosition|| left, top|| Расположение иконки в области кнопки.  
 
|-
 
|-
 
| Включено || enable  || bool || Флаг, при выключении которого с компонентном нельзя будет взаимодействовать.
 
| Включено || enable  || bool || Флаг, при выключении которого с компонентном нельзя будет взаимодействовать.
Строка 68: Строка 68:
 
| Маленькая ||  small || 24px || [[Файл:Кнопка.Маленькая.png]]
 
| Маленькая ||  small || 24px || [[Файл:Кнопка.Маленькая.png]]
 
|-
 
|-
| По умолчанию ||  default || 32px || [[Файл:Кнопка.По умолчанию.png]]
+
| По умолчанию ||  default || 32px || [[Файл:Кнопка.По_умолчанию.png]]
 
|-
 
|-
 
| Средняя||  medium || 40px || [[Файл:Кнопка.Средняя.png]]
 
| Средняя||  medium || 40px || [[Файл:Кнопка.Средняя.png]]
Строка 77: Строка 77:
 
== Настроить иконку ==
 
== Настроить иконку ==
 
Для того, чтобы выбрать иконку следует задать её наименование из [https://fonts.google.com/icons?selected=Material+Icons Material Icons]. Расположение иконки может быть перед её заголовком или над ним. Если заголовка нет, то иконка располагается в центре кнопки.<br>
 
Для того, чтобы выбрать иконку следует задать её наименование из [https://fonts.google.com/icons?selected=Material+Icons Material Icons]. Расположение иконки может быть перед её заголовком или над ним. Если заголовка нет, то иконка располагается в центре кнопки.<br>
<br><br>
+
 
 +
== Настроить действия на кнопку ==
 +
Для того, чтобы настроить действия нужно создать шаблон с определёнными настройками. [[Платформа_3V/Формы/Действия|Подробнее...]]
 +
<br>
 +
Но кнопке можно настроить следующие действия:
 +
#[[Платформа 3V/Формы/Действия/Открытие модального окна|<font style="color: #CC2200">Открыть модальное окно</font>]]
 +
#[[Платформа 3V/Формы/Действия/Расчет методики|<font style="color: #0645AD">Рассчитать методику</font>]]
 +
#[[Платформа 3V/Формы/Действия/Обновление источника|<font style="color: #0645AD">Обновить источник</font>]]
 +
#[[Платформа 3V/Формы/Действия/Создание справочника|<font style="color: #0645AD">Создать справочник</font>]]
 +
#[[Платформа 3V/Формы/Действия/Расчет элемента|<font style="color: #0645AD">Установить значение в элемент</font>]]
 +
#[[Платформа 3V/Формы/Действия/Выставление значения в строка-столбец пивота|<font style="color: #0645AD">Установить значение в ячейку отчета</font>]]
 +
#[[Платформа 3V/Формы/Действия/Сохранение источников|<font style="color: #0645AD">Сохранить</font>]]
 +
##[[Платформа_3V/Формы/Компоненты/Основные/Кнопка/Сохранение (Кнопка 'Сохранить')|<font style="color: #0645AD">Кнопка "Сохранить"</font>]]
 +
#[[Платформа 3V/Формы/Действия/Экспорт|<font style="color: #0645AD">Экспорт</font>]]
 +
##[[Платформа 3V/Формы/Действия/Экспорт/Задание вычислимых названий|<font style="color: #0645AD">Задать вычислимые названия</font>]]
 +
#[[Платформа 3V/Формы/Действия/Открытие ссылки|<font style="color: #0645AD">Открыть ссылку</font>]]
 +
#[[Платформа 3V/Формы/Действия/Выполнение пользовательского действия|<font style="color: #CC2200">Выполнить пользовательское действие</font>]]
 +
##[[Платформа_3V/Формы/Компоненты/Основные/Кнопка/Кнопка 'Cброс отметки'|<font style="color: #0645AD">Кнопка 'Cброс отметки'</font>]]
 +
#[[Платформа 3V/Формы/Действия/Удаление_элемента_справочника|<font style="color: #0645AD">Удалить элемент справочника</font>]]
 +
#[[Платформа 3V/Формы/Действия/Удаление строки отчёта|<font style="color: #0645AD">Удалить строку в отчёта</font>]]
 +
#[[Платформа 3V/Формы/Действия/Создание нового элемента справочника|<font style="color: #0645AD">Добавить элемент в справочник</font>]]
 +
#[[Платформа 3V/Формы/Действия/Выставление значения в источник|<font style="color: #0645AD">Выставить значение в источник</font>]]
 +
#[[Платформа 3V/Формы/Действия/Выбор следующего или предыдущего элемента справочника|<font style="color: #0645AD">Выбрать следующий или предыдущий элемент справочника</font>]]
 +
#[[Платформа 3V/Формы/Действия/Подмена источника в контроле|<font style="color: #0645AD">Подменить источник в контроле</font>]]
 +
#[[Платформа 3V/Формы/Действия/Выполнение SQL запроса|<font style="color: #0645AD">Выполнить SQL запрос</font>]]
 +
 
 +
=== Настроить сообщение для подтверждения действия ===
 +
Для того, чтобы перед выполнением настроенного действия произошло подтверждение нажатия на кнопку пользователем, необходимо выполнить следующую настройку в элементе "Кнопка":
 +
<syntaxhighlight lang="JSON" line>
 +
...
 +
  "actionConfirmation": {
 +
        "message": null,
 +
        "localizedMessage": {
 +
          "defaultValue": "Вы уверены, что необходимо выполнить действие?",
 +
          "items": [
 +
            {
 +
              "language": "ru",
 +
              "value": "Вы уверены, что необходимо выполнить действие?"
 +
            },
 +
            {
 +
              "language": "en",
 +
              "value": "Are you sure you need to take an action?"
 +
            }
 +
          ]
 +
        },
 +
      "conditionExpressionId": null
 +
      },
 +
...
 +
</syntaxhighlight>
 +
 
 +
{| class="wikitable"
 +
|-
 +
! Свойство !! Описание
 +
|-
 +
| message|| Сообщение
 +
|-
 +
| localizedMessage|| Локализованное сообщение (при необходимости)
 +
|-
 +
| conditionExpressionId|| Условие отображения подтверждения при нажатии на кнопку - рассчитывается с помощью [[Платформа_3V/Формы/Выражения|'''выражения''']]. Выражение должно иметь значение (true или false)
 +
|}
 +
 
 +
== Задать правила видимости и доступности редактирования ==
 +
Для того, чтобы настроить правила нужно создать шаблон с определёнными настройками. [[Платформа_3V/Формы/Правила|Подробнее...]]
 +
<br>
 +
== Настроить права доступа ==
 +
Подробнее о правах доступа можно узнать [[Платформа_3V/Права_доступа/Права_доступа_на_элементы_формы|здесь]].
 +
<br>

Текущая версия на 11:18, 14 декабря 2021

Кнопка - компонент представляющий собой командную кнопку, с помощью которой пользователь может вызывать выполнение какого-либо действия.

Новый компонент.Кнопка.png




Добавить кнопку

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

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

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

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

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

Настроить тип кнопки

Соответствие типа
Название в конструкторе Название в JSON Внешний вид
Главная main Кнопка.Главная.png
Базовая basic Кнопка. Базовая.png
Текстовая text Кнопка.Текстовая.png


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

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

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

Настроить иконку

Для того, чтобы выбрать иконку следует задать её наименование из Material Icons. Расположение иконки может быть перед её заголовком или над ним. Если заголовка нет, то иконка располагается в центре кнопки.

Настроить действия на кнопку

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

  1. Открыть модальное окно
  2. Рассчитать методику
  3. Обновить источник
  4. Создать справочник
  5. Установить значение в элемент
  6. Установить значение в ячейку отчета
  7. Сохранить
    1. Кнопка "Сохранить"
  8. Экспорт
    1. Задать вычислимые названия
  9. Открыть ссылку
  10. Выполнить пользовательское действие
    1. Кнопка 'Cброс отметки'
  11. Удалить элемент справочника
  12. Удалить строку в отчёта
  13. Добавить элемент в справочник
  14. Выставить значение в источник
  15. Выбрать следующий или предыдущий элемент справочника
  16. Подменить источник в контроле
  17. Выполнить SQL запрос

Настроить сообщение для подтверждения действия

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

 1 ...
 2    "actionConfirmation": {
 3         "message": null,
 4         "localizedMessage": {
 5           "defaultValue": "Вы уверены, что необходимо выполнить действие?",
 6           "items": [
 7             {
 8               "language": "ru",
 9               "value": "Вы уверены, что необходимо выполнить действие?"
10             },
11             {
12               "language": "en",
13               "value": "Are you sure you need to take an action?"
14             }
15           ]
16         },
17        "conditionExpressionId": null
18       },
19 ...
Свойство Описание
message Сообщение
localizedMessage Локализованное сообщение (при необходимости)
conditionExpressionId Условие отображения подтверждения при нажатии на кнопку - рассчитывается с помощью выражения. Выражение должно иметь значение (true или false)

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

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

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

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