PullToRefresh
„Nach unten ziehen zum Aktualisieren“ nur an einer bestimmten Stelle, etwa an der Kopfzeile. Das eingebaute Neuladen des Browsers am Handy löst beim Runterwischen ganz oben oft versehentlich aus; die Komponente schaltet es ab, solange sie auf der Seite ist, und bietet die Geste nur an der gewählten Fläche an. Nur mit dem Finger – am Handy oder in den Entwicklertools mit Touch-Emulation ausprobieren.
Grundlagen
Mit dem Finger auf der Karte nach unten ziehen und über der Schwelle loslassen. OnRefresh ersetzt hier das Neuladen der Seite.
Aktualisiert: 0 Mal, zuletzt noch nie
Fläche per Selector
Liegt die Fläche außerhalb, etwa die Kopfzeile eines Layouts, wählt sie Selector – für RailLayout
Selector=".oo-rl__header". Ohne OnRefresh lädt die Seite neu.
SKILL.md – Pulltorefresh
--- name: PullToRefresh description: Onesown Blazor Komponente PullToRefresh (Feedback). Verwende diesen Skill wenn du die PullToRefresh-Komponente verwenden, konfigurieren oder debuggen moechtest. --- # PullToRefresh **Namespace:** `Onesown.Blazor.Components` **Kategorie:** Feedback **Basisklasse:** `OoComponentBase` „Nach unten ziehen zum Aktualisieren“ nur an einer bestimmten Stelle der Seite, etwa an der Kopfzeile. Das eingebaute Neuladen des Browsers am Handy (Runterwischen ganz oben) löst oft versehentlich aus; die Komponente schaltet es ab und bietet die Geste stattdessen nur dort an, wo sie gewollt ist. Zieht man dort mit dem Finger nach unten, erscheint oben ein runder Kreis mit Pfeil, der mitwandert; über der Schwelle losgelassen lädt die Seite neu (oder ruft OnRefresh auf). **Live-Demo:** https://components.schini.com/demo/pulltorefresh ## Parameter | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``ChildContent`` | ``RenderFragment`` | | Inhalt, an dem man zieht. Leer = die Fläche kommt aus Selector. | | ``Selector`` | ``string`` | | CSS-Selector der Elemente, an denen man zieht, etwa ".oo-rl__header" für die Kopfzeile von RailLayout. Gilt für die ganze Seite. Hat Vorrang vor ChildContent. Standard: leer (gezogen wird am ChildContent). | | ``OnRefresh`` | ``EventCallback`` | | Aktion beim Auslösen. Ohne Handler lädt die Seite neu (location.reload). Die Anzeige dreht sich, bis der Task fertig ist. | | ``Distance`` | ``int`` | ``80`` | Strecke in Pixeln, die die Anzeige nach unten wandern muss, bis Loslassen auslöst (mindestens 40). Standard: 80. | | ``DisableNativeRefresh`` | ``bool`` | ``true`` | Schaltet das eingebaute Neuladen des Browsers durch Runterwischen ab, solange die Komponente lebt. Standard: true. | ## 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) - An der Kopfzeile eines Layouts (Element außerhalb der Komponente): <PullToRefresh Selector=".oo-rl__header" /> - Um eigenen Inhalt: <PullToRefresh><div>Hier nach unten ziehen</div></PullToRefresh> - Statt Neuladen eigene Aktion: OnRefresh="DatenNeuLadenAsync" – die Anzeige dreht sich, bis der Task fertig ist - Schwelle in Pixeln: Distance="100" (Standard: 80) - Eingebautes Neuladen des Browsers lassen: DisableNativeRefresh="false" - Nur Touch: Maus und Stift lösen nichts aus. Die Geste beginnt nur, wenn die Fläche und alles darüber ganz oben gescrollt ist - Selector gilt für die ganze Seite und für Elemente, die später erscheinen; Parameter wirken beim ersten Rendern - Abgeschaltet wird das eingebaute Neuladen über overscroll-behavior-y am html- und body-Element, solange die Komponente lebt