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 Request-Header ist ein Client-Hinweis des Benutzeragenten, der die Vorliebe des Benutzeragenten für Animationen mit reduzierter Bewegung angibt.

Wenn ein Server einem Client über den Accept-CH-Header signalisiert, dass er Sec-CH-Prefers-Reduced-Motion akzeptiert, kann der Client mit diesem Header antworten, um die Präferenz des Benutzers für reduzierte Bewegungen anzugeben. Der Server kann dann dem Client entsprechend angepasstes Content, wie z.B. JavaScript oder CSS, senden, um die Bewegungen von Animationen in den daraufhin dargestellten Inhalten zu reduzieren. Dies könnte die Geschwindigkeit oder Amplitude der Bewegungen verringern, um Unbehagen bei Personen mit vestibulären Bewegungsstörungen zu vermeiden.

Dieser Header ist an die Media Query prefers-reduced-motion angelehnt.

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

Syntax

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

Direktiven

<preference>

Die Präferenz des Benutzeragenten für reduzierten Bewegungsanimationen. Dies wird oft anhand der Einstellung des zugrundeliegenden Betriebssystems bestimmt. Der Wert dieser Direktive kann entweder no-preference oder reduce sein.

Beispiele

Verwendung von Sec-CH-Prefers-Reduced-Motion

Der Client sendet eine Anfangsanfrage an den Server:

http
GET / HTTP/1.1
Host: example.com

Der Server antwortet und informiert den Client über Accept-CH, dass er Sec-CH-Prefers-Reduced-Motion akzeptiert. In diesem Beispiel wird auch Critical-CH verwendet, was darauf hinweist, dass Sec-CH-Prefers-Reduced-Motion als ein kritischer Client-Hinweis 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 abhängig von diesem Header-Wert unterschiedlich ist, selbst wenn die URL gleich bleibt. Der Browser sollte nicht einfach eine bereits zwischengespeicherte Antwort verwenden, sondern diese Antwort separat zwischenspeichern. Jeder im Critical-CH-Header gelistete Header sollte auch in den Accept-CH- und Vary-Headern vorhanden sein.

Der Client wiederholt automatisch die Anfrage (da Critical-CH oben angegeben ist) und teilt dem Server mittels Sec-CH-Prefers-Reduced-Motion mit, dass eine Benutzerpräferenz für reduzierte Bewegungsanimationen vorliegt:

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

Der Client wird den Header in nachfolgenden Anfragen in der aktuellen Sitzung beibehalten, es sei denn, die Accept-CH-Änderungen in den Antworten deuten darauf hin, dass der Server ihn nicht mehr unterstützt.

Spezifikationen

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

Browser-Kompatibilität

Siehe auch