Виджет "Строка меню" (с поддержкой тем)
 |
Этот виджет является веб-компонентом, доступным для предварительного просмотра. Он включает подмножество элементов из текущего виджета Меню. В будущих выпусках будут добавлены дополнительные функции и поддержка переноса.
|
Используйте виджет "Строка меню", чтобы создать компоновку навигации для решений, которые содержат несколько мэшапов или страниц. Виджет отображает навигационные ссылки как список элементов, доступных пользователю для выбора. Каждый элемент виджета можно сконфигурировать, чтобы пользователи переходили к мэшапу, веб-странице или подменю. Виджет постоянно отображается на левой стороне контейнера верхнего уровня в компоновке. Виджет можно использовать для создания меню с одним или несколькими уровнями навигации. Можно определить пункты меню, создавая сущности меню в Composer или записывая сервисы данных, которые создают меню, управляемые данными. Это позволяет создавать более сложные мэшапы с различными видами на нескольких страницах.
Просмотрите следующее видео о способах определения пунктов меню и использования виджета для замены вложенного мэшапа. Чтобы открыть видео на новой вкладке, щелкните заголовок проигрывателя.
В дополнение к виджету Mashup Builder в строке меню содержатся следующие компоненты:
• Структура данных MenuEntry. Используется для определения таблицы данных для конфигурации строки меню в сервисе данных.
• Шаблон компоновки мэшапа и мастера, содержащий предварительно сконфигурированные контейнеры компоновки и виджет "Строка меню". Используйте этот шаблон для быстрого создания простой компоновки.
Известные проблемы
Пункты меню, сконфигурированные как Выход в пределах сущности меню, поддерживаются только в ThingWorx 9.4 и более поздних версиях. Чтобы использовать эту функцию в более ранних версиях, используйте вместо этого виджет Меню.
Выбор конструкции меню: вложенное или вложенное раздвижное
Можно сконфигурировать виджет, чтобы управлять отображением нескольких уровней навигации в строке меню с помощью свойства SubMenuType. Подменю отображаются одним из двух способов:
• Вложенные меню (по умолчанию) - открываются справа, где каждый уровень навигации отображается как отдельное подменю.
• Разделы вложенного раздвижного меню - открываются вертикально, где у каждого уровня навигации имеется отступ справа.
На следующем рисунке вложенное меню по умолчанию показано на левой стороне, а вложенное раздвижное меню - на правой.
Компактный вид в этих двух виджетах строки меню отключен, а для свойств первичных и дополнительных данных навигации выбраны одни и те же сущности меню. Вложенное меню разделено на три раздела. Верхний раздел используется для отображения основных элементов навигации. В двух разделах внизу отображаются дополнительные элементы навигации и нижний колонтитул. В раздвижном меню дополнительные элементы навигации, которые отображаются над нижним колонтитулом, объединяются в один раздел с основными элементами.
| | Тип строки меню не влияет на раздел нижнего колонтитула. |
Анатомия строки меню
Существует несколько способов конфигурирования виджета "Строка меню". На следующем рисунке меню показано в конфигурации по умолчанию как вложенное меню.
1. Кнопка развертывания/свертывания (необязательна)
2. Основные элементы навигации
3. Маркер перемещения (используется для увеличения или уменьшения ширины строки меню) (необязателен).
4. Дополнительные навигационные элементы (необязательны)
5. Раздел нижнего колонтитула (необязателен)
Элементы верхнего уровня виджета перечисляются вертикально. Виджет содержит несколько разделов, в которых можно отображать пункты меню в соответствии с текущей конфигурацией.
Навигация и фокусирование с помощью клавиатуры
Для перехода между элементами в строке можно использовать следующие традиционные клавиши:
Клавиша | Описание |
|---|---|
TAB SHIFT+TAB | Перемещает фокус на поле в следующий раздел в виджете, на кнопку развертывания/свертывания, дополнительные и основные элементы навигации и нижний колонтитул. Для переноса фокуса на предыдущий раздел нажмите клавиши SHIFT+TAB. |
ENTER ПРОБЕЛ | Развертывает или свертывает родительский элемент, который содержит подменю. Открывает или закрывает раздел. |
Стрелка ВВЕРХ/ВНИЗ | Переводит фокус на следующий или предыдущий пункт меню в текущем разделе. |
Стрелка ВПРАВО/ВЛЕВО | Переводит фокус на следующий или предыдущий уровень в текущем разделе. |
HOME | Переносит фокус на первый элемент в текущем разделе. |
END | Переносит фокус на последний элемент в текущем разделе. |
Свойства виджета
В следующей таблице перечислены свойства виджета "Строка меню".
Свойство | Описание | Базовый тип | Значение по умолчанию | Привязывание | Локализуемое | ||
|---|---|---|---|---|---|---|---|
AlwaysOpen | Скрывает кнопку развертывания/свертывания, используемую для переключения меню между режимами развернутого и компактного видов. Чтобы отключить компактный режим просмотра, задайте для этого свойства значение True. | BOOLEAN | false | Нет | Н | ||
DataSource | Указывает, что использовать при определении пунктов строки меню: таблицу данных или сущность меню. Можно выбрать одну из следующих опций: • Сущность меню - выберите сущность меню с пунктами меню для отображения. Чтобы выбрать сущности меню, используйте свойства PrimaryNavMenu и SecondaryNavMenu. • Таблица данных - привяжите таблицу данных, которая содержит определение пункта меню, из сервиса данных. Необходимо форматировать таблицу данных, используя структуру данных MenuEntry. Чтобы привязать данные меню, используйте свойства PrimaryNavData и SecondaryNavData. | STRING | Таблица данных | Внутр. | Н | ||
DisableResizing | Удаляет маркер перемещения, который позволяет пользователям изменять ширину строки меню во время выполнения. | BOOLEAN | false | Нет | Н | ||
Disabled | Отключает виджет в мэшапе. Отключенные виджеты остаются видимыми, но не являются интерактивными. | BOOLEAN | false | Внутр. | Н | ||
FooterIcon | Значок, отображаемый в разделе нижнего колонтитула. Значок нижнего колонтитула отображается для всех типов меню, включая вложенное меню и вложенное раздвижное меню. | IMAGE | Н/Д | Нет | Н | ||
FooterLinkTargetWindow | Определяет, будет ли ссылка в нижнем колонтитуле открываться в том же окне или в новом окне. Можно задать значение То же окно или Новое окно. | STRING | То же окно | Нет | Н | ||
FooterText | Указывает текст, отображаемый в разделе нижнего колонтитула. | STRING | Н/Д | Внутр. | Да | ||
FooterURL | Задает URL-адрес для перехода при выборе ссылки в нижнем колонтитуле. | STRING | Н/Д | Внутр. | Н | ||
FooterLogo | Логотип для отображения в разделе нижнего колонтитула, когда виджет развертывается.
| IMAGE | Н/Д | Нет | Н | ||
HideAlteranteIcons | Скрывает альтернативные значки, которые отображаются автоматически, если для пунктов меню отсутствуют пользовательские значки. | BOOLEAN | false | Нет | Н | ||
HideFooter | Скрывает раздел нижнего колонтитула в строке меню. | BOOLEAN | false | Внутр. | Н | ||
MashupControl | Управляет навигацией между мэшапами в строке меню во время выполнения. Можно выбрать одну из следующих опций: • Управлять текущим мэшапом - заменяет весь мэшап. • Привязать к параметрам мэшапа - заменяется только вложенный мэшап. Добавляет свойство виджета с именем Mashup, которое необходимо привязать к виджету вложенного мэшапа. | STRING | Управлять текущим мэшапом | Нет | Н | ||
Mashup | Свойство текста, которое содержит имя текущего выбранного мэшапа в строке меню. Используйте это свойство, чтобы указать, какой мэшап будет отображаться в виджете вложенного мэшапа. | STRING | Н/Д | Внешн. | Н | ||
MaxWidth | Максимальная ширина строки меню. Это свойство применяется при развертывании строки меню. | NUMBER | Н/Д | Внутр. | Н | ||
MinWidth | Минимальная ширина строки меню. | NUMBER | Н/Д | Внутр. | Н | ||
PrimaryNavData | Привяжите таблицу данных для определения элементов в основном разделе навигации. Необходимо форматировать таблицу данных, используя структуру данных MenuEntry. | INFOTABLE | Н/Д | Внутр. | Н | ||
PrimaryNavIcons | Отображает значки для основных элементов навигации в строке меню. Значки определяются в выбранной сущности меню или в привязанной таблице данных. | IMAGE | false | Нет | Н | ||
PrimaryNavMaxItems | Задает максимальное число элементов, отображаемых в основном разделе навигации. Дополнительные элементы в сущности меню отображаются в раскрывающемся меню. | NUMBER | 5 | Внутр. | Н | ||
SecondaryNavIcons | Отображает значки для дополнительных элементов навигации в строке меню. Значки определяются в выбранной сущности меню или в привязанной таблице данных. | IMAGE | false | Нет | Н | ||
SecondaryNavData | Привязывает таблицу данных, содержащую элемент для дополнительных элементов навигации. Таблица данных должна быть отформатирована с помощью структуры данных MenuEntry. | INFOTABLE | Н/Д | Внутр. | Н | ||
ShowDataLoading | Привяжите таблицу данных для определения элементов в дополнительном разделе навигации. Необходимо форматировать таблицы данных, используя MenuEntry структуру данных. | BOOLEAN | True | Нет | Н | ||
StayOpenOnSelection | Сохранять разделы раздвижного меню открытыми, если выбран элемент в строке меню.
| BOOLEAN | false | Нет | Н | ||
SubMenuMaxWidth | Максимальная ширина вложенных подменю. | NUMBER | Н/Д | Нет | Н | ||
SubMenuMinWidth | Минимальная ширина вложенных подменю. | NUMBER | Н/Д | Нет | Н | ||
SubMenuType | Управляет способом отображения элементов меню при наличии в виджете нескольких уровней навигации. • Вложенное меню • Вложенное раздвижное меню | STRING | Вложенное меню | Внутр. | Н | ||
TabSequence | Номер последовательности виджета при нажатии клавиши TAB. | NUMBER | Н/Д | Нет | Н | ||
Visible | Управляет видимостью виджета "Строка меню". | BOOLEAN | True | Внутр. | Н |