Виджет "Набор" (с поддержкой тем)
Виджет "Набор" - это адаптивный виджет, позволяющий отображать серию повторяющихся мэшапов в виде ячеек в наборе. Можно настроить расширенные компоновки и ячейки групп, чтобы облегчить пользователям отображение набора при различных размерах экрана. Чтобы отобразить данные в ячейках набора, необходимо определить таблицу данных с данными для ячеек мэшапа. Можно также настроить поведение загрузки данных, чтобы оптимизировать производительность при загрузке больших наборов данных.
 |
Этот виджет также доступен как веб-компонент в SDK веб-компонентов.
|
Рекомендации
Избегайте выполнения сервисов в каждой ячейке мэшапа в наборе. Для многократного выполнения нескольких сервисов для каждой ячейки в наборе требуется значительное число сетевых запросов. Любые сервисы в мэшапе набора выполняются повторно при инициализации родительского мэшапа, что может привести к существенным проблемам с производительностью при загрузке каждой ячейки. Чтобы предотвратить проблемы с производительностью, выполните сервисы данных в родительских мэшапах, а затем передайте данные во вложенные мэшапы с помощью параметров мэшапа и свойства MashupPropertyBinding. Дополнительные сведения о работе с параметрами см. в разделе Конфигурирование параметров мэшапа.
Щелкните "Поведение события" в ячейках
Ячейки набора могут отображать несколько интерактивных и неинтерактивных виджетов. Если в ячейке щелкнуть интерактивный виджет, обработчик событий проверяет, есть ли у виджета привязанное событие Clicked. Если событие привязано, инициируется событие щелчка виджета. Если событие не привязано, виджет считается неинтерактивным, а вместо него выбирается ячейка. Например, в наборе может отображаться виджет "Диалоговое окно KPI" с дополнительным событием Clicked. После привязки события обработчик событий регистрирует событие и выполняется привязанный сервис или функция. Если событие не привязано, выбирается ячейка набора.
Свойства
|
Имя свойства
|
Описание
|
Базовый тип
|
Значение по умолчанию
|
Связываемое
|
Локализуемое (Д/Н)
|
||
|---|---|---|---|---|---|---|---|
|
Data
|
Источник данных таблицы данных для виджета "Набор".
|
INFOTABLE
|
Д
|
Н
|
|||
|
ItemLoadBehavior
|
Управляет поведением загрузки данных набора. Можно загружать и выгружать данные во время прокрутки пользователем, загружать данные последовательно по требованию или загружать полный набор данных первоначально.
|
STRING
|
Загрузить/выгрузить
|
Н
|
Н
|
||
|
Layout
|
Указывает тип компоновки, который будет использоваться для ячеек набора. Опции: "Гибкая", "Сетка", "Таблица".
|
STRING
|
Гибкая
|
Д
|
Н
|
||
|
Mashup
|
Мэшап, используемый для отображения данных набора.
|
MASHUPNAME
|
Д
|
Н
|
|||
|
Width
|
Задает ширину виджета.
|
NUMBER
|
400
|
Н
|
Н
|
||
|
Height
|
Задает высоту виджета.
|
NUMBER
|
300
|
Н
|
Н
|
||
|
MashupHeight
|
Задает высоту мэшапа набора.
|
NUMBER
|
Д
|
Н
|
|||
|
MashupWidth
|
Задает ширину мэшапа набора.
|
NUMBER
|
Д
|
Н
|
|||
|
MashupWidthField
|
Указывает поле таблицы данных для определения ширины ячейки с помощью сервиса. Значения переопределяют MashupHeight.
|
Столбец таблицы данных
|
Н
|
Н
|
|||
|
MashupHeightField
|
Указывает поле таблицы данных для определения высоты ячейки с помощью сервиса. Значения переопределяют MashupHeight.
|
Столбец таблицы данных
|
Н
|
Н
|
|||
|
UIDField
|
Обязательный. Указывает поле таблицы данных с уникальным идентификатором для каждой ячейки.
|
Столбец таблицы данных
|
Н
|
Н
|
|||
|
LastRowAlignment
|
Управляет выравниванием ячеек в последней строке набора. Опции: По умолчанию, Равномерный интервал, Расстояние между, По левому краю, По центру, По правому краю, Растянуть
|
STRING
|
По умолчанию
|
Н
|
Н
|
||
|
HorizontalAlignment
|
Управляет горизонтальным выравниванием ячеек в строках набора. Опции: Равномерный интервал, Расстояние между, По левому краю, По центру, По правому краю, Растянуть
|
STRING
|
Равномерный интервал
|
Н
|
Н
|
||
|
VerticalAlignment
|
Управляет вертикальным выравниванием ячеек в строках набора. Опции: По верхнему краю, По центру, Растянуть, По нижнему краю
|
STRING
|
По центру
|
Н
|
Н
|
||
|
UniformRowHeight
|
Показывает строки одинаковой высоты.
|
BOOLEAN
|
False
|
Н
|
Н
|
||
|
RowGap
|
Задает интервал между строками набора.
|
NUMBER
|
40
|
Н
|
Н
|
||
|
ColumnGap
|
Задает интервал между столбцами набора.
|
NUMBER
|
40
|
Н
|
Н
|
||
|
SectionGap
|
Задает интервал между разделами набора.
|
NUMBER
|
48
|
Н
|
Н
|
||
|
TopPadding
|
Задает заполнение между верхним краем набора и первой ячейкой.
|
NUMBER
|
24
|
Н
|
Н
|
||
|
BottomPadding
|
Задает заполнение между нижним краем набора и последней ячейкой.
|
NUMBER
|
24
|
Н
|
Н
|
||
|
RightPadding
|
Задает заполнение между правой границей виджета и набором ячеек.
|
NUMBER
|
24
|
Н
|
Н
|
||
|
LeftPadding
|
Задает заполнение между левой границей виджета и набором ячеек.
|
NUMBER
|
0
|
Н
|
Н
|
||
|
MashupBackground
|
Управляет фоном мэшапа набора и всех его контейнеров. Если фон мэшапа является прозрачным, стили, применяемые к фону ячейки, становятся видимыми. Опции: Прозрачный, Видимый
|
STRING
|
Видимый
|
Н
|
Н
|
||
|
MashupNameField
|
Позволяет указать поле таблицы данных, чтобы задать наименование мэшапа с помощью сервиса данных. Это свойство переопределяет свойство мэшапа.
|
Столбец таблицы данных
|
Н
|
Н
|
|||
|
MashupPropertyBinding
|
Сериализованный JSON-объект, ключами которого служат поля таблицы данных, а значениями - параметры мэшапа. Например:
{
"min_temp": "minTemp" } |
JSON
|
Н
|
Н
|
|||
|
MashupGlobalPropertyBinding
|
Сериализованный JSON-объект, ключами которого служат имена глобальных параметров, а значениями - типы данных. Можно привязать эти свойства к виджету набора и отправлять значения в мэшап каждой ячейки.
{
"minTemp": "STRING" } |
JSON
|
Н
|
Н
|
|||
|
SelectedCellMashupField
|
Позволяет указать поле таблицы данных, чтобы задать выбранное состояние каждой ячейки в наборе.
|
Столбец таблицы данных
|
Н
|
Н
|
|||
|
UseMashupDimensions
|
Сопоставляет размер ячейки с размерами мэшапа.
|
BOOLEAN
|
False
|
Н
|
Н
|
||
|
SelectionMode
|
Позволяет управлять числом ячеек, которые пользователи могут выбирать во время выполнения. Опции: Нет, Одна, Несколько
|
STRING
|
Нет
|
Н
|
Н
|
||
|
HasSelectedCells
|
Возвращает значение True, когда в виджете имеются выбранные ячейки.
|
BOOLEAN
|
False
|
Д
|
Н
|
||
|
SelectedCellsCount
|
Возвращает число ячеек, выбранных в представлении набора.
|
NUMBER
|
0
|
Н
|
Н
|
||
|
ScrollToSelectedCell
|
Автоматическая прокрутка до выбранных ячеек.
|
BOOLEAN
|
False
|
Н
|
Н
|
||
|
AutoSelectFirstRow
|
Позволяет автоматически выбирать первую строку при загрузке данных в набор.
|
BOOLEAN
|
False
|
Н
|
Н
|
||
|
SelectedCells
|
Указывает ячейки набора для выбора с помощью таблицы данных.
|
INFOTABLE
|
Д
|
Н
|
|||
|
SelectedCellMashup
|
Указывает альтернативный мэшап для отображения выбранных ячеек в наборе. Этот мэшап должен содержать те же свойства, что и мэшап по умолчанию.
|
Средство выбора мэшапа
|
Д
|
Н
|
|||
|
HandleSelectionUpdates
|
Если включено, виджет отправляет и получает обновления выбора в своем сервисе данных.
|
BOOLEAN
|
True
|
Н
|
Н
|
||
|
CellMenu
|
Указывает определение состояния, используемое для определения меню ячеек, которое появляется при скольжении по ячейкам на сенсорных устройствах. На устройствах без сенсорного интерфейса это меню отображается, если щелкнуть ячейки правой кнопкой мыши.
|
STATEDEFINITION
|
Н
|
Н
|
|||
|
CellMenuIconSize
|
Указывает размер значков в меню ячейки.
|
NUMBER
|
20
|
Н
|
Н
|
||
|
CellTabKeyScope
|
Управляет контекстной областью навигации при взаимодействии с содержимым ячейки с помощью клавиатуры. Опции: Ячейка, Набор, Только элементы. Если для контекстной области задано значение "Ячейка", то при нажатии клавиши TAB выполняется циклический переход по элементам внутри ячейки. Если для контекстной области задан "Набор", то нажатие клавиши TAB возвращает фокус на ячейку после выбора последнего элемента. Выберите Только элементы, чтобы сфокусироваться только на содержимом ячейки и пропустить саму ячейку при переходе между ячейками.
|
STRING
|
Ячейка
|
Н
|
Н
|
||
|
SectionField
|
Указывает поле таблицы данных со значениями идентификаторов, которые можно использовать для группирования ячеек в разделах.
|
INFOTABLE
|
Н
|
Н
|
|||
|
SectionInsetLeft
|
Задает значение левого выносного элемента для разделов при группировке ячеек.
|
NUMBER
|
0
|
Н
|
Н
|
||
|
SectionInsetTop
|
Задает значение верхнего выносного элемента для сечений при группировке ячеек.
|
NUMBER
|
0
|
Н
|
Н
|
||
|
SectionInsetRight
|
Задает значение правого выносного элемента для сечений при группировке ячеек.
|
NUMBER
|
0
|
Н
|
Н
|
||
|
SectionInsetBottom
|
Задает значение нижнего выносного элемента для сечений при группировке ячеек.
|
NUMBER
|
0
|
Н
|
Н
|
||
|
SortField
|
Указывает поле таблицы данных, по которому сортируется содержимое раздела. Сортировка выполняется на стороне клиента и не влияет на таблицу данных источника или другие виджеты, привязанные к набору данных.
|
INFOTABLE
|
Д
|
Н
|
|||
|
SortAscending
|
Сортирует содержимое раздела в порядке возрастания, если включено свойство SortField. По умолчанию разделы сортируются по убыванию.
|
BOOLEAN
|
False
|
Д
|
Н
|
||
|
SectionHeaders
|
Управляет видимостью заголовков разделов при группировке ячеек в наборе. Опции: Нет, Видимый, Закрепленный
|
STRING
|
Нет
|
Н
|
Н
|
||
|
HeaderMashup
|
Определяет мэшап, который будет использоваться для заголовков разделов при группировке ячеек в наборе.
|
MASHUPNAME
|
Нет
|
Н
|
Н
|
||
|
HeaderSectionParam
|
Имя параметра мэшапа заголовка, который получит идентификатор раздела.
|
STRING
|
Н
|
Н
|
|||
|
HeaderHeight
|
Задает высоту заголовков разделов в наборе.
|
NUMBER
|
40
|
Н
|
Н
|
||
|
SectionFooters
|
Управляет видимостью нижних колонтитулов разделов при группировке ячеек в наборе. Опции: Нет, Видимый, Закрепленный
|
STRING
|
Нет
|
Н
|
Н
|
||
|
FooterMashup
|
Определяет мэшап, который будет использоваться для нижнего колонтитула раздела при группировке ячеек в наборе.
|
MASHUPNAME
|
Н
|
Н
|
|||
|
FooterSectionParam
|
Имя параметра мэшапа нижнего колонтитула, который получит идентификатор раздела.
|
STRING
|
Н
|
Н
|
|||
|
FooterHeight
|
Задает высоту нижних колонтитулов разделов при группировке ячеек в наборе.
|
NUMBER
|
40
|
Н
|
Н
|
||
|
EmptyMashup
|
Определяет мэшап, отображаемый, если ячейка в наборе не содержит никаких данных.
|
MASHUPNAME
|
Нет
|
Н
|
Н
|
||
|
Deselect
|
Доступный для связывания сервис, очищающий любой выбор в наборе.
|
Сервис
|
Д
|
Н
|
|||
|
SelectAll
|
Доступный для связывания сервис, который выбирает все ячейки в наборе.
|
Сервис
|
Д
|
Н
|
|||
|
DisableWrapping
|
Если включено, ячейки отображаются в одной строке с горизонтальной полосой прокрутки. Если свойство выключено, ячейки переносятся на новую строку, когда доступного пространства по горизонтали недостаточно для отображения полного набора. Это свойство поддерживается только в том случае, если набор сконфигурирован с помощью режима компоновки Гибкая.
|
BOOLEAN
|
False
|
Н
|
Н
|
События
|
Имя свойства
|
Описание
|
Базовый тип
|
Связываемое
|
Локализуемое (Д/Н)
|
|---|---|---|---|---|
|
CellClicked
|
Событие, инициируемое, если пользователь щелкает ячейку в наборе или касается ее.
|
Событие
|
Д
|
Н
|
|
CellDoubleClicked
|
Событие, инициируемое, если пользователь дважды щелкает ячейку в наборе или дважды касается ее.
|
Событие
|
Д
|
Н
|
|
CellLongClicked
|
Событие, которое инициируется, когда пользователь щелкает и удерживает или касается и удерживает ячейку в наборе дольше 400 миллисекунд.
|
Событие
|
Д
|
Н
|
|
CellRightClicked
|
Событие, которое инициируется, если пользователь щелкает правой кнопкой мыши ячейку в наборе.
|
Событие
|
Д
|
Н
|