MDUIDocs
llms.txt-Link kopierenllms-full.txt-Link kopierenDiese Seite als Markdown anzeigenDiese Seite mit ChatGPT besprechenDie gesamte Projektdokumentation mit ChatGPT besprechen
Voreingestellte Farbe
Benutzerdefinierte Farbe
Farbe aus Hintergrundbild extrahieren
Bitte wählen Sie ein Hintergrundbild aus
Erste Schritte
KI-gestützte Entwicklung
Stile
Integration mit Frameworks
Komponenten
Avatar Badge BottomAppBar Button ButtonIcon Card Checkbox Chip CircularProgress Collapse Dialog Divider Dropdown Fab Icon Layout LinearProgress List Menu NavigationBar NavigationDrawer NavigationRail Radio RangeSlider Select SegmentedButton Slider Snackbar Switch Tabs TextField Tooltip TopAppBar
Funktionen
Pakete

Menu

Die Menü-Komponente bietet eine vertikale Liste von Optionen. Das Menü wird angezeigt, wenn der Benutzer mit einem Button oder anderen Bedienelementen interagiert.

Wenn Sie ein Dropdown-Menü implementieren möchten, können Sie die <mdui-dropdown>-Komponente verwenden.

Verwendung

Importieren Sie die Komponenten nach Bedarf:

import 'mdui/components/menu.js';
import 'mdui/components/menu-item.js';

Importieren Sie die TypeScript-Typen der Komponenten nach Bedarf:

import type { Menu } from 'mdui/components/menu.js';
import type { MenuItem } from 'mdui/components/menu-item.js';

Beispiel:

Item 1 Item 2
<mdui-menu>
  <mdui-menu-item>Item 1</mdui-menu-item>
  <mdui-menu-item>Item 2</mdui-menu-item>
</mdui-menu>

Beispiele

Dropdown-Menü

Verwenden Sie die <mdui-dropdown>-Komponente für ein Dropdown-Menü.

Kompaktes Layout

Fügen Sie das Attribut dense zur <mdui-menu>-Komponente hinzu, um ein kompaktes Layout zu erreichen.

Deaktivierte Menüpunkte

Fügen Sie das Attribut disabled zur <mdui-menu-item>-Komponente hinzu, um einen Menüpunkt zu deaktivieren.

Einfachauswahl unterstützen

Setzen Sie das Attribut selects auf single in der <mdui-menu>-Komponente, um die Einfachauswahl zu aktivieren. Der value-Wert von <mdui-menu> ist dann der value-Wert des aktuell ausgewählten <mdui-menu-item>.

Mehrfachauswahl unterstützen

Setzen Sie das Attribut selects auf multiple in der <mdui-menu>-Komponente, um die Mehrfachauswahl zu aktivieren. Der value-Wert von <mdui-menu> ist dann ein Array der value-Werte der aktuell ausgewählten <mdui-menu-item>.

Hinweis: Im Mehrfachauswahl-Modus ist der value-Wert von <mdui-menu> ein Array, das nur über eine JavaScript-Property gelesen und gesetzt werden kann.

Symbol

Über die Attribute icon und end-icon auf der <mdui-menu-item>-Komponente können Sie links bzw. rechts vom Menüpunkt ein Material Icons-Symbol hinzufügen. Mit dem Attribut end-text können Sie rechts Text hinzufügen. Sie können auch über die Slots icon, end-icon und end-text Elemente hinzufügen.

Wenn Sie links Platz für ein Symbol freihalten möchten, um die Ausrichtung mit anderen Menüpunkten beizubehalten, setzen Sie das Attribut icon auf einen leeren String.

Im Einfach- oder Mehrfachauswahl-Modus können Sie das Symbol für den ausgewählten Zustand mit dem Attribut selected-icon oder dem Slot selected-icon festlegen.

Setzen Sie das Attribut href auf der <mdui-menu-item>-Komponente, um den Menüpunkt in einen Link zu verwandeln. Sie können dann auch die Attribute download, target und rel verwenden.

Untermenü

In der <mdui-menu-item>-Komponente können Sie über den Slot submenu die Elemente für das Untermenü angeben.

In der <mdui-menu>-Komponente können Sie mit dem Attribut submenu-trigger festlegen, wie das Untermenü ausgelöst wird.

Wenn submenu-trigger auf hover gesetzt ist, können Sie mit den Attributen submenu-open-delay und submenu-close-delay in der <mdui-menu>-Komponente die Verzögerung beim Öffnen und Schließen des Untermenüs festlegen.

Benutzerdefinierter Inhalt

In der <mdui-menu-item>-Komponente können Sie den Slot custom verwenden, um den Inhalt des Menüpunkts vollständig anzupassen.

AttributPropertyReflectTypStandard

Der Wert des Menüpunkts.

Deaktiviert den Menüpunkt.

Gibt den Namen des Material Icons für das linke Icon an. Alternativ können Sie slot="icon" verwenden. Eine leere Zeichenfolge reserviert Platz für ein Icon.

Gibt den Namen des Material Icons für das rechte Icon an. Alternativ können Sie slot="end-icon" verwenden.

Gibt den rechten Text an. Alternativ können Sie slot="end-text" verwenden.

Gibt den Namen des Material Icons für den ausgewählten Zustand an. Alternativ können Sie slot="selected-icon" verwenden.

Öffnet das Untermenü.

Die URL für den Link. Wenn gesetzt, wird die Komponente als <a>-Element gerendert und unterstützt Link-bezogene Attribute.

Lädt die verlinkte URL herunter.

Hinweis: Nur verfügbar, wenn href angegeben ist.

Legt fest, wo die verlinkte URL geöffnet wird. Mögliche Werte:

  • _blank: Öffnet in einem neuen Tab oder Fenster.
  • _parent: Öffnet im übergeordneten Browsing-Kontext oder _self, wenn kein übergeordneter Kontext vorhanden ist.
  • _self: Öffnet im aktuellen Browsing-Kontext (Standard).
  • _top: Öffnet im obersten Browsing-Kontext oder _self, wenn kein übergeordneter Kontext vorhanden ist.

Hinweis: Nur verfügbar, wenn href angegeben ist.

Gibt die Beziehung der verlinkten URL als durch Leerzeichen getrennte Link-Typen an. Mögliche Werte:

  • alternate: Eine alternative Version des aktuellen Dokuments.
  • author: Der Autor des aktuellen Dokuments oder Artikels.
  • bookmark: Der Permalink des übergeordneten Abschnitts.
  • external: Das referenzierte Dokument ist nicht Teil derselben Website wie das aktuelle Dokument.
  • help: Ein Link zu kontextsensitiver Hilfe.
  • license: Inhalt, der durch die im referenzierten Dokument beschriebene Urheberrechtslizenz abgedeckt ist.
  • me: Links zu Inhalten, die dem Autor des aktuellen Dokuments gehören.
  • next: Das nächste Dokument in der Serie.
  • nofollow: Gibt an, dass der ursprüngliche Autor oder Herausgeber des aktuellen Dokuments das referenzierte Dokument nicht unterstützt.
  • noreferrer: Verhindert das Senden des Referer-Headers. Hat die gleiche Wirkung wie noopener.
  • opener: Erstellt einen neuen Browsing-Kontext, wenn der Hyperlink ansonsten in einem obersten Kontext geöffnet würde, der nicht sekundär ist (z. B. wenn target="_blank" angegeben ist).
  • prev: Das vorherige Dokument in der Serie.
  • search: Links zu einer Ressource, die verwendet werden kann, um im aktuellen Dokument und seinen verwandten Seiten zu suchen.
  • tag: Markiert das aktuelle Dokument mit dem angegebenen Tag.

Hinweis: Nur verfügbar, wenn href angegeben ist.

