SwiftUI: Interactive Charts
Zusammenfassung
Kurz
Der Bericht stellt SwiftUI-Modifikatoren zur Auswahl einzelner Werte und von Bereichen in Diagrammen vor und zeigt ihre Anpassung mit `chartGesture(_:)` und `ChartProxy`. Als Grenzen der einfachen Auswahl nennt der Autor, dass sie auch an datenfreien Stellen greift und beim Loslassen verschwindet; eigene Gesten können die Auswahl laut Beispielen gezielter steuern und bestehen lassen.
Mittel
Der Bericht zeigt, wie SwiftUI Charts interaktive Auswahl von Einzelwerten und Bereichen ermöglichen. Für Linien- und Sektordiagramme werden unter anderem `chartXSelection(value:)`, `chartYSelection(value:)` und `chartAngleSelection(value:)` vorgestellt. Bei der Winkelauswahl liefert SwiftUI laut Artikel keinen Winkel, sondern den kumulierten Datenwert an der gewählten Position, der anschließend einem Segment zugeordnet werden kann. Bereichsauswahlen lassen sich über X- und Y-Bereiche abbilden und mit Rechtecken markieren.
Der Autor kritisiert an den einfachen Modifikatoren, dass eine Auswahl auch an Stellen ohne Daten möglich ist und beim Loslassen automatisch verschwindet. Mit `chartGesture(_:)` und `ChartProxy` lassen sich eigene Gesten und Regeln umsetzen. Ein Beispiel aktualisiert Bereiche während einer Drag-Geste und setzt sie optional beim Ende zurück. Ein weiteres erlaubt die Auswahl nur in der Nähe vorhandener Datenpunkte, indem Gesten- und Punktpositionen verglichen werden. Der Bericht erklärt außerdem, dass die Auswahlfunktionen Positionen in der Diagrammansicht entgegennehmen. Er ist eine Codeanleitung; systematische Tests oder weitergehende Einschränkungsanalysen enthält er nicht.
Ausführlich lesen
Der Bericht erläutert, wie sich interaktive Diagramme mit SwiftUI Charts umsetzen lassen. Ausgangspunkt ist die Auswahl von Datenpunkten, damit Nutzende zu einer Position im Diagramm zusätzliche Informationen sehen können. Der Autor stellt zunächst die eingebauten Auswahlmodifikatoren vor und zeigt anschließend, wie sich mit `chartGesture(_:)` eigene Gesten und Auswahlregeln ergänzen lassen.
Für einzelne Werte beschreibt der Artikel `chartXSelection(value:)` und `chartYSelection(value:)`: Eine Zustandsvariable wird angelegt und an den passenden Modifikator gebunden. Das Linienbeispiel zeigt eine ausgewählte Datums- und Wertekombination als hervorgehobenen Punkt mit Annotation. Für Kreis- beziehungsweise Sektordiagramme nennt der Bericht `chartAngleSelection(value:)`. Der zurückgegebene Wert sei dabei kein Winkel in Grad oder Radiant, sondern der aufsummierte Datenwert an der gewählten Position. Im Beispiel wird dieser Wert durch Aufsummieren den einzelnen Segmenten zugeordnet und der Name sowie Wert des Segments in der Diagrammmitte angezeigt.
Außerdem führt der Artikel Bereichsauswahlen über `chartXSelection(range:)` und `chartYSelection(range:)` vor. Die Auswahl wird als geschlossener Wertebereich gespeichert und mit Rechteckmarkierungen visualisiert. Laut Autor haben die einfachen Modifikatoren jedoch zwei Nachteile: Die Auswahl ist im gesamten Diagramm möglich, auch an Stellen ohne zugehörige Daten, und sie wird beim Loslassen des Fingers automatisch aufgehoben. Der Autor möchte sie stattdessen bis zur nächsten Interaktion bestehen lassen.
Als flexiblere Möglichkeit beschreibt der Bericht `chartGesture(_:)`, das Zugriff auf einen `ChartProxy` bietet. Dieser vermittelt unter anderem Positionen, Skalen und Diagrammwerte. Der Artikel nennt Funktionen, mit denen Winkel-, X- und Y-Werte oder Bereiche anhand von Positionen im Diagramm ausgewählt werden können. Dabei beziehen sich die übergebenen `CGFloat`- und `Angle`-Werte laut Bericht auf die Position innerhalb der Ansicht, nicht auf die zugrunde liegenden Daten.
Zwei Beispiele veranschaulichen die Anpassung: Eine Drag-Geste aktualisiert die X- und Y-Bereiche während des Ziehens; sollen die Markierungen beim Ende der Geste verschwinden, werden die Zustandswerte auf `nil` gesetzt. Im zweiten Beispiel wird eine Datenauswahl auf Punkte in einem festgelegten Toleranzbereich begrenzt. Dazu vergleicht der Code die Gestenposition mit den durch `position(for:)` ermittelten Punktpositionen. `value(at:as:)` kann laut Artikel außerdem die Datenwerte an einer Gestenposition liefern, sofern dort ein gültiger Y-Wert liegt.
Der Bericht ist eine praktische Anleitung mit SwiftUI-Codebeispielen. Er zeigt die beschriebenen API-Muster, enthält aber keine systematische Auswertung, Messungen oder Angaben zu Einschränkungen über die genannten Auswahlprobleme und Codebeispiele hinaus.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Die Bewertung bezieht sich auf beide Zusammenfassungen von Luna (kurz und mittel) gemeinsam. Beide geben den Bericht sachlich korrekt wieder und enthalten keine erfundenen Angaben. Die aufgeführten Auslassungen sind Detailpunkte. Im Abschnitt Einordnung sind keine Fragen angegeben, daher bleibt die Liste leer.
Im Bericht, aber nicht in der Zusammenfassung
- Die Zwei-Finger-Geste als Auslöser der Bereichsauswahl wird nicht genannt.
- Der Autor hält den Namen chartAngleSelection für irreführend, weil der Rückgabewert kein Winkel ist.
- Die Modifikatoren der einfachen Variante kommen ohne eigene Erkennungslogik aus, das wird nicht erwähnt.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.