DPR header

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

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

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

警告:DPR header 已從客戶端提示規範的 draft-ietf-httpbis-client-hints-07 中移除。建議的替代方案是 Sec-CH-DPR (響應式圖片客戶端提示)。

HTTP DPR 請求頭提供了關於客戶端裝置畫素比(DPR)的裝置客戶端提示。此比例是對應於每個CSS 畫素的物理裝置畫素數量。

此提示在選擇最符合螢幕畫素密度的影像源時非常有用。這類似於 <img> srcset 屬性中 x 描述符所扮演的角色,允許使用者代理選擇首選影像。

如果伺服器使用 DPR 提示選擇在響應中傳送的資源,則響應必須包含 Content-DPR 頭。如果 Content-DPR 中的值與請求的 DPR 頭中的值不同,客戶端必須使用 Content-DPR 中的值進行佈局。如果 DPR 頭在訊息中出現多次,則使用最後一次出現的值。

選擇接收 DPR 客戶端提示的伺服器通常也會在 Vary 頭中指定它,以告知快取伺服器可能會根據請求中的頭值傳送不同的響應。

頭型別 請求標頭客戶端提示
禁止請求頭

語法

http
DPR: <number>

指令

<number>

客戶端裝置畫素比。

示例

伺服器必須首先透過傳送包含 DPR 指令的響應頭 Accept-CH 來選擇接收 DPR 頭。

http
Accept-CH: DPR

然後在後續請求中,客戶端可能會將 DPR 頭髮送到伺服器

http
DPR: 2.0

如果帶有 DPR 頭(如上所示)的請求是針對影像資源的,則伺服器響應必須包含 Content-DPR

http
Content-DPR: 2.0

瀏覽器相容性

另見