Sec-CH-Prefers-Reduced-Motion

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

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

Der Sec-CH-Prefers-Reduced-Motion User-Agent-Client-Hint Anforderungsheader gibt die Präferenz des User-Agents an, Animationen mit reduzierter Bewegung anzuzeigen.

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 angepasste Inhalte senden, zum Beispiel JavaScript oder CSS, um die Bewegung von Animationen im nachfolgenden gerenderten Inhalt zu reduzieren. Dies könnte beinhalten, die Geschwindigkeit oder Amplitude der Bewegung zu verringern, um das Unbehagen für Personen mit vestibulären Bewegungsstörungen zu reduzieren.

Dieser Header ist dem prefers-reduced-motion Media Query nachempfunden.

Header-Typ Anforderungsheader, Client Hint
Verbotener Header-Name ja

Syntax

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

Direktiven

<preference>

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

Beispiele

Der Client stellt eine anfängliche Anfrage an den Server:

http
GET / HTTP/1.1
Host: example.com

Der Server antwortet und teilt dem Client über Accept-CH mit, 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 kritischer Client-Hinweis angesehen 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 auch Sec-CH-Prefers-Reduced-Motion im Vary Header angegeben, um dem Browser mitzuteilen, dass der bereitgestellte Inhalt basierend auf diesem Header-Wert unterschiedlich sein wird, selbst wenn die URL gleich bleibt, sodass der Browser nicht einfach eine vorhandene zwischengespeicherte Antwort verwenden sollte und diese Antwort stattdessen separat zwischenspeichern sollte. Jeder Header, der im Critical-CH Header aufgeführt ist, sollte auch in den Accept-CH und Vary Headern vorhanden sein.

Der Client versucht automatisch erneut die Anfrage zu senden (aufgrund der oben angegebenen Critical-CH), und teilt dem Server über Sec-CH-Prefers-Reduced-Motion mit, dass eine Benutzerpräferenz für Animationen mit reduzierter Bewegung besteht:

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 einschließen, es sei denn, die Accept-CH ändert sich in den Antworten, um anzuzeigen, dass es vom Server nicht mehr unterstützt wird.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch