Communitygithub.com

motion-for-apple-platforms

Wie sich Apple-Oberflächen bewegen – SwiftUIs Feder-Vokabular (.smooth, .snappy, .bouncy) und wann welche Anwendung findet, unterbrechbare und gestengesteuerte Übergänge, Hero-/Kontinuitätsübergänge zwischen Bildschirmen, Mikrointeraktionen und haptische Kopplung sowie die Beachtung von „Reduce Motion“. Verwenden Sie dies, wenn Sie etwas animieren, das sich Apple-typisch anfühlen soll, auf jeder Plattform: ein SwiftUI-Übergang, eine CSS- oder Framer-Motion-Animation im Web, eine Sheet- oder Modal-Präsentation, ein Tastendruck, ein Lade- oder Erfolgszustand oder wenn eine UI technisch korrekt ist, sich aber steif, schwimmend oder träge anfühlt. Auch geeignet bei der Überprüfung von Bewegungen, die überschießen, an Stellen hüpfen, wo sie es nicht sollten, oder nicht mittendrin unterbrochen werden können. Für Apples Regeln dazu, *ob* überhaupt animiert werden soll, verwenden Sie „hig-guide“; für Farbe, Typografie und Steuerungsgeometrie verwenden Sie „ui-kit-for-apple-platforms“.

Was ist motion-for-apple-platforms?

Die Skill-Bibliothek „motion-for-apple-platforms“ ist eine umfassende Referenz zur Bewegungsgestaltung, die sich an Apples Human Interface Guidelines (HIG) orientiert. Sie deckt SwiftUIs Feder-Vokabular (.smooth, .snappy, .bouncy) mit konkreten Anwendungsfällen ab und erklärt, wie unterbrechbare, gestengesteuerte Übergänge, Hero-/Kontinuitätsübergänge zwischen Bildschirmen sowie Mikrointeraktionen mit haptischer Kopplung funktionieren. Die Referenz ist in drei Dateien gegliedert: `motion-animation.md` für das Feder-Vokabular, `microinteractions-feedback.md` für Druckzustände, Lade- und Feedback-Animationen sowie `gestures-interaction.md` für Wisch-, Zieh-, Pinch- und Kantengesten. Besonderes Augenmerk liegt auf der Unterscheidung zwischen Apples eigenen Prinzipien (zitiert in „hig-guide“), SwiftUI-API-Dokumentation und beobachtetem Verhalten aus echten Apps – gekennzeichnet mit `[observed]`. Die Skill ist plattformunabhängig und kann für SwiftUI, CSS oder Framer Motion im Web sowie für jede andere UI-Technologie verwendet werden, die Apple-ähnliche Animationen anstrebt. Sie betont die Bedeutung von Unterbrechbarkeit, Fingerverfolgung und der Berücksichtigung von `prefers-reduced-motion` und grenzt sich klar von den Skills für Farbe, Typografie und Steuerungsgeometrie ab.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/doppe7gangar/hig/tree/main/.claude/skills/motion-for-apple-platforms

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Apple-Bewegung

Die HIG behandelt Bewegung als Prinzip und hört dort auf. Ihre Seite „Bewegung“ hat 92 Zeilen dazu, ob animiert werden soll – absichtsvoll, optional, der Geste folgend – und keinen einzigen Federparameter. Alles darüber, wie die Bewegung tatsächlich gebaut wird, liegt außerhalb, weshalb dies hier existiert.

DateiWas darin steht
references/motion-animation.mdDas Feder-Vokabular, Dauern, Übergangstypen, Unterbrechbarkeit.
references/microinteractions-feedback.mdDruckzustände, Laden, Erfolgs- und Fehlerfeedback, haptische Kopplung.
references/gestures-interaction.mdWischen, Ziehen, Kneifen, Kantengesten und wie Bewegung diese verfolgen sollte.

Woher was kommt

