Nuxt 菜鸟入门学习笔记五：CSS 样式

Nuxt 官网地址： https://nuxt.com/

Nuxt 在样式设计方面非常灵活。

• 可以编写自己的样式；
• 可以引用本地和外部样式表；
• 可以使用 CSS 预处理器、CSS 框架、UI 库和 Nuxt 模块来为应用程序设计样式。

本地样式表

按照惯例，将本地样式表放在assets/目录下。

在组件内导入

在组件内导入的样式表将在 Nuxt 渲染的 HTML 中内联。可以通过以下方式导入：

• 可以在页面、布局和组件中直接导入样式表。
• 可以使用 javascript 导入或 css @import 语句。

代码示例：

1. 创建 /assets/css/first.css 文件，内容如下：

// assets/css/first.css.first {background-color: red;
}

2. 在页面中导入，并应用：

// pages/about.vue<template><div><h1>@ index page</h1><AppAlert class="first">AppAlert Component.</AppAlert></div>
</template><script>
// 使用静态导入以实现服务器端兼容性
// import "~/assets/css/first.css";// 注意：动态导入与服务器端不兼容
// import("~/assets/css/first.css");
</script><style>
@import url("~/assets/css/first.css");
</style>

通过 Nuxt 配置 CSS 属性导入

可以在 Nuxt 配置中使用 css 属性来导入本地样式表，Nuxt 将把它包含到应用程序的所有页面中。这种方式导入样式表也将在 Nuxt 渲染的 HTML 中内联，全局注入并出现在所有页面中。

注意：即便页面中没有用到样式表中的样式规则，也会注入并在 HTML 中内联。

代码示例：

1. 创建 /assets/css/main.css 文件，内容如下：

// assets/css/main.css.text-bold {font-weight: bold;
}

2. 在 Nuxt 配置中导入：

// nuxt.config.tsexport default defineNuxtConfig({devtools: { enabled: true },pages: true,vite: {css: {preprocessorOptions: {scss: {additionalData: '@use "@/assets/scss/_colors.scss" as *;',},},},},// 导入本地样式表css: ["~/assets/css/main.css"],
});

3. 在页面中导入，并应用：

// pages/about.vue<template><div><h1>@ index page</h1><AppAlert class="first text-bold">AppAlert Component.</AppAlert></div>
</template><script>
// 使用静态导入以实现服务器端兼容性
// import "~/assets/css/first.css";// 注意：动态导入与服务器端不兼容
// import("~/assets/css/first.css");
</script><style>
@import url("~/assets/css/first.css");
</style>

使用字体

将下载的字体文件放在 ~/public/ 目录下，例如~/public/fonts。然后就可以在样式表中使用 url() 引用它们。

代码示例：

1. 在 css 文件引用字体，并在样式中使用:

// assets/css/main.css.text-bold {font-weight: bold;
}// 引用定义字体
@font-face {font-family: "MyFont";src: url("/fonts/test.ttf");font-weight: normal;font-style: normal;font-display: swap;
}// 样式汇中使用字体
.cool-text {font-family: "MyFont";font-size: 22px;
}

2. 在样式表、页面或组件中通过样式应用字体：

// pages/index.vue<template><div><h1>@ index page</h1><AppAlert class="first text-bold">AppAlert Component.</AppAlert><p class="cool-text">爱拼才会赢！</p></div>
</template>

导入通过 NPM 发布的样式表

可以引用通过 npm 发布的样式表。让我们以流行的 animate.css 库为例。

1. 先安装 animate.css 库：

pnpm add animate.css

2. 导入 animate.css:

• 在页面、布局和组件中直接引用：

// pages/index.vue<script>
// 通过js导入
import "animate.css";
</script><style>
// 通过css导入
@import url("animate.css");
</style>

• 在 Nuxt 配置的 css 属性中导入：

// nuxt.config.tsexport default defineNuxtConfig({devtools: { enabled: true },pages: true,vite: {css: {preprocessorOptions: {scss: {additionalData: '@use "@/assets/scss/_colors.scss" as *;',},},},},css: ["~/assets/css/main.css", "animate.css"],
});

3. 使用 animate.css 的动画样式：

<template><div><h1>@ index page</h1><AppAlert class="first text-bold">AppAlert Component.</AppAlert><p class="cool-text animate__animated animate__bounceIn">爱拼才会赢！</p></div>
</template><script>
// 使用静态导入以实现服务器端兼容性
// import "~/assets/css/first.css";// 注意：动态导入与服务器端不兼容
// import("~/assets/css/first.css");// import "animate.css";
</script><style>
@import url("~/assets/css/first.css");
/* @import url("animate.css"); */
</style>

外部样式表

通过在 nuxt.config 文件的 head 部分添加链接元素，就可以在应用程序中包含外部样式表。我们可以使用 Nuxt 配置中的 app.head 属性来操作头部：

// nuxt.config.tsexport default defineNuxtConfig({devtools: { enabled: true },pages: true,vite: {css: {preprocessorOptions: {scss: {additionalData: '@use "@/assets/scss/_colors.scss" as *;',},},},},css: ["~/assets/css/main.css"],app: {head: {link: [{rel: "stylesheet",href: "https://cdnjs.cloudflare.com/ajax/libs/animate.css/4.1.1/animate.min.css",},],},},
});

当然还可以使用不同的方法实现这一结果，而且本地样式表也可以这样包含。

动态添加样式表

可以在代码中使用 useHead 组合式函数来动态设置 head 中的值。

