文档章节
CSS 函数
用这些函数处理 CSS 与 Sass 文件。
本章导读
css 命名空间下有四条不同的 CSS 处理管道,容易选错。它们都接收 assets/ 目录里的资源、返回一个资源(resource.Resource),区别在于背后用的工具和适合的输入:
css.Build:内嵌 esbuild,处理纯 CSS——递归内联@import、按目标浏览器转换语法与补前缀、压缩、生成 source map;css.Sass:把 Sass/SCSS 编译成 CSS(extended 版内置 LibSass;安装 Dart Sass 后可用最新语法);css.PostCSS:交给项目里安装的 PostCSS CLI 与插件,需要 Node 工具链;css.TailwindCSS:调用 Tailwind CSS v4 CLI,扫描模板里用到的工具类再生成 CSS。
另外两个小函数是「值的类型标记」,只用于 vars 选项:css.Quoted 让值注入时带引号,css.Unquoted 让值不带引号;css.ChromaStyles 则生成语法高亮器需要的样式表。
读完本章你应该能够
- 按输入与工具链选对管道:纯 CSS 用
css.Build、Sass 用css.Sass、插件生态用css.PostCSS、Tailwind v4 用css.TailwindCSS; - 把处理结果接进
<link>,并在生产环境配合fingerprint、minify; - 用
vars把站点配置注入样式表,并用css.Quoted/css.Unquoted控制引号; - 判断一条报错是「工具没装」「安全白名单没放行」还是「输入类型不对」。
建议阅读顺序
- 纯 CSS 管道:
css.Build; - Sass:
css.Sass→ 值标记css.Quoted/css.Unquoted; - 语法高亮样式表:
css.ChromaStyles; - 需要 Node 生态时:
css.PostCSS→css.TailwindCSS。
本章内容
- css.Build 返回把给定 CSS 资源打包、转换并压缩后生成的资源。 (今天)
- css.ChromaStyles 返回语法高亮器使用的 CSS 样式表。 (今天)
- css.PostCSS 返回用 PostCSS 处理给定 CSS 资源后生成的资源。 (今天)
- css.Quoted 返回给定字符串,并把其数据类型标记为在 CSS 中使用时必须带引号。 (今天)
- css.Sass 返回把给定 Sass 资源转译为 CSS 后生成的资源。 (今天)
- css.TailwindCSS 返回用 Tailwind CSS CLI 处理给定资源后生成的资源。 (今天)
- css.Unquoted 返回给定字符串,并把其数据类型标记为在 CSS 中使用时不得带引号。 (今天)