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-Hint des Benutzer-Agents, der die Präferenz des Benutzer-Agents 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 dann mit diesem Header antworten, um die Präferenz des Benutzers für reduzierte Bewegung anzugeben. Der Server kann entsprechend angepasste Inhalte senden, z. B. JavaScript oder CSS, um die Bewegung von Animationen im nachfolgenden gerenderten Inhalt zu reduzieren. Dies könnte beinhalten, die Geschwindigkeit oder Amplitude von Bewegungen zu reduzieren, um Unbehagen für Personen mit vestibulären Bewegungsstörungen zu mindern.
Dieser Header ist an die prefers-reduced-motion Media-Query angelehnt.
| Header-Typ | Request-Header, Client-Hint |
|---|---|
| Verbotener Request-Header | Ja (Sec- Präfix) |
Syntax
Sec-CH-Prefers-Reduced-Motion: <preference>
Direktiven
<preference>-
Die Präferenz des Benutzer-Agents für Animationen mit reduzierter Bewegung. Diese wird oft aus den Einstellungen des zugrunde liegenden Betriebssystems übernommen. Der Wert dieser Direktive kann entweder
no-preferenceoderreducesein.
Beispiele
Verwendung von Sec-CH-Prefers-Reduced-Motion
Der Client sendet eine erste Anfrage an den Server:
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, wobei Sec-CH-Prefers-Reduced-Motion als kritischer Client-Hint betrachtet wird.
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 ausgelieferte Inhalt basierend auf diesem Header-Wert unterschiedlich sein wird, auch wenn die URL gleich bleibt. Der Browser sollte also nicht einfach eine vorhandene zwischengespeicherte Antwort verwenden, sondern diese Antwort separat cachen. Jeder im Critical-CH Header aufgeführte Header sollte auch im Accept-CH und Vary Header vorhanden sein.
Der Client wiederholt die Anfrage automatisch (da Critical-CH oben angegeben ist) und teilt dem Server über Sec-CH-Prefers-Reduced-Motion mit, dass eine Benutzerpräferenz für Animationen mit reduzierter Bewegung besteht:
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 er vom Server nicht mehr unterstützt wird.
Spezifikationen
| Specification |
|---|
| User Preference Media Features Client Hints Headers # sec-ch-prefers-reduced-motion |