Виджет "Отображение свойств" (с поддержкой тем)

Mashup Builder > Виджеты > Стандартные виджеты > Виджет "Отображение свойств" (с поддержкой тем)

Виджет "Отображение свойств" можно использовать для отображения структурированной группы пар ключ-значение в мэшапе.

Виджет "Отображение свойств" доступен как стандартный виджет в платформе и как веб-компонент, который можно импортировать из SDK.

Формат данных

Чтобы отображать свойства в виджете, необходимо привязать сервис данных, который возвращает таблицы данных в соответствии со следующим форматом данных:

	Столбец 1	...	Столбец N
		...
Использование	Определяет имя свойства виджета.	...	Определяет имена свойств для каждого дополнительного столбца.

Каждая строка в таблице данных представляет собой набор значений, которые соответствуют определенным столбцам. Виджет отображает значения строк и имена столбцов в виде пар. Это повторяется для каждой строки в таблице данных. Во время выполнения форматирование виджета задается автоматически на основе базового типа каждого столбца таблицы данных в структуре данных.

Свойства можно группировать под общей меткой, используя свойство GroupNameField. Чтобы отобразить свойства и значения с использованием табличной компоновки, включите свойство TableLayout.

Группировка свойств

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

Например, рассмотрим следующую таблицу данных, которая возвращает свойства двух перечисленных элементов:

Наименование	Макс. скорость	Макс. диапазон	Макс. высота
Тяжелый самолет	450 км/ч	7000 км	8500 м
Легкий самолет	300 км/ч	13000 км	4000 м

Во время выполнения Тяжелый самолет отображается как значение свойства в столбце Наименование.

Чтобы использовать значение столбца "Наименование" в качестве заголовка группы для свойств, задайте свойство виджета GroupNameField:

1. Выберите виджет "Отображение свойств", а затем откройте панель Свойства. Перечисляются свойства виджета.

2. Задайте свойство GroupNameField, выбрав столбец таблицы данных с базовым типом STRING, который будет использоваться в качестве метки для свойств.

Невозможно задать это свойство без привязки таблицы данных к свойству Data.

3. Щелкните Сохранить, а затем просмотрите мэшап.

Во время выполнения значение выбранного столбца используется для группировки всех свойств в каждой строке. На следующем рисунке показан предыдущий пример со сгруппированными свойствами с использованием значений в столбце Имя.

В зависимости от реализации и структуры можно использовать для группировки свойств любые другие элементы из таблицы данных. Это позволяет упорядочивать и сортировать свойства.

Конфигурирование списка свойств

Список свойств для каждой строки сортируется в соответствии с порядком столбцов в таблице данных. Имя столбца определяется определением поля в структуре данных для привязанной таблицы данных. Можно переопределить порядок по умолчанию для свойств с помощью диалогового окна "Конфигурация столбца".

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

• На канве щелкните значок Стрелка вниз

в левом верхнем углу виджета, а затем щелкните Настроить столбцы сетки.

• Щелкните значок

на панели Свойства.

Откроется диалоговое окно конфигурации триггера.

• Чтобы переупорядочить свойства, на левой панели перетащите столбцы, чтобы изменить порядок требуемым образом. Можно перемещать столбцы вверх или вниз в списке. Порядок свойств во время выполнения изменяется соответственно слева направо.

• Чтобы изменить имя свойства, на левой панели выберите столбец, а затем введите новую метку для отображения свойства. Чтобы выбрать лексему локализации, щелкните значок Лексема локализации

, а затем выберите лексему из списка.

• Чтобы скрыть конкретное свойство во время выполнения, снимите флажок Показать.

• При выборе столбца для свойства GroupNameField столбец не перечисляется в списке, а любая существующая конфигурация игнорируется.

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

Свойства виджета

В следующей таблице перечислены свойства виджета.

Имя свойства

Описание

Базовый тип

Значение по умолчанию

Доступно для привязки? (Д/Н)

Локализуемое? (Д/Н)

VerticalMode

Выравнивает данные вдоль вертикальной оси. Если опция не выбрана, отображение по горизонтали.

BOOLEAN

False

Нет

HideGroupTitles

Скрывает метки названия группы.

BOOLEAN

False

Нет

ModalWidth

Задает фиксированную ширину для модального окна.

Задание фиксированной ширины неприменимо в случае модального окна для изображения. Размер окна изменяется автоматически согласно размерам изображения.

NUMBER

Н/Д

Нет

ModalHeight

Задает фиксированную высоту для модального окна.

Задание фиксированной высоты неприменимо в случае модального окна для изображения. Размер окна изменяется автоматически согласно размерам изображения.

NUMBER

Н/Д

Нет

CustomClass

Определяет CSS для верхнего раздела (div) виджета. При вводе нескольких классов отделяйте каждый класс пробелом.

STRING

Н/Д

Нет

DisclosureControl

Задает способ отображения полного значения, когда оно превышает указанные размеры для виджета. Способ отображения полного значения зависит от выбора:

• Отображать кнопку "Инфо" - в модальном окне.

• Использовать ссылку "Показать больше" - использование ссылки Показать больше.

• Отображать многоточие (...) - использование многоточия.

• Изображение всегда открывается в модальном окне по умолчанию.

• При выборе параметра Отображать многоточие (...) свойство ValueMaxHeight ограничивает полное значение и усекает его.

STRING

Показать кнопку "Информация"

Нет

MultiLine

Разбивает текст с переносом на новую строку, если он превышает указанную ширину.

BOOLEAN

False

TextIfNoValue

Задает текст, который появляется, если источник данных виджета не содержит значение.

STRING

Н/Д

Disabled

Отключает виджет в мэшапе. Виджет отображается, но недоступен для использования.

BOOLEAN

False

Нет

TabSequence

Задает последовательность, в которой виджет подсвечивается при нажатии клавиши TAB.

NUMBER

Н/Д

Нет

Data

Источник данных для отображения свойства.

• Каждая строка таблицы данных соответствует одной паре ключ-значение в отображении свойства.

• Каждое поле в строке таблицы данных создает одну запись с меткой и значением в паре ключ-значение, создаваемой из строки.

Метка для каждой записи извлекается из наименования поля, как определено структурой данных таблицы данных.

• Если поле имеет понятное имя, указанное в определении структуры данных, используется это имя.

• Если у поля нет понятного имени, определенного в определении структуры данных, имя поля выбирается из текущей таблицы локализации.

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

Значение каждого поля используется как значения записи. Тип этого значения определяется автоматически типом поля в структуре данных. Нет необходимости конфигурировать эти параметры. Например, поле с типом IMAGE отображается как изображение.

INFOTABLE

Н/Д

Нет

GroupNameField

Указывает поле таблицы данных, которое используется для группировки свойств.

Поле таблицы данных должно иметь базовый тип STRING.

Это свойство выбирает одно из полей в таблице данных для использования в качестве названия группы. Если свойство задано, значение этого поля используется как название группы, и поле не отображается среди других свойств. Если ни одно поле не выбрано как GroupNameField, виджет "Отображение свойств" показывает все поля, а группы не получают названия.

INFOTABLE

Н/Д

Нет

Label

Показывает текст метки для виджета отображения свойств.

STRING

Н/Д

LabelAlignment

Выравнивает метку Слева, Справа или По центру вдоль горизонтальной оси.

STRING

Слева

Нет

LabelType

Задает тип метки как Заголовок, Подзаголовок, Метка или Основной текст.

STRING

Метка

Нет

HideLabel

Скрывает метку в мэшапе.

BOOLEAN

False

Нет

GroupTitleAlignment

Выравнивает метку группы Слева, Справа или По центру вдоль горизонтальной оси.

STRING

Слева

Нет

GroupTitleType

Задает тип для названий групп как Заголовок, Подзаголовок, Метка или Основной текст.

STRING

Метка

Нет

TableLayout

Отображает список свойств и их значений в виде строк и столбцов в табличной компоновке.

BOOLEAN

False

Нет

KeyColumnWidth

Задает ширину столбца, используемого для отображения имен свойств, если виджет сконфигурирован с использованием табличной компоновки.

NUMBER

Н/Д

Нет

ValueMaxWidth

Задает максимальную ширину для значений.

Это свойство доступно только при выборе MultiLine и VerticalMode.

NUMBER

Н/Д

Нет

ValueMaxHeight

Задает максимальную высоту для значений.

Это свойство доступно только при выборе MultiLine и VerticalMode.

NUMBER

Н/Д

Нет

Было ли это полезно?