Zum Hauptinhalt springen
VelinStyle v1.2.0
⌂ Home
  1. Docs
  2. Erste Schritte
  3. 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

Wann nicht verwenden

Einfaches Beispiel

<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

<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

TasteAktion
Enter / SpaceMenü umschalten (on trigger), activate item
Arrow DownNächsten Menüeintrag fokussieren
Arrow UpVorherigen Menüeintrag fokussieren
StartErsten Eintrag fokussieren
EndLetzten Eintrag fokussieren
Letter / digit keysType-ahead: Fokus first item whose label starts with the typed string (500 ms window)
EscapeMenü schlie?en, Fokus zum Trigger zur?ckgeben

Barrierefreiheit

Menü behaviour follows the Menü Button pattern.

CSS-Variablen

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

AttributTypBeschreibung
openBooleanOb das Menü sichtbar ist
alignStringstart (Standard) or end

Methoden

MethodeBeschreibung
toggle()Öffnen/Schließen umschalten
open()Menü Öffnen
close()Menü schlie?en

Ereignisse

EreignisBeschreibung
velin-closeWird ausgelöst, wenn das Menü schließt