Sec-CH-Prefers-Reduced-Transparency

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-Transparency Request-Header ist ein User-Agent-Client-Hinweis, der die Präferenz des User-Agents für reduzierte Transparenz anzeigt.

Wenn ein Server dem Client über den Accept-CH-Header signalisiert, dass er Sec-CH-Prefers-Reduced-Transparency akzeptiert, kann der Client mit diesem Header antworten, um die Präferenz des Benutzers für reduzierte Transparenz anzugeben. Der Server kann dann dem Client entsprechend angepassten Inhalt senden — zum Beispiel CSS oder Bilder — um die Transparenz des Inhalts zu reduzieren.

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

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

Syntax

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

Direktiven

<preference>

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

Beispiele

Verwendung von Sec-CH-Prefers-Reduced-Transparency

Der Client stellt eine erste 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-Transparency akzeptiert. In diesem Beispiel wird auch Critical-CH verwendet, was darauf hinweist, dass Sec-CH-Prefers-Reduced-Transparency als kritischer Client-Hinweis betrachtet wird.

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

Hinweis: Wir haben auch Sec-CH-Prefers-Reduced-Transparency im Vary-Header angegeben, um dem Browser anzuzeigen, dass der bereitgestellte Inhalt je nach Wert dieses Headers unterschiedlich sein wird — auch wenn die URL gleich bleibt —, sodass der Browser nicht einfach eine vorhandene zwischengespeicherte Antwort verwenden sollte, sondern diese Antwort 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 die Anfrage automatisch erneut (da Critical-CH oben angegeben wurde) und teilt dem Server über Sec-CH-Prefers-Reduced-Transparency mit, dass eine Benutzerpräferenz für reduzierte Transparenz besteht:

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

Der Client wird den Header in nachfolgenden Anfragen in der aktuellen Sitzung aufnehmen, es sei denn, das 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-transparency

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Sec-CH-Prefers-Reduced-Transparency request header
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

Siehe auch