Viewport-Width header

已弃用：此特性不再推荐。虽然某些浏览器可能仍然支持它，但它可能已经从相关的网络标准中删除，可能正在删除过程中，或者可能仅为兼容性目的而保留。请避免使用它，如果可能，请更新现有代码；请参阅本页底部的兼容性表格以指导您的决策。请注意，此特性可能随时停止工作。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

非标准：此特性未标准化。我们不建议在生产环境中使用非标准特性，因为它们浏览器支持有限，并且可能会更改或被移除。但是，在没有标准选项的特定情况下，它们可以是合适的替代方案。

警告： Viewport-Width 请求头已在 draft-ietf-httpbis-client-hints-07 中从客户端提示规范中移除。建议替代方案是 Sec-CH-Viewport-Width（响应式图片客户端提示）。

HTTP Viewport-Width 请求头是一种设备客户端提示，它以 CSS 像素提供客户端布局视口的宽度。该值向上取整到最小的后续整数（即，向上取整）。

该提示可以与其他屏幕特定提示结合使用，以提供针对特定屏幕尺寸优化的图像，或省略特定屏幕宽度不需要的资源。如果 Viewport-Width 请求头在消息中出现多次，则使用最后一次出现的值。

服务器必须通过发送 Accept-CH 响应头来选择接收客户端发送的 Viewport-Width 请求头。选择加入的服务器通常也会在 Vary 请求头中指定它，这会通知缓存服务器可能会根据请求中的请求头值发送不同的响应。

头类型	请求标头，客户端提示
禁止请求头	否

语法

http

Viewport-Width: <number>

服务器必须首先通过发送包含指令 Viewport-Width 的响应头 Accept-CH 来选择接收 Viewport-Width 请求头。

http

Accept-CH: Viewport-Width

在后续请求中，客户端可能会发送 Viewport-Width 请求头。

http

Viewport-Width: 320

此页面由 MDN 贡献者最后修改于 2025年7月4日。