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,导入后由构建工具生成最终资源地址。
<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>预期结果
组件根节点的 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 进入构建依赖图。