useHead({link: [{rel: "stylesheet",href: "https://cdnjs.cloudflare.com/ajax/libs/animate.css/4.1.1/animate.min.css",},],
});

注意： 这种方式目前使用体验不是很好，如果要使用这种方式，需要做更多技术实践。

【高级】使用 Nitro 插件修改渲染的头部

如果需要更高级的控制，可以使用钩子拦截渲染的 html，并以编程方式修改头部。
此处暂不介绍，如有兴趣，提供官方链接：https://nuxt.com/docs/getting-started/styling#dynamically-adding-stylesheets

使用预处理器

常用预处理器 SCSS、Sass、Less 或 Stylus 等，使用前需要先安装。
本文以 SCSS 为例：

1. 进行安装：

pnpm add sass

2. 创建 scss 文件：

// assets/scss/main.scss.parent {background-color: #eee;padding: 20px;.child {background-color: aquamarine;padding: 20px;}
}

3. 两种导入方式：

• 可以在页面、布局和组件中使用预处理器的语法导入源文件。

  <style lang="scss">
  @use "~/assets/scss/main.scss";
  </style>
  

• 可以使用 Nuxt 配置文件中 css 属性全局导入。

  export default defineNuxtConfig({css: ["~/assets/scss/main.scss"],
  });
  

无论使用上面的哪种导入方式，编译后的样式表将被内联到 Nuxt 渲染的 HTML 中。

如果你需要在预处理文件中注入代码，比如带有颜色变量的 sass 部分，你可以使用 vite 预处理器选项来实现。（前一篇文章静态资源中全局样式导入有样式实现，或者参考官方文档：https://nuxt.com/docs/getting-started/styling#dynamically-adding-stylesheets）
Nuxt 默认使用 Vite。如果希望使用 webpack，请参阅每个预处理器加载器的文档。

单文件组件 SFC 样式

Vue 和 SFC 最棒的地方之一就是它能很自然地处理样式。可以直接在组件文件的样式块中编写 CSS 或预处理代码，因此无需使用 CSS-in-JS 之类的东西就能获得绝佳的开发体验。

【拓展】如果你想使用 CSS-in-JS，你可以找到支持它的第三方库和模块，比如 pinceau。可以参考Vue 文档，获取关于SFC中组件样式的全面参考。

类和样式绑定

在 Vue 的 SFC 组建中，可以通过类和样式属性来为组件设置样式。
详细内容请阅读 Vue 文档：Class 与 Style 绑定

使用 v-bind 的动态样式

可以使用 v-bind 函数在样式块中引用 JavaScript 变量和表达式。绑定将是动态的，这意味着如果变量值发生变化，样式也将随之更新。

// pages/test.vue<script setup>
const color = ref("red");
setTimeout(() => {color.value = "yellow";
}, 3000);
</script><template><div class="text">hello</div>
</template><style>
.text {color: v-bind(color);
}
</style>

Scoped Styles

范围属性允许对组件进行独立样式化。使用该属性声明的样式将仅适用于该组件。

<template><div class="example">hi</div>
</template><style scoped>
.example {color: red;
}
</style>

更多内容请阅读 Vue 文档：单文件组件 CSS 功能

CSS Modules

可以通过 module 属性使用 CSS 模块。使用注入的 $style 变量访问它。

<template><p :class="$style.red">This should be red</p>
</template><style module>
.red {color: red;
}
</style>

预处理器支持

SFC 样式块支持预处理器语法。Vite 内置支持.scss、.sass、.less、.styl 和.stylus 文件，无需配置。只需先安装它们，然后就可以直接在 SFC 中使用 lang 属性。

<style lang="scss">
/* Write scss here */
</style>

使用 PostCSS

科普：PostCSS 是什么？
PostCSS 是一个使用 JS 插件转换 CSS 的工具。这些插件可以支持变量和混合、transpile 未来 CSS 语法、内联图像等。
官网链接：https://www.postcss.com.cn/

Nuxt 内置了 postcss。可以在nuxt.config文件中进行配置。

export default defineNuxtConfig({postcss: {plugins: {'postcss-nested': {}"postcss-custom-media": {}}}
})

为了在 SFC 中使用正确的语法高亮，可以使用 postcss lang 属性。

<style lang="postcss">/* Write stylus here */</style>

默认情况下，Nuxt 已经预配置了以下插件：

• postcss-import: Improves the @import rule
• postcss-url: Transforms url() statements
• autoprefixer: Automatically adds vendor prefixes
• cssnano: Minification and purge

利用布局实现多种风格

如果需要为应用程序的不同部分设计完全不同的布局样式，可以使用布局。
布局在上一篇文章的视图章节有简单介绍，此处不做更多讲解，后续专门用一篇文章来细说。

第三方库和模块

在样式设计方面，Nuxt 并不墨守成规，而是为我们提供了多种选择。可以使用任何想要的样式工具，如 UnoCSS 或 Tailwind CSS 等流行库。社区和 Nuxt 团队开发了大量的 Nuxt 模块，使集成变得更加容易。可以在网站的模块部分找到它们。这里有几个模块可以帮助我们开始使用：

• UnoCSS: Instant on-demand atomic CSS engine
• Tailwind CSS: Utility-first CSS framework
• Fontaine: Font metric fallback
• Pinceau: Adaptable styling framework
• NuxtLabs UI

轻松加载网络字体

可以使用Nuxt Google Fonts 模块来加载 Google Fonts。
如果使用的是UnoCSS，请注意它自带了一个网页字体预设，可以方便地加载来自常见供应商的字体，包括 Google Fonts 等。