jQuery UI API - Menü-Widget

Kategorien

小部件

Nutzung

Beschreibung:Ein anpassbares Menü zur Navigation mit Maus- und Tastaturinteraktion.

添加版本:1.9

Menüs können aus jedem gültigen Markup erstellt werden, solange die Elemente eine strikte Eltern-/Kind-Beziehung aufweisen und jedes Menüelement einen Anker hat. Das gebräuchlichste Element ist eine ungeordnete Liste (<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>

Wenn Sie eine Nicht-<ul>/<li>Struktur, um dasselbe Element für das Menü und die Menüelemente zu verwenden, nutzen Sie diemenusOption, um zwischen den beiden Elementen zu unterscheiden, zum Beispielmenus: "div.menuElement"。

Sie können, indem Sie hinzufügenui-state-disabledclass zu einem Element hinzufügen, um einen beliebigen Menüeintrag zu deaktivieren.

Symbole

Um dem Menü Symbole hinzuzufügen, fügen Sie das Symbol im Markup ein:

<ul id="menu">
  <li><a href="../index.html"><span class="ui-icon ui-icon-disk"></span>Save</a></li>
</ul>

Das Menü fügt Einträgen ohne Symbole automatisch den erforderlichen Innenabstand hinzu.

Trennelemente

Trennelemente können erstellt werden, indem ein nicht verlinkter Menüeintrag eingefügt wird, der nur Leerzeichen/Bindestriche enthält:

<ul id="menu">
  <li><a href="../index.html">Item 1</a></li>
  <li>-</li>
  <li><a href="../index.html">Item 2</a></li>
</ul>

Tastaturinteraktion

  • EINGABE/LEERTASTE: Führt die Aktion des fokussierten Menüeintrags aus, möglicherweise wird ein Untermenü geöffnet.
  • NACH OBEN: Verschiebt den Fokus zum vorherigen Menüeintrag.
  • NACH UNTEN: Verschiebt den Fokus zum nächsten Menüeintrag.
  • NACH RECHTS: Öffnet das Untermenü, falls verfügbar.
  • NACH LINKS: Schließt das aktuelle Untermenü und verschiebt den Fokus zum übergeordneten Menüeintrag. Wenn der Fokus nicht auf einem Untermenü liegt, wird nichts getan.
  • ESCAPE: Schließt das aktuelle Untermenü und verschiebt den Fokus zum übergeordneten Menüeintrag. Wenn der Fokus nicht auf einem Untermenü liegt, wird nichts getan.

Geben Sie einen Buchstaben ein, um den Fokus auf den ersten Eintrag zu verschieben, der mit diesem Buchstaben beginnt. Wenn Sie dasselbe Zeichen wiederholen, wird durch die übereinstimmenden Einträge gewechselt. Wenn Sie innerhalb eines kurzen Zeitraums weitere Zeichen eingeben, erfolgt ein Abgleich mit den eingegebenen Zeichen.

Deaktivierte Elemente können den Tastaturfokus erhalten, erlauben jedoch keine Interaktion.

主题

Das Menü-Widget verwendet dasjQuery UI CSS Framework, um das Styling seines Erscheinungsbilds und Verhaltens zu definieren. Wenn Sie menüspezifische Stile verwenden müssen, können die folgenden CSS-Klassennamen verwendet werden:

  • ui-menu: Der äußere Container des Menüs. Wenn das Menü Symbole enthält, hat dieses Element außerdem eineui-menu-icons -Klasse.
    • ui-menu-item: Der Container für einen einzelnen Menüpunkt.
      • ui-menu-icon: Über dieiconsOption zum Festlegen des Untermenü-Symbols.
    • ui-menu-divider: Ein Trennzeichen-Element zwischen Menüpunkten.

Abhängigkeiten

Zusätzliche Hinweise

  • Dieses Widget benötigt funktionales CSS, um zu funktionieren. Wenn Sie ein benutzerdefiniertes Theme erstellen, verwenden Sie die widgetspezifische CSS-Datei als Ausgangspunkt.

Beispiele

Ein einfaches jQuery UI-Menü.

<!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>

Andere Erweiterungen