Добавление свойств "Пользовательского виджета" в легко редактируемый формат

Описание

При создании "Пользовательского виджета" имеется возможность дополнительной настройки "Пользовательских свойств".

Это дает возможность предоставить Пользователем интерфейс для редактирования настроек "Пользовательских виджетов" без использования кода.

Примеры возможных настроек:

Пользовательский виджетКомментарии
Пользовательский виджет "Картосхема"

На панели справа выделены свойства, которые были настроены разработчиком так при создании виджета.

Пользовательский виджет "Sunkey"

На панели справа выделены свойства, которые были настроены разработчиком так при создании виджета.

Настройка

Чтобы настроить свойства при создании нового Пользовательского виджета, необходимо:

  1. Все необходимые для настроек свойства представить в виде переменных и добавить в "Расширенные свойства (JSON)"
  2. Добавить необходимые для настройки свойства.
    Для этого по каждому свойству:
    1. Кликнуть "Добавить свойство"
    2. Заменить "Название" - именно это название будет отображаться Пользователю в интерфейсе
    3. Заменить "myProperty" - это наименование переменной из "Расширенные свойства (JSON)"
    4. Выбрать тип свойства - в зависимости от выбранного типа будут открываться стандартные элементы настроек (перечень типов см. ниже в "Типы свойств")
    5. Удалить свойство из "Расширенные свойства (JSON)"
  3. Когда добавлены все необходимые свойства в "Пользовательские свойства" и удалены их аналоги их "Расширенные свойства (JSON)", нажмите "Сохранить"
  4. Теперь при добавлении виджета помимо стандартных свойств у него будут отображаться "Пользовательские свойства"

Типы свойств

Тип свойстваОписаниеКак выглядит в интерфейсе

Строка

Ввод текста


Число

Счетчик для настройки числового значения


Логический

Чекбокс для выбора true/false

Выравнивание

Стандартные кнопки выравнивания Платформы

Цвет

Стандартный колорпикер Платформы с палитрой цветов


Шрифт

Стандартный набор шрифтов Платформы

Ограничения

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