Sec-CH-Prefers-Reduced-Motion header

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Der HTTP Sec-CH-Prefers-Reduced-Motion Anfrage-Header ist ein Client-Hint des Benutzeragenten, der die Präferenz des Benutzeragenten für Animationen mit reduzierter Bewegung anzeigt.

Wenn ein Server einem Client über den Accept-CH Header signalisiert, dass er Sec-CH-Prefers-Reduced-Motion akzeptiert, kann der Client dann mit diesem Header antworten, um die Präferenz des Benutzers für reduzierte Bewegung anzuzeigen. Der Server kann dem Client entsprechend angepassten Inhalt senden, zum Beispiel JavaScript oder CSS, um die Bewegung von Animationen im anschließend gerenderten Inhalt zu reduzieren. Dies könnte das Reduzieren der Geschwindigkeit oder Amplitude der Bewegung beinhalten, um Unannehmlichkeiten für Personen mit Störungen des Gleichgewichtsinns zu reduzieren.

Dieser Header ist nach der prefers-reduced-motion Media Query modelliert.

Header-Typ Anfrage-Header, Client-Hint
Verbotener Anfrage-Header Ja (Sec- Präfix)

Syntax

http
Sec-CH-Prefers-Reduced-Motion: <preference>

Direktiven

<preference>

Die Präferenz des Benutzeragenten für Animationen mit reduzierter Bewegung. Dies wird oft aus den Einstellungen des zugrunde liegenden Betriebssystems übernommen. Der Wert dieser Direktive kann entweder no-preference oder reduce sein.

Beispiele

Verwendung von Sec-CH-Prefers-Reduced-Motion

Der Client stellt eine erste Anfrage an den Server:

http
GET / HTTP/1.1
Host: example.com

Der Server antwortet und teilt dem Client mit, dass er via Accept-CH Sec-CH-Prefers-Reduced-Motion akzeptiert. In diesem Beispiel wird auch Critical-CH verwendet, um anzugeben, dass Sec-CH-Prefers-Reduced-Motion als kritischer Client-Hint betrachtet wird.

http
HTTP/1.1 200 OK
Content-Type: text/html
Accept-CH: Sec-CH-Prefers-Reduced-Motion
Vary: Sec-CH-Prefers-Reduced-Motion
Critical-CH: Sec-CH-Prefers-Reduced-Motion

Hinweis: Wir haben Sec-CH-Prefers-Reduced-Motion auch im Vary Header angegeben, um dem Browser mitzuteilen, dass der bereitgestellte Inhalt auf Grundlage dieses Header-Werts unterschiedlich sein wird, auch wenn die URL gleich bleibt. Daher sollte der Browser nicht einfach eine vorhandene zwischengespeicherte Antwort verwenden, sondern stattdessen diese Antwort getrennt zwischenspeichern. Jeder Header, der im Critical-CH Header aufgelistet ist, sollte auch in den Accept-CH und Vary Headers vorhanden sein.

Der Client wiederholt automatisch die Anfrage (da Critical-CH oben angegeben wurde) und teilt dem Server über Sec-CH-Prefers-Reduced-Motion mit, dass er eine Benutzerpräferenz für Animationen mit reduzierter Bewegung hat:

http
GET / HTTP/1.1
Host: example.com
Sec-CH-Prefers-Reduced-Motion: "reduce"

Der Client wird den Header in nachfolgenden Anfragen innerhalb der aktuellen Sitzung einschließen, es sei denn, die Accept-CH ändert sich in den Antworten, um anzuzeigen, dass es nicht mehr vom Server unterstützt wird.

Spezifikationen

Specification
User Preference Media Features Client Hints Headers
# sec-ch-prefers-reduced-motion

Browser-Kompatibilität

Siehe auch