trim_css

指令 `trim_css` 启用从 HTML 响应中的内联 CSS 中剔除空白和注释。

语法trim_css on | off;
默认值off
上下文http, server, location
参数1

说明

NGINX 中的 trim_css 指令专为在 ngx_http_trim_filter 模块中使用而设计,该模块在将 HTML 响应发送给客户端之前对其进行处理。启用 trim_css on; 时,该指令会指示 NGINX 从 HTML 内容中 <style> 标签内的内联 CSS 中移除不必要的空白和注释。这可以显著减少 HTML 有效载荷的大小,改善页面加载时间和整体性能,尤其是对于可能包含大量空白或注释的 CSS。

trim_css 指令的功能是更广泛修剪机制的一部分,该机制以状态机范式运行。它逐字符分析 HTML 和 CSS 内容,根据上下文决定何时保留或丢弃空白和注释。该指令对于优化网页渲染特别有用,并且与管理 JavaScript 修剪和整体 HTML 修剪的相关指令互为补充。需要注意的是,该指令会尊重某些标签,在这些标签内内容保持不变,例如 <pre><textarea>,以及面向 Internet Explorer (IE) 的内联注释。

httpserverlocation 等上下文中,可以根据 Web 应用或站点结构的具体需求有选择地应用此指令。

配置示例

location / {
    trim on;
    trim_css on;
}

确保在正确的上下文(http、server、location)中设置 trim_css,以便生效。

如果在部署前未经过充分测试,过度使用修剪可能会导致 CSS 中重要的空白丢失。

如果多个修剪指令错误地组合使用,可能会产生冲突。

← 返回所有指令