Vue / 系统课时

样式作用域与资源引用

样式作用域与资源引用

在单文件组件里,样式隔离和资源路径如果处理不当,最常见的结果是全局样式互相污染、CSS Modules 绑定失效,或图片在构建后找不到。本节用一个组件把 scoped、CSS Modules 与静态资源引用放在一起,明确它们各自负责什么。

学习目标

  • 理解 scoped 与 CSS Modules 的隔离机制和适用边界
  • 正确引用由构建工具处理的静态资源与 public 目录资源
  • 在需要穿透子组件或插槽内容时选择合适的样式写法

先划清三种样式边界

普通 <style> 会进入全局样式空间,适合重置样式、设计令牌和全站基础规则。<style scoped> 会给当前组件模板中的元素和选择器附加作用域标记,使规则默认只命中当前组件。<style module> 则把类名编译成局部映射,模板通过 $style 显式引用。

方式 主要用途 关键特点
普通 <style> 全局基础样式 选择器不隔离
<style scoped> 组件内部样式 选择器自动附加作用域标记
<style module> 可显式引用的局部类名 类名编译后生成局部映射

scoped 不是 Shadow DOM。它仍然使用普通 CSS,只是编译器重写选择器,因此继承、层叠和优先级规则依然存在。

在一个组件里组合使用

下面示例可直接保存为已创建的 Vue 3 + Vite 项目中的 ProfileCard.vue。图标放在同目录的 assets/logo.svg,导入后由构建工具生成最终资源地址。

vue
<script setup lang="ts">
import logoUrl from './assets/logo.svg'
</script>

<template>
  <section class="card">
    <img class="logo" :src="logoUrl" alt="Company logo">
    <h2 :class="$style.title">Engineering Profile</h2>
    <div class="content">
      <slot />
    </div>
  </section>
</template>

<style scoped>
.card {
  padding: 16px;
  border: 1px solid #d9d9d9;
}

.logo {
  width: 40px;
  height: 40px;
}

:slotted(a) {
  text-decoration: underline;
}
</style>

<style module>
.title {
  margin: 8px 0;
  font-size: 20px;
}
</style>

预期结果

text
组件根节点的 card 和 logo 样式只在当前组件作用域内生效。
标题类名通过 $style.title 绑定,并在构建后变成局部化类名。
logo.svg 被解析为构建产物中的资源 URL;插槽传入的链接显示下划线。

这里用 scoped 管理大部分组件内部规则,用 CSS Modules 演示需要显式类名映射的场景。二者可以共存,但企业项目通常应先统一团队约定,避免同一组件无理由混用两套风格。

正确处理静态资源

放在源码目录中的资源应优先使用 import,例如示例里的 logoUrl。这样资源会进入依赖图,开发服务器和生产构建都能重写路径,并可参与文件名哈希等处理。

public 目录适合必须保持原文件名、且不需要构建处理的文件。引用时从站点根路径开始,例如 src="/robots-logo.svg",不要写成 src="/public/robots-logo.svg"。

如果资源路径需要根据运行数据完全动态拼接,不要假设构建工具能扫描出所有可能文件。更稳妥的做法是显式建立资源映射,再根据业务键选择已导入的 URL。

处理跨边界样式

父组件的 scoped 规则不应该依赖子组件内部 DOM 结构。确实要影响子组件深层元素时,可以使用 :deep(),但它会增加父组件与子组件实现细节的耦合;对插槽传入内容则优先使用 :slotted()。

全局规则也应集中管理。主题变量、字体、重置样式放在应用入口样式中;业务组件只保留自身布局和状态样式,可以显著减少“改一个组件,另一个页面跟着变”的风险。

选择策略可以归结为一句话:默认组件样式用 scoped,需要显式类名映射时用 CSS Modules,真正跨组件共享的基础规则放全局;资源则优先通过 import 进入构建依赖图。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

样式作用域与资源引用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通