SwiftUI: Custom Environment Value
Zusammenfassung
Kurz
Der vollständige Artikel zeigt SwiftUI-Beispiele für einfache, schreibgeschützte und aktionsbasierte benutzerdefinierte Umgebungswerte. Für Aktionen mit einem eigenen Observable empfiehlt er eine initialisierte Aktionsstruktur mit `callAsFunction`; zugleich sagt der Autor, dass Observable-Objekte allein oft ausreichen. Die Beispiele werden nicht systematisch geprüft oder verglichen.
Mittel
Der vollständige Artikel erklärt, wie benutzerdefinierte Umgebungswerte in SwiftUI angelegt und erweitert werden können. Ein einfacher Wert entsteht durch eine mit `@Entry` markierte Eigenschaft in `EnvironmentValues`; Views setzen ihn mit `.environment(_:_:)` und lesen ihn mit `@Environment`. Für schreibgeschützte Werte schlägt der Autor eine Eigenschaft nur mit `get` vor, die dann nicht über diesen Modifier gesetzt werden kann.
Weitere Beispiele zeigen Umgebungswerte, die andere Werte wie `dismiss` aufrufen. Für eine beschreibbare Aktion wird ein eigener `EnvironmentKey` verwendet. Um ein Observable-Objekt in einer Umgebungsaktion anzusprechen, schlägt der Artikel eine Aktionsstruktur mit Referenz auf das Objekt und `callAsFunction` vor. Diese muss beim Einsetzen in die Umgebung ausdrücklich mit dem Observable initialisiert werden; laut Artikel reicht es nicht, nur das Observable selbst einzusetzen und in der Aktionsstruktur per `@Environment` auszulesen. Überladene `callAsFunction`-Methoden ermöglichen außerdem verschiedene Eingaben, etwa eine einzelne Nachricht oder eine Nachrichtenliste. Der Autor merkt an, dass Observable-Objekte für viele Fälle genügen. Die Beispiele werden erläutert, aber nicht systematisch verglichen oder unabhängig geprüft.
Ausführlich lesen
Der vollständige Bericht ist ein Praxisartikel von Itsuki über benutzerdefinierte Umgebungswerte in SwiftUI. Er erklärt zunächst, dass SwiftUI über die View-Hierarchie sowohl Systemwerte wie `dismiss` als auch beobachtbare Objekte weiterreichen kann. Werte lassen sich mit `@Environment` lesen; Systemwerte können mit `.environment(_:_:)` überschrieben werden. Für Observable-Objekte zeigt der Artikel die Verwendung des `@Observable`-Makros und das Einsetzen beziehungsweise Auslesen des Objekts in der Umgebung.
Der Hauptteil führt mehrere Varianten eigener `EnvironmentValues` vor. Für einen einfachen, beschreibbaren Wert wird `EnvironmentValues` erweitert, eine Eigenschaft mit Standardwert angelegt und mit `@Entry` markiert. Ein Beispiel reicht eine Hintergrundfarbe nach unten durch die View-Hierarchie. Für einen nur lesbaren Wert lässt der Autor `@Entry` weg und definiert eine Eigenschaft ausschließlich mit `get`. Laut Artikel kann dieser Wert anschließend nicht mit `.environment(_:_:)` gesetzt werden.
Anschließend zeigt der Bericht, wie ein eigener Umgebungswert einen anderen Umgebungswert verwenden kann. Ein lesbarer Wert `dismissWithMessage` gibt zunächst eine Nachricht in der Debug-Konsole aus und ruft dann den vorhandenen `dismiss`-Wert auf. Für eine beschreibbare Variante wird stattdessen ein eigener `EnvironmentKey` mit Standardaktion angelegt. Die Eigenschaft in `EnvironmentValues` ruft die gesetzte Aktion auf und schließt anschließend die Ansicht. Der Autor demonstriert, wie eine View diese Aktion beim Anzeigen eines Sheets einsetzt.
Ein weiterer Abschnitt behandelt den Zugriff auf ein eigenes Observable-Objekt aus einer Umgebungsaktion. Der Artikel sagt, dass sich ein benutzerdefiniertes Observable nicht wie ein vorhandener Umgebungswert über `self[keyPath:]` abrufen lasse. Als Lösung wird eine Aktionsstruktur nach dem Vorbild von `DismissAction` vorgestellt: Sie hält eine Referenz auf einen `MessageManager` und implementiert `callAsFunction`, um Nachrichten anzuhängen. Der Artikel versieht die Struktur mit `@MainActor`, `@preconcurrency` und `Sendable` und erklärt diese Angaben für Swift 6 als erforderlich. Die Aktion muss beim Einsetzen des Sheets ausdrücklich mit `.environment(\.addMessage, .init(_manager: messageManager))` initialisiert werden. Laut Autor funktioniert es nicht, stattdessen nur das Observable-Objekt selbst in die Umgebung einzusetzen und es innerhalb der Aktionsstruktur mit `@Environment` auszulesen. Ohne initialisierten Manager löst der Beispielcode einen `fatalError` aus.
Schließlich erweitert der Bericht die Aktionsstruktur um eine überladene `callAsFunction`-Methode. So kann derselbe Umgebungswert entweder eine einzelne Nachricht oder eine Liste von Nachrichten verarbeiten. Der Autor weist zugleich darauf hin, dass für viele Anwendungsfälle ein Observable-Objekt allein ausreichen kann und benutzerdefinierte `EnvironmentValues` daher nicht immer nötig sind. Die Beispiele veranschaulichen die vorgeschlagenen Muster; der Bericht enthält keinen systematischen Vergleich, keine unabhängige Prüfung und keine weitergehenden Angaben zu ihren Grenzen oder zur Kompatibilität außerhalb der erwähnten Swift-6-Anmerkung.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Lunas Einordnung enthielt keine Fragen, daher bleibt die Einordnung leer. Die Zusammenfassung wurde in beiden Fassungen geprüft: Die mittlere Fassung gibt den Bericht treu wieder, die kurze lässt mehrere zentrale Punkte aus.
Im Bericht, aber nicht in der Zusammenfassung
- Die kurze Fassung nennt nicht, dass ein Observable nicht direkt per environment(_:) gesetzt und in der Aktionsstruktur mit @Environment gelesen werden kann.
- Die kurze Fassung erklärt nicht den Grundmechanismus mit @Entry bzw. EnvironmentKey und environment(_:_:).
- Die kurze Fassung erwähnt nicht die überladenen callAsFunction-Methoden für verschiedene Eingaben.
- Die kurze Fassung erwähnt nicht die schreibgeschützte Variante mit get-only-Eigenschaft.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.