Gibt an, ob das Element beim Laden der Seite den Fokus erhält.

Die Tab-Reihenfolge des Elements beim Navigieren mit der Tabulatortaste.

NameParameterRückgabewert

Simuliert einen Mausklick auf das Element.

Setzt den Fokus auf das Element. Der optionale Objektparameter kann eine preventScroll-Eigenschaft enthalten. Wenn preventScroll auf true gesetzt ist, scrollt die Seite nicht, um das fokussierte Element in den sichtbaren Bereich zu bringen.

Entfernt den Fokus vom Element.

Name

Wird ausgelöst, wenn der Menüpunkt den Fokus erhält.

Wird ausgelöst, wenn der Menüpunkt den Fokus verliert.

Wird ausgelöst, wenn das Untermenü beginnt, sich zu öffnen. Kann mit event.preventDefault() verhindert werden.

Wird ausgelöst, nachdem das Untermenü geöffnet wurde und die Animationen abgeschlossen sind.

Wird ausgelöst, wenn das Untermenü beginnt, sich zu schließen. Kann mit event.preventDefault() verhindert werden.

Wird ausgelöst, nachdem das Untermenü geschlossen wurde und die Animationen abgeschlossen sind.

Name

Menüpunkt-Text.

Linkes Icon.

Rechtes Icon.

Rechter Text.

Icon für den ausgewählten Zustand.

Untermenü.

Beliebiger benutzerdefinierter Inhalt.

Name

Container des Menüpunkts.

Linkes Icon.

Textinhalt.

Rechtes Icon.

Rechter Text.

Icon für den ausgewählten Zustand.

Untermenü-Punkt.

AttributPropertyReflectTypStandard

Steuert, ob Menüpunkte ausgewählt werden können. Standardmäßig sind sie nicht auswählbar. Mögliche Werte:

  • single: Es kann jeweils nur ein Menüpunkt ausgewählt werden.
  • multiple: Es können mehrere Menüpunkte ausgewählt werden.

Der Wert des ausgewählten <mdui-menu-item>.

Hinweis: Das HTML-Attribut akzeptiert immer eine Zeichenfolge und kann nur als Anfangswert verwendet werden, wenn selects="single". Die JavaScript-Eigenschaft ist eine Zeichenfolge, wenn selects="single", und ein Array von Zeichenfolgen, wenn selects="multiple". Wenn selects="multiple", aktualisieren Sie die JavaScript-Eigenschaft, um diesen Wert zu ändern.

Gibt an, ob die Menüpunkte ein kompaktes Layout verwenden.

Definiert, wie Untermenüs geöffnet werden. Mehrere durch Leerzeichen getrennte Werte werden unterstützt. Mögliche Werte:

  • click: Öffnet das Untermenü, wenn auf den Menüpunkt geklickt wird.
  • hover: Öffnet das Untermenü, wenn mit der Maus über einen Menüpunkt gefahren wird.
  • focus: Öffnet das Untermenü, wenn der Menüpunkt den Fokus erhält.
  • manual: Untermenüs können nur programmgesteuert geöffnet und geschlossen werden; es können keine anderen Auslösemethoden angegeben werden.

Die Verzögerung (in Millisekunden), bevor ein Untermenü bei Mouseover geöffnet wird.

Die Verzögerung (in Millisekunden), bevor ein Untermenü bei Mouseover geschlossen wird.

NameParameterRückgabewert

Setzt den Fokus auf das Element.

Entfernt den Fokus vom Element.

Name

Wird ausgelöst, wenn sich der ausgewählte Zustand von Menüpunkten ändert.

Name

Untermenü-Punkte (<mdui-menu-item>), Trennlinien (<mdui-divider>) und andere Elemente.

Name

Der Eckradius der Komponente. Sie können einen bestimmten Pixelwert verwenden, es wird jedoch empfohlen, auf Design-Tokens zu verweisen.

Auf dieser Seite