Es lohnt sich, klar zu sein, denn die drei Quellen haben einen sehr unterschiedlichen Status und ihre Vermischung macht Bewegungsratschläge zur Folklore:

  • Prinzipien → hig-guide. „Füge Bewegung absichtsvoll hinzu.“ „Mache Bewegung optional.“ „Strebe nach realistischer Rückmeldungsbewegung, die den Gesten und Erwartungen der Menschen folgt.“ Dies sind Apples eigene Worte, in Bewegung. Zitieren Sie diese, nicht die Paraphrasen hier.
  • Federnamen und ihr Verhalten → SwiftUIs API. .smooth, .snappy, .bouncy sind echte APIs mit echten Standardwerten. Die Bounce-Prozentsätze in motion-animation.md sind Charakterisierungen davon, keine veröffentlichten Konstanten – behandeln Sie sie als Ausgangspunkt, den Sie justieren, und zitieren Sie sie nicht als Apples Spezifikation.
  • Alles andere → Beobachtung. Diese Referenzen sind aus der MIT-lizenzierten Sammlung „apple-design-skills“ übernommen (Hinweis in LICENSE.txt) und dort mit [observed] markiert, wo der Autor das Verhalten aus ausgelieferten Apps abgeleitet hat. Nützlich, nicht autoritativ.

Nichts hier ist so gemessen wie die Werte von ui-kit-for-apple-platforms. Diese Unterscheidung ist der Punkt: Bewegung ist der Teil dieses Repos mit der geringsten Grundwahrheit dahinter.

Auswahl einer Feder

Die eine Entscheidung, die den Großteil des Gefühls ausmacht:

FederBounceVerwendung für
.smoothkeinSheets, Modals, Hintergrundübergänge – alles, das sich beruhigen sollte, ohne Aufmerksamkeit zu erregen
.snappyleichtTastendrücke, Umschalter, Auswahl – die Standardeinstellung für direkte Manipulation
.bouncymerklichIcon-Drucke, eingehende Benachrichtigungen, Momente, die sich belohnend anfühlen sollen

Bounce ist das gesamte Signal. Ein Sheet, das hüpft, wirkt spielzeugartig; ein Tastendruck, der nicht hüpft, wirkt tot. Diese eine Wahl richtig zu treffen, bewirkt mehr als das Einstellen von Dauern.

Was Apple-Bewegung von gewöhnlicher Bewegung unterscheidet

  • Unterbrechbar. Eine Geste muss eine Animation mitten im Flug umkehren oder umleiten können, anstatt sich dahinter anzustellen. Alles, das beendet wird, bevor es antwortet, fühlt sich träge an, egal wie schnell es ist.
  • Verfolgt den Finger, dann übernimmt sie. Während eines Ziehens folgt die Oberfläche 1:1 der Geste; die Feder übernimmt erst beim Loslassen und übernimmt die Geschwindigkeit, die die Geste hatte. Dies ist die HIG-Aussage „realistische Rückmeldungsbewegung, die den Gesten und Erwartungen der Menschen folgt“ konkret umgesetzt.
  • Dauer ist eine Konsequenz, keine Eingabe. Federn werden durch Physik spezifiziert und beruhigen sich, wenn sie sich beruhigen. Nach einer festen 300 ms zu greifen, bedeutet meist, nach dem falschen Werkzeug zu greifen.
  • Position und Deckkraft, nicht Größe und Farbe. Bewegung und Verblassen wirken physisch; Skalieren und Umfärben wirken wie Effekte.

„Reduce Motion“ ist nicht optional

hig-guide sagt es klar – „Mache Bewegung optional.“ Im Web ist das prefers-reduced-motion, und es bedeutet, die Bewegung zu ersetzen, nicht nur zu verkürzen: Überblendung statt Schieben, Schnitt statt Animieren. ios-components.css von ui-kit-for-apple-platforms schützt bereits seine eigenen Übergänge auf diese Weise; gleichen Sie es ab.

Grenzen

  • Werte – Farbe, Typografie, Steuerungsgeometrie, Materialien – gehören zu ui-kit-for-apple-platforms, gemessen an Apples UI-Kit. Wiederholen Sie sie nicht hier; ein Hex-Code in einer Bewegungsdatei ist ein Hex-Code, der irgendwo veraltet, wo niemand hinschaut.
  • Regeln dazu, ob etwas animieren soll, welche Präsentation verwendet werden soll, wie Layouts sich anpassen – hig-guide, mit den tatsächlichen Zitaten.
  • Diese Skill behandelt, wie die Bewegung selbst gebaut wird.

Verwandte Skills