讲师中心 微信公众号
AI工具推荐 视频效率加速

CSS样式作用域控制_Scoped CSS在Vue组件中的引入

星芳大大_1638

星芳大大_1638

发布时间:2026-02-26 15:23:02

|

460人浏览过

|

来源于php中文网

原创

Vue的scoped样式通过编译时为选择器和元素添加唯一data-v-xxx属性实现伪作用域隔离,非真正的Shadow DOM;穿透需用:deep(),且仅括号内选择器生效。

css样式作用域控制_scoped css在vue组件中的引入

Vue单文件组件里

它不是简单地给元素加个属性选择器,而是让CSS只作用于当前组件的根元素及其子树——但这个“只作用”是靠编译时加属性选择器模拟出来的,不是运行时隔离。

编译后,<style scoped></style> 里的 .btn 会变成类似 .btn[data-v-f3f518dc],同时 Vue 会给组件所有顶层元素自动加上 data-v-f3f518dc 属性。所以它本质是 CSS 层面的“作用域伪装”,不是 Shadow DOM 那种真正隔离。

  • 子组件的根元素也会被自动打上这个 data-v-xxx 属性,但它的内部元素不会——除非你显式用 deep 或 :deep()
  • 如果子组件用了 inheritAttrs: false,又没手动把 $attrs 挂到根元素上,那个 data-v-xxx 属性可能就丢了,导致样式失效
  • <style scoped></style> 对 <style></style> 标签外的全局样式、CSS-in-JS、或第三方库注入的样式完全没影响

想穿透scoped样式改子组件内部元素,该用 :deep() 还是 /deep/

/deep/ 是老写法,Vue CLI 4.5+ 和 Vite 默认已弃用;现在统一用 :deep()(函数调用语法),它明确告诉编译器:这里的内容不加 data-v-xxx 属性前缀。

注意 :deep() 只能用在 <style scoped></style> 内部,且只对括号里的选择器生效,外面的仍受 scoped 约束。

立即学习“前端免费学习笔记(深入)”;

Element Plus UI Vue3
Element Plus UI Vue3

Element Plus Vue3 桌面组件库。在开发 Vue 3.x 页面时调用,使用 Element Plus 组件(如 el-button、el-input、el-form、el-table 等)。

下载
  • 写法::deep(.el-input__inner) { border: 2px solid red; } —— 只有 .el-input__inner 会穿透,前面的父选择器依然带 data-v-xxx
  • 不能写成 :deep(.parent .el-input__inner) 然后指望整个链路都穿透;只有括号里那部分被豁免
  • Vite + Vue 3 中,::v-deep() 已彻底移除,强行用会报错;/deep/ 虽然部分构建工具还兼容,但属于技术债

scoped样式和CSS Modules谁更适合大型项目

Vue 的 scoped 是轻量级、零配置的局部化方案;CSS Modules 是更严格的模块化系统,需构建工具支持,生成的类名更可控,但要多写 import styles from './xxx.module.css' 和 :class="styles.xxx"。

如果你的项目已经重度依赖 class 绑定、动态 class 切换、或需要服务端渲染时保证 class 名稳定,CSS Modules 更可靠;但若只是避免样式污染、团队习惯直接写 class="xxx",scoped 足够用。

  • scoped 编译出的 data-v-xxx 属性在 SSR 中也存在,但 class 名本身不唯一,不利于缓存和调试
  • CSS Modules 的 class 名默认带哈希(如 Button_button__aBc12),天然支持按需导出、类型提示(配合 @types/css-modules)
  • 两者不互斥:可以 <style module></style> 和 <style scoped></style> 并存,但一般不这么干——语义冲突

为什么有时候scoped样式突然不生效了

最常见原因不是写错了,而是组件结构或渲染时机导致属性没挂上。

比如异步加载子组件、使用 v-if 切换、或子组件根节点是 <teleport></teleport> 目标容器——这些场景下,data-v-xxx 属性可能根本没出现在目标 DOM 上。

  • 检查浏览器开发者工具里对应元素有没有 data-v-xxx 属性;没有就说明 Vue 没把它当本组件 DOM 渲染
  • <teleport to="#modal-root"></teleport> 内的内容完全脱离当前组件作用域,scoped 样式对其无效,必须用 :deep() + 全局样式配合,或单独抽离 CSS
  • 使用 defineAsyncComponent 时,如果异步组件还没加载完成,占位用的 <div> 可能没带 <code>data-v-xxx,等真实组件挂载后才补上——此时样式会闪一下

    scoped 的边界感很弱,它依赖 Vue 的模板编译和 DOM 注入逻辑;一旦跳出这个路径,就得靠手动控制或换方案。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

4316

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

306

2025.12.06

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

4716

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1415

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1838

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

10263

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

1020

2023.09.01

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2964

2023.09.04

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

0

2026.11.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn