jQuery UI API - Виджет Menu
Категории
Использование
Описание:Меню с поддержкой тем для навигации с помощью мыши и клавиатуры.
Добавлено в версии:1.9
Меню можно создавать из любой допустимой разметки, при условии, что элементы имеют строгие отношения родитель/потомок и каждый пункт меню имеет якорь. Наиболее распространённый элемент — неупорядоченный список (<ul>):
<ul id="menu">
<li><a href="../index.html">Item 1</a></li>
<li><a href="../index.html">Item 2</a></li>
<li><a href="../index.html">Item 3</a>
<ul>
<li><a href="../index.html">Item 3-1</a></li>
<li><a href="../index.html">Item 3-2</a></li>
<li><a href="../index.html">Item 3-3</a></li>
<li><a href="../index.html">Item 3-4</a></li>
<li><a href="../index.html">Item 3-5</a></li>
</ul>
</li>
<li><a href="../index.html">Item 4</a></li>
<li><a href="../index.html">Item 5</a></li>
</ul>
Если используется не-<ul>/<li>структура, чтобы использовать один и тот же элемент для меню и пунктов меню, используйтеmenusопция для различения этих двух элементов, напримерmenus: "div.menuElement"。
Вы можете, добавивui-state-disabledclass к элементу, отключите любой пункт меню.
Иконки
Чтобы добавить иконки в меню, добавьте иконку в разметку:
<ul id="menu"> <li><a href="../index.html"><span class="ui-icon ui-icon-disk"></span>Save</a></li> </ul>
Меню автоматически добавляет необходимые отступы для пунктов без иконок.
Разделители
Элементы-разделители можно создать, включив пункт меню без ссылки, содержащий только пробелы/дефисы:
<ul id="menu"> <li><a href="../index.html">Item 1</a></li> <li>-</li> <li><a href="../index.html">Item 2</a></li> </ul>
Взаимодействие с клавиатурой
- ENTER/SPACE: Выполнить действие пункта меню в фокусе, возможно, открыв подменю.
- UP: Переместить фокус на предыдущий пункт меню.
- DOWN: Переместить фокус на следующий пункт меню.
- RIGHT: Открыть подменю, если доступно.
- LEFT: Закрыть текущее подменю и переместить фокус на родительский пункт меню. Если фокус не находится на подменю, ничего не делать.
- ESCAPE: Закрыть текущее подменю и переместить фокус на родительский пункт меню. Если фокус не находится на подменю, ничего не делать.
Введите букву, чтобы переместить фокус на первый пункт, начинающийся с этой буквы. Повторение одного и того же символа циклически перебирает совпадающие пункты. Ввод нескольких символов за короткий промежуток времени сопоставляется с введёнными символами.
Отключенные элементы могут получать фокус клавиатуры, но не допускают никакого взаимодействия.
Темы оформления
Виджет меню используетjQuery UI CSS Frameworkдля определения стилизации своего внешнего вида и поведения. Если вам нужно использовать стили, специфичные для меню, можно использовать следующие имена CSS-классов:
ui-menu: Внешний контейнер меню. Если меню содержит значки, этот элемент также будет иметьui-menu-iconsкласс.ui-menu-item: Контейнер для одного пункта меню.ui-menu-icon: С помощьюiconsопция для настройки значка подменю.
ui-menu-divider: Элемент-разделитель между пунктами меню.
Зависимости
Дополнительные примечания
- Этот виджет требует некоторого функционального CSS для работы. Если вы создаете собственную тему, используйте CSS-файл, специфичный для виджета, в качестве отправной точки.
Примеры
Простое меню jQuery UI.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>菜单部件(Menu Widget)演示</title>
<link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
<style>
.ui-menu {
width: 200px;
}
</style>
<script src="//code.jquery.com/jquery-1.10.2.js"></script>
<script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
<ul id="menu">
<li><a href="../index.html">Item 1</a></li>
<li><a href="../index.html">Item 2</a></li>
<li><a href="../index.html">Item 3</a>
<ul>
<li><a href="../index.html">Item 3-1</a></li>
<li><a href="../index.html">Item 3-2</a></li>
<li><a href="../index.html">Item 3-3</a></li>
<li><a href="../index.html">Item 3-4</a></li>
<li><a href="../index.html">Item 3-5</a></li>
</ul>
</li>
<li><a href="../index.html">Item 4</a></li>
<li><a href="../index.html">Item 5</a></li>
</ul>
<script>
$( "#menu" ).menu();
</script>
</body>
</html>
Другие расширения