Sec-CH-Prefers-Reduced-Motion 頭

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

HTTP Sec-CH-Prefers-Reduced-Motion 請求頭是一個使用者代理客戶端提示,它指示使用者代理傾向於顯示減少動畫效果。

如果伺服器透過 Accept-CH 頭向客戶端發出訊號,表示它接受 Sec-CH-Prefers-Reduced-Motion,客戶端隨後可以透過此頭響應,指示使用者對減少動畫效果的偏好。伺服器可以向客戶端傳送適當調整的內容,例如 JavaScript 或 CSS,以減少後續渲染內容中呈現的任何動畫的運動。這可能包括降低運動速度或幅度,以減少前庭運動障礙患者的不適。

此頭是根據 prefers-reduced-motion 媒體查詢建模的。

頭型別 請求標頭客戶端提示
禁止請求頭 是 (Sec- 字首)

語法

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

指令

<preference>

使用者代理對減少動畫效果的偏好。這通常取自底層作業系統的設定。此指令的值可以是 no-preferencereduce

示例

使用 Sec-CH-Prefers-Reduced-Motion

客戶端向伺服器發出初始請求

http
GET / HTTP/1.1
Host: example.com

伺服器響應,透過 Accept-CH 告訴客戶端它接受 Sec-CH-Prefers-Reduced-Motion。在此示例中,Critical-CH 也被使用,表明 Sec-CH-Prefers-Reduced-Motion 被視為關鍵客戶端提示

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

注意:我們還在 Vary 頭中指定了 Sec-CH-Prefers-Reduced-Motion,以向瀏覽器指示即使 URL 保持不變,所提供的內容也會根據此頭值而有所不同,因此瀏覽器不應只使用現有的快取響應,而應單獨快取此響應。Critical-CH 頭中列出的每個頭也應出現在 Accept-CHVary 頭中。

客戶端自動重試請求(由於上面指定了 Critical-CH),透過 Sec-CH-Prefers-Reduced-Motion 告訴伺服器它具有減少動畫效果的使用者偏好

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

客戶端將在當前會話的後續請求中包含該頭,除非響應中的 Accept-CH 發生變化,表明伺服器不再支援它。

規範

規範
使用者偏好媒體特性客戶端提示標頭
# sec-ch-prefers-reduced-motion

瀏覽器相容性

另見