Виджет "Кнопка" (с поддержкой тем)
Смотрите в следующем видео, как добавить виджет в мэшап и привязать его к сервису данных. Чтобы открыть видео на новой вкладке, щелкните заголовок проигрывателя.
С помощью виджета "Кнопка" можно добавить кнопку в мэшап и инициировать событие при ее нажатии.
 |
Виджет "Кнопка" доступен как стандартный виджет в платформе и как веб-компонент, который можно импортировать из SDK.
|
Исполнения кнопок
• Основные - основные действия, которые пользователи могут выполнять в мэшапе, например кнопка "Удалить". Как правило, мэшап или диалоговое окно должны содержать единственное основное действие, которое могут выполнить пользователи, например кнопка Применить в диалоговом окне подтверждения.
• Дополнительные - дополнительные действия, которые пользователи могут выполнять в мэшапе в дополнение к основному действию, например кнопка Отмена в диалоговом окне подтверждения.
• Третичные - используется для независимых действий, которые не являются обязательными в рабочем процессе.
• Опасные - используется для критических действий, которые могут повлиять на сохраненные данные или привести к необратимым изменениям. Не добавляйте в мэшап несколько опасных кнопок.
• Прозрачные - используйте для действий, которые не являются существенными для всех пользователей и не находятся в основной области внимания в мэшапе. Прозрачные кнопки по внешнему виду похожи на ссылки.
Можно настроить стиль по умолчанию для этих типов кнопок на вкладке Стили в темах стилей мэшапа.
Настойка содержимого кнопки
В виджете можно отображать метки и разные типы значков.
Настройка размера кнопки
Настраивать размеры кнопок можно одним из следующих способов:
• Как адаптивный виджет, корректирующийся на основе своего содержимого.
Выберите один из предопределенных размеров с помощью свойства виджета ButtonSize. Опции: Стандартный, Средний, Большой и Огромный. Изменение размера кнопки влияет на размер шрифта метки и заполнение кнопки меткой и значком. При конструировании мэшапов для устройств с сенсорными экранами рекомендуется использовать Средний размер или больше.
• Как адаптивный виджет, заполняющий контейнер.
Добавьте кнопку в контейнер Flexbox с адаптивным позиционированием в компоновке, затем задайте для свойства виджета ButtonSize значение Заполнить. Кнопка заполняет доступное пространство, если она является единственным виджетом в контейнере. Эту опцию можно использовать при конструировании мэшапов для устройств с сенсорным экраном. Если для кнопки задано заполнение, то для настройки ее размера используйте опции компоновки, доступные для родительского контейнера на панели Компоновка. Например, можно настроить значения заполнения или полей для контейнера кнопок, чтобы добавить интервал между кнопками.
В следующем примере показана стандартная кнопка слева, расширяющаяся для заполнения контейнера во время конструирования при изменении свойства ButtonSize на Заполнить.
Компоновка имеет два контейнера с адаптивным позиционированием, и для обоих контейнеров задано значение заполнения 10 пикселей, чтобы добавить интервал между кнопками. Во время выполнения виджеты кнопки настраивают свой размер в соответствии с доступным пространством для контейнера.
| | При выборе опций Огромный или Заполнить размер значка по умолчанию увеличивается с 18х18 пикселей до 24х24 пикселей. |
• Как виджет с фиксированным размером.
Используйте свойства виджета и свойства стиля, чтобы задать фиксированный размер кнопки. По умолчанию размер кнопки корректируется в соответствии с содержимым кнопки. При применении фиксированного размера содержимое кнопки усекается, если ее содержимое выходит за пределы доступного пространства.
Свойства виджета "Кнопка"
Ниже перечислены свойства виджета "Кнопка".
Значок
• Позволяет задать изображение для значка в виджете "Кнопка".
• Базовый тип: н/д
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
IconPosition
• Задает положение значка относительно метки. Опции: Слева, Справа, Сверху, Снизу
• Базовый тип: STRING
• Значение по умолчанию: Слева
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
Метка
• Текст, отображаемый в метке виджета "Кнопка"
• Базовый тип: STRING
• Значение по умолчанию: Кнопка
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
Disabled
• Используйте это свойство, чтобы отключить виджет в мэшапе. Виджет будет отображаться в мэшапе, но не будет реагировать на нажатие.
• Базовый тип: BOOLEAN
• Значение по умолчанию: False
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
CustomClass
• Позволяет определить CSS в верхнем разделе виджета. Можно ввести несколько классов, разделенных пробелами.
• Базовый тип: STRING
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
ContextID
• Позволяет задать идентификатор для виджета.
• Базовый тип: STRING
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
LabelAlignment
• Позволяет выровнять метку в виджете: по левому краю, по правому краю или по центру.
• Базовый тип: STRING
• Значение по умолчанию: По центру
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
MaxWidth
• Позволяет задать максимальную ширину для виджета "Кнопка".
• Метка кнопки будет обрезана, если ее длина превышает максимальную ширину.
• Примечание. Свойства MaxWidth и Width нельзя использовать совместно.
• Базовый тип: NUMBER
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
MaxHeight
• Задает максимальную высоту кнопки, если для свойства MultiLine задано значение True.
• Базовый тип: NUMBER
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
MultiLine
• Задает продолжение текста метки на другой строке.
• Базовый тип: BOOLEAN
• Значение по умолчанию: False
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
SVGIcon
• Позволяет выбрать значок SVG для отображения в виджете "Кнопка". Для отображения медиаобъекта используйте стандартное свойство Icon.
• Примечание. Настройка свойства Icon имеет более высокий приоритет, чем свойство SVGIcon. Это означает, что если пользователь задал значок с помощью свойства Icon, то он отображается на кнопке.
• Базовый тип: медиаобъект
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
Размер
• Задает размер виджета "Кнопка". Опции: Стандартный, Средний, Большой, Огромный и Заполнить. Если для этого свойства задано значение Заполнить, размер кнопки увеличивается или уменьшается, чтобы вписаться в размер контейнера в компоновке.
• Базовый тип: STRING
• Значение по умолчанию: Стандартный
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
ButtonType
• Позволяет задать тип кнопки.
• Допустимые типы кнопок: "Основная", "Вторичная", "Третичная", "Опасно!" и "Прозрачная". Каждый тип кнопки имеет отличающийся стиль.
• Базовый тип: STRING
• Значение по умолчанию: Первичн.
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
TabSequence
• Последовательность, в которой подсвечиваются виджеты при нажатии пользователем клавиши TAB.
• Базовый тип: NUMBER
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
Clicked
• При щелчке виджета "Кнопка" инициируется событие.
• Базовый тип: н/д
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
TriggerClick
• Доступный для связывания сервис, который инициирует нажатие кнопки.
• Базовый тип: н/д
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
Ширина
• Ширина виджета. Ширина по умолчанию равна ширине метки. Введите значение на панели свойств или измените размер виджета на канве, чтобы задать фиксированный размер ширины.
• Примечание. Свойства MaxWidth и Width нельзя использовать совместно.
• Базовый тип: NUMBER
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
Height
• Высота виджета. Высота по умолчанию равна максимальной ширине метки. Введите значение на панели свойств или измените размер виджета на канве, чтобы задать фиксированную высоту.
• Базовый тип: NUMBER
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
TooltipField
• Задает текст всплывающей подсказки, которая отображается при наведении указателя на виджет.
• Базовый тип: STRING
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н
TooltipIcon
• Задает изображение значка для всплывающей подсказки виджета.
• Можно добавить изображение или указать URL-адрес изображения.
• Базовый тип: медиаобъект
• Значение по умолчанию: н/д
• Доступно для привязки? (Д/Н): Н
• Локализуемое? (Д/Н): Н