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>

Другие расширения