SwipeActions
Wischgesten an einem Listeneintrag wie in Podcast- und Mail-Apps: Der Eintrag gleitet mit dem Finger zur Seite und gibt darunter eine Aktion frei; über der Schwelle losgelassen löst sie aus. Senkrechtes Scrollen bleibt frei, Berührungen am Bildschirmrand bleiben der Zurück-Geste. Nur mit dem Finger – am Handy oder in den Entwicklertools mit Touch-Emulation ausprobieren.
Grundlagen
Mit dem Finger einen Eintrag nach rechts wischen (merken) bzw. nach links (erledigt) und über der Schwelle loslassen.
Folge 113: Der Weltraum
Folge 112: Unter Druck
Folge 111: Allein sein
Folge 110: Bioweine
SKILL.md – Swipeactions
--- name: SwipeActions description: Onesown Blazor Komponente SwipeActions (Grouping). Verwende diesen Skill wenn du die SwipeActions-Komponente verwenden, konfigurieren oder debuggen moechtest. --- # SwipeActions **Namespace:** `Onesown.Blazor.Components` **Kategorie:** Grouping **Basisklasse:** `OoComponentBase` Wischgesten an einem Listeneintrag wie in Podcast- und Mail-Apps am Handy: Wischt man mit dem Finger nach rechts bzw. links, gleitet der Inhalt mit und gibt darunter eine Aktion mit Symbol und Text frei. Über der Schwelle wird das Symbol farbig (am Handy mit kurzem Vibrieren); Loslassen löst die Aktion aus, der Inhalt gleitet zurück. Für Umschalt-Aktionen (merken, als gelesen markieren, archivieren). **Live-Demo:** https://components.schini.com/demo/swipeactions ## Parameter | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``ChildContent`` | ``RenderFragment`` | | Der Eintrag, an dem man wischt. | | ``OnSwipeRight`` | ``EventCallback`` | | Aktion beim Wischen nach rechts. Ohne Handler gibt es diese Richtung nicht. | | ``SwipeRightIcon`` | ``string`` | ``"star"`` | Material-Symbol der Aktion nach rechts (links freigelegt). Standard: "star". | | ``SwipeRightText`` | ``string`` | | Kurzer Text neben dem Symbol der Aktion nach rechts, etwa „Merken“. Standard: leer (nur Symbol). | | ``OnSwipeLeft`` | ``EventCallback`` | | Aktion beim Wischen nach links. Ohne Handler gibt es diese Richtung nicht. | | ``SwipeLeftIcon`` | ``string`` | ``"done"`` | Material-Symbol der Aktion nach links (rechts freigelegt). Standard: "done". | | ``SwipeLeftText`` | ``string`` | | Kurzer Text neben dem Symbol der Aktion nach links. Standard: leer (nur Symbol). | | ``Distance`` | ``int`` | ``80`` | Strecke in Pixeln, die der Inhalt zur Seite gleiten muss, bis Loslassen auslöst (mindestens 40). Standard: 80. | | ``EdgeWidth`` | ``int`` | ``24`` | Breite des Bildschirmrands in Pixeln, an dem eine Berührung nicht als Wischen zählt (Zurück-Geste des Systems). Standard: 24. | | ``Disabled`` | ``bool`` | | Schaltet die Gesten ab; der Inhalt bleibt bedienbar. Standard: false. | ## Geerbte Parameter (OoComponentBase) Alle nicht deklarierten HTML-Attribute (``class``, ``style``, ``data-*``, ``aria-*``, ...) werden an das Root-Element weitergereicht. | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``Size`` | ``string`` | | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. | ## Hinweise - Natives HTML-Attribut class wird automatisch an das Root-Element weitergegeben - Natives HTML-Attribut style wird automatisch an das Root-Element weitergegeben - Alle weiteren nicht deklarierten Attribute (data-*, aria-*, id, tabindex, …) werden ebenfalls weitergereicht - Größe der Komponente via Size mit OoSize-Konstanten steuern (OoSize.Xs bis OoSize.Xl) - Nach rechts wischen: <SwipeActions OnSwipeRight="MerkenAsync" SwipeRightIcon="star" SwipeRightText="Merken">…</SwipeActions> - Beide Richtungen: zusätzlich OnSwipeLeft, SwipeLeftIcon, SwipeLeftText; ohne Handler gibt es die Richtung nicht - Zustand im Symbol zeigen: SwipeRightIcon="@(gemerkt ? "bookmark_remove" : "bookmark_add")" - Schwelle in Pixeln: Distance="100" (Standard: 80); vorübergehend aus: Disabled="true" - Nur Touch: Maus und Stift lösen nichts aus. Senkrechtes Scrollen bleibt frei, die Geste beginnt erst bei klar waagrechter Bewegung - Berührungen am Bildschirmrand (EdgeWidth, Standard 24 px) bleiben der Zurück-Geste des Systems - Bereiche mit eigener Geste (etwa ein Ziehgriff) mit dem Attribut data-oo-swipe-ignore auszeichnen; Eingabefelder sind immer ausgenommen - Nach einem Wischen wird der folgende Klick unterdrückt, damit Links im Inhalt nicht öffnen - Nicht in waagrecht scrollenden Reihen verwenden (etwa ScrollRow): dort gehört das Wischen dem Scrollen - Farben über CSS-Variablen am Element: --oo-swipe-hintergrund (Fläche hinter dem Inhalt während des Wischens, Standard: Seitenhintergrund), - --oo-swipe-aktion (Fläche der Aktion), --oo-swipe-bereit (Farbe des Symbols über der Schwelle, Standard: Primärfarbe)