Docs Erste Schritte Dropdown
Dropdown 1.2.0
The <velin-dropdown> Web Komponente displays a toggleable Menü anchored to a
trigger element, with start/end alignment, type-ahead search, and full Tastatur navigation (0.7.0). English: Dropdown
Reifegrad: Dokumentiert als stabil in VelinStyle 1.2.0 . Design Intelligence (Plan / Review / Agent-Meta) ist separat und Beta / Grundlage wo entsprechend angegeben.
Wann verwenden
Menüs of actions or Links triggered from a Button with the documented dropdown markup.
Secondary actions that should stay collapsed until the Nutzer opens them.
Wann nicht verwenden
Einfaches Beispiel
Vorschau HTML
Menü Öffnen
Profil
Einstellungen
Abmelden
Kopieren
<velin-dropdown>
<button class="velin-btn velin-btn--primary" slot="trigger">
Open Menu
</button>
<button role="menuitem">Profile</button>
<button role="menuitem">Settings</button>
<button role="menuitem">Sign out</button>
</velin-dropdown>
Ausrichtung am Ende
Vorschau HTML
Am Ende ausrichten
Item A
Item B
Kopieren
<velin-dropdown align="end">
<button slot="trigger">Align End</button>
<button role="menuitem">Item A</button>
<button role="menuitem">Item B</button>
</velin-dropdown>
Tastaturnavigation
Taste Aktion
Enter / Space Menü umschalten (on trigger), activate item
Arrow Down Nächsten Menüeintrag fokussieren
Arrow Up Vorherigen Menüeintrag fokussieren
Start Ersten Eintrag fokussieren
End Letzten Eintrag fokussieren
Letter / digit keys Type-ahead: Fokus first item whose label starts with the typed string (500 ms window)
Escape Menü schlie?en, Fokus zum Trigger zur?ckgeben
Barrierefreiheit
Menü behaviour follows the Menü Button pattern .
Trigger gets aria-haspopup="Menü", aria-expanded, and aria-controls (Menü id).
Menü panel has role="Menü"; items use role="menuitem" (assigned automatically if omitted).
Roving tabindex with arrow keys; first item is focused when the Menü opens.
Type-ahead focuses the first matching item by sichtbar label (WAI-ARIA Menü pattern).
Escape closes the Menü and returns Fokus to the trigger; outside click closes as well.
Menü items use a minimum block size of 2.5 rem; animations respect prefers-reduced-motion.
CSS-Variablen
Variable Beschreibung
--velin-z-dropdownz-index (100)
--velin-color-surface-brightMenü background
--velin-color-borderMenü border
--velin-radius-mdMenü border radius
--velin-shadow-lgMenü shadow
JavaScript-API
Attribut
Attribut Typ Beschreibung
openBoolean Ob das Menü sichtbar ist
alignString start (Standard) or end
Methoden
Methode Beschreibung
toggle()Öffnen/Schließen umschalten
open()Menü Öffnen
close()Menü schlie?en
Ereignisse
Ereignis Beschreibung
velin-closeWird ausgelöst, wenn das Menü schließt
Zurück Schublade
Weiter Lightbox