SwiftUI/MacOS: NSTrackingView For Mouse Enter and Mouse Exit
Zusammenfassung
Kurz
Der Beitrag beschreibt, wie eine per `NSViewRepresentable` eingebundene `NSView` mit `NSTrackingArea` Maus-Eintritts- und Austrittsereignisse an SwiftUI weitergeben kann. Er erläutert Rechteck, Eigentümer und Aktivitätsoptionen und zeigt als Beispiel farbige Effekte an der Mausposition; für einfache Hover-Abfragen empfiehlt der Autor `onHover`.
Mittel
Der Bericht zeigt, wie macOS-Maus-Eintritts- und Austrittsereignisse in einer SwiftUI-Ansicht mit `NSTrackingArea` erkannt werden. Für die einfache Frage, ob der Zeiger innerhalb einer Fläche liegt, empfiehlt der Autor stattdessen SwiftUIs `onHover`.
Für die ausführlichere Lösung wird eine `NSView` über `NSViewRepresentable` eingebunden. Sie erhält ihre Tracking-Fläche in `updateTrackingAreas()`; laut Artikel funktioniert das Einrichten in `init` nicht wie gewünscht. Als Rechteck dient `self.bounds`. Die Tracking-Fläche ist rechteckig und soll innerhalb der Ansichtsgrenzen liegen. Ihr Eigentümer muss ein `NSResponder` sein, der die angeforderten Ereignisse verarbeitet. Die Optionen bestimmen Ereignistyp und Aktivitätsbedingungen. Der Autor warnt, `.mouseEnteredAndExited` allein könne zum Absturz führen, und verwendet daher zusätzlich `.activeInKeyWindow`. Weitere Optionen betreffen unter anderem die sichtbare Fläche, Mausbewegungen beim Ziehen und mitgegebene `userInfo`-Daten.
In den Ereignismethoden kann die Mausposition in das Koordinatensystem der Ansicht umgerechnet werden. Ein Beispiel zeigt dort beim Eintritt einen blauen und beim Austritt einen grünen, ausblendenden Kreis. Der Effekt kann laut Autor auch an SwiftUI übergeben und dort animiert werden. Vergleichsmessungen oder umfassende Kompatibilitätstests werden nicht berichtet.
Ausführlich lesen
Der Bericht erklärt, wie sich in einer macOS-App mit SwiftUI erkennen lässt, wenn der Mauszeiger einen Bereich betritt oder verlässt. Für einfache Fälle, in denen nur interessiert, ob sich der Zeiger innerhalb einer Ansicht befindet, empfiehlt der Autor SwiftUIs `onHover`-Modifier. Für die gezeigte Lösung mit `mouseEntered`- und `mouseExited`-Ereignissen wird dagegen eine `NSView` benötigt, die über `NSViewRepresentable` in SwiftUI eingebunden wird.
Den zentralen Schritt bildet eine `NSTrackingArea`, die der Autor in `updateTrackingAreas()` zur Ansicht hinzufügt. Laut Bericht soll sie dort eingerichtet werden, weil sie beim Aktualisieren der Tracking-Bereiche veraltete Bereiche entfernt und neu berechnete hinzufügt; die Einrichtung in `init` löse die gewünschten Ereignisse nicht aus. Als Erfassungsrechteck dient `self.bounds`, also der Bereich im Koordinatensystem der Ansicht. Die Tracking-Fläche ist laut Artikel rechteckig und soll die Grenzen der Ansicht nicht überschreiten.
Der Bericht beschreibt außerdem die Konfiguration der Tracking-Fläche. Der Eigentümer muss nicht die zugehörige Ansicht sein, aber ein Objekt sein, das von `NSResponder` erbt und die angeforderten Ereignisse verarbeiten kann. Die Optionen legen unter anderem fest, welche Ereignisse überwacht werden und wann die Fläche aktiv ist. Der Autor warnt, dass die Angabe von `.mouseEnteredAndExited` allein zum Absturz führen könne, und ergänzt deshalb `.activeInKeyWindow`. Als weitere Aktivitätsoptionen nennt er den Ersthelfer, die aktive App und eine dauerhafte Aktivität; für letztere weist er auf eine Einschränkung bei `cursorUpdate` hin. Weitere Optionen können die sichtbare Fläche berücksichtigen oder Ereignisse beim Ziehen der Maus erzeugen. Über `userInfo` lassen sich zudem beliebige Daten für Ereignisse mitgeben.
Nach dem Einrichten der Tracking-Fläche können Überschreibungen von `mouseEntered(with:)` und `mouseExited(with:)` aufgerufen werden. Der Beispielcode wandelt die Ereignisposition aus dem Fensterkoordinatensystem in das der Ansicht um und zeigt dort kurz einen farbigen Kreis: beim Eintritt blau, beim Verlassen grün. Der Autor fügt den Effekt direkt in der `NSView` ein, merkt aber an, dass sich die Position auch per Binding an SwiftUI übergeben und dort animieren ließe.
Der Beitrag liefert damit eine konkrete Implementierung samt Erläuterungen zu Bereich, Eigentümer und Optionen. Er berichtet keine Vergleichsmessungen oder umfassenden Kompatibilitätstests; die Beispiele dienen der Veranschaulichung der API.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Die Prüfung bezieht sich auf beide Zusammenfassungen von Luna, da das Schema nur ein Objekt vorsieht. Die Einordnung ist leer, weil Luna keine Fragen angegeben hat (Sammel- und Teilfragen jeweils „keine“).
Im Bericht, aber nicht in der Zusammenfassung
- Der Bericht betont, dass mouseEntered und mouseExited ohne eine registrierte NSTrackingArea nicht ausgelöst werden. Diese zentrale Begründung für den Umweg über NSView fehlt in beiden Zusammenfassungen.
In der Zusammenfassung, laut Prüfung nicht im Bericht belegt
- Die mittlere Zusammenfassung macht die Ergänzung von .activeInKeyWindow zur Folge der Absturzwarnung. Der Bericht nennt diesen Zusammenhang nicht, er verwendet die Option nur im Codebeispiel.
- Die kurze Zusammenfassung sagt, die NSView gebe Ereignisse an SwiftUI weiter. Der Bericht beschreibt die Weitergabe an SwiftUI nur als mögliche Option, nicht als Mechanismus.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.