Zum Inhalt springen

Dokumentation

Komponenten

Toggles

Schalter für sofort wirksame Einstellungen, mit optionalem Label und Beschreibung.

Verwendung

Ein Toggle schaltet eine Einstellung sofort um. Verwende einen Button, wenn die Änderung erst durch Absenden wirksam wird.

Standard-Toggle
Remember me
blade
<gedisa:toggle label="Remember me" />

Größen

Zwei Größen passen den Schalter an die Dichte der Oberfläche an. Der Standard ist md.

Small und Medium
Small Medium
blade
<gedisa:toggle size="sm" label="Small" />
<gedisa:toggle size="md" label="Medium" />

Varianten

Die Standardvariante zeigt den Knopf innerhalb der Spur. Mit variant="slim" ist die Spur schmaler und der Knopf liegt darüber.

Default und Slim
Default Slim
blade
<gedisa:toggle label="Default" checked />
<gedisa:toggle variant="slim" label="Slim" checked />

Label und Beschreibung

label beschriftet den Schalter, description ergänzt eine Erklärung darunter. Ein Klick auf das Label schaltet den Toggle um.

Mit Beschreibung
Remember me Save my login details for next time. Remember me Save my login details for next time.
blade
<gedisa:toggle label="Remember me" description="Save my login details for next time." />
<gedisa:toggle size="sm" variant="slim" label="Remember me" description="Save my login details for next time." checked />

Zustände

checked setzt den Startzustand, disabled sperrt den Schalter in seinem aktuellen Zustand.

Aktiv, deaktiviert und gesperrt
Aktiv Deaktiviert Gesperrt und aktiv
blade
<gedisa:toggle label="Aktiv" checked />
<gedisa:toggle label="Deaktiviert" disabled />
<gedisa:toggle label="Gesperrt und aktiv" checked disabled />

Livewire

Mit wire:model.live wirkt die Änderung sofort. Die Beispiele sind an diese Seite gebunden und zeigen ihren Zustand im Text.

Live gebundene Schalter
Remember me Anmeldedaten werden nicht gespeichert. Newsletter Newsletter ist abonniert.
blade
<gedisa:toggle wire:model.live="remember" label="Remember me" :description="$remember ? 'Anmeldedaten werden gespeichert.' : 'Anmeldedaten werden nicht gespeichert.'" />
<gedisa:toggle wire:model.live="newsletter" variant="slim" label="Newsletter" :description="$newsletter ? 'Newsletter ist abonniert.' : 'Newsletter ist abbestellt.'" />

Referenz

Diese Übersicht umfasst die gezeigten Attribute. Verhalten und Tastaturbedienung stammen aus flux:switch.

gedisa:toggle

Eigenschaft
Werte
Default
size Toggle-Größen sm, md md
variant Varianten default, slim default
label Beschriftung neben dem Schalter
description Erklärung unter dem Label
checked Startzustand des Schalters
disabled HTML-Attribut
name Feldname, wird sonst aus wire:model abgeleitet
wire:model Bindung des Zustands als Boolean