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.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Tiêu đề HTTP Sec-CH-Prefers-Reduced-Motion request header là một gợi ý máy khách tác nhân người dùng cho biết sở thích của tác nhân người dùng về việc hiển thị hoạt ảnh với chuyển động giảm thiểu.
Nếu máy chủ báo hiệu cho máy khách thông qua tiêu đề Accept-CH rằng nó chấp nhận Sec-CH-Prefers-Reduced-Motion, máy khách có thể phản hồi bằng tiêu đề này để cho biết sở thích của người dùng về chuyển động giảm thiểu. Máy chủ có thể gửi nội dung phù hợp cho máy khách, ví dụ: JavaScript hoặc CSS, để giảm chuyển động của bất kỳ hoạt ảnh nào được trình bày trong nội dung render sau đó. Điều này có thể bao gồm giảm tốc độ hoặc biên độ chuyển động để giảm sự khó chịu cho những người có rối loạn chuyển động tiền đình.
Tiêu đề này được mô phỏng theo truy vấn media CSS prefers-reduced-motion.
| Loại tiêu đề | Request header, Client hint |
|---|---|
| Forbidden request header | Có (tiền tố Sec-) |
Cú pháp
Sec-CH-Prefers-Reduced-Motion: <preference>
Chỉ thị
<preference>-
Sở thích của tác nhân người dùng về hoạt ảnh chuyển động giảm thiểu. Thường được lấy từ cài đặt hệ điều hành cơ bản. Giá trị của chỉ thị này có thể là
no-preferencehoặcreduce.
Ví dụ
Sử dụng Sec-CH-Prefers-Reduced-Motion
Máy khách thực hiện yêu cầu ban đầu đến máy chủ:
GET / HTTP/1.1
Host: example.com
Máy chủ phản hồi, báo cho máy khách thông qua Accept-CH rằng nó chấp nhận Sec-CH-Prefers-Reduced-Motion. Trong ví dụ này, Critical-CH cũng được sử dụng, cho biết rằng Sec-CH-Prefers-Reduced-Motion được coi là gợi ý máy khách quan trọng.
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
Note:
Chúng tôi cũng đã chỉ định Sec-CH-Prefers-Reduced-Motion trong tiêu đề Vary để báo cho trình duyệt biết rằng nội dung được phục vụ sẽ khác nhau dựa trên giá trị tiêu đề này, ngay cả khi URL không thay đổi, do đó trình duyệt không nên chỉ sử dụng phản hồi đã được lưu trong bộ nhớ đệm mà nên lưu phản hồi này riêng biệt. Mỗi tiêu đề được liệt kê trong tiêu đề Critical-CH cũng phải có trong tiêu đề Accept-CH và Vary.
Máy khách tự động thử lại yêu cầu (do Critical-CH được chỉ định ở trên), báo cho máy chủ thông qua Sec-CH-Prefers-Reduced-Motion rằng nó có sở thích của người dùng về hoạt ảnh chuyển động giảm thiểu:
GET / HTTP/1.1
Host: example.com
Sec-CH-Prefers-Reduced-Motion: "reduce"
Máy khách sẽ bao gồm tiêu đề trong các yêu cầu tiếp theo trong phiên hiện tại, trừ khi Accept-CH thay đổi trong các phản hồi để cho biết rằng nó không còn được máy chủ hỗ trợ.
Đặc tả
| Specification |
|---|
| User Preference Media Features Client Hints Headers # sec-ch-prefers-reduced-motion |
Tương thích trình duyệt
Xem thêm
- Client hints
- User-Agent Client Hints API
Accept-CH- Truy vấn media CSS
prefers-reduced-motion - HTTP Caching: Vary và tiêu đề
Vary - Improving user privacy and developer experience with User-Agent Client Hints (developer.chrome.com)