Vue 组件转发 class 后 scoped 样式仍不生效
在设置页给 <ShSelect class="compact" /> 限制宽度,开发者工具里能看到按钮上的 compact,按钮却仍然占满一行。这时候最好先点开 Styles 面板,确认 .compact 编译成了什么,再检查它要求的属性有没有出现在按钮上。选项少了、菜单关了,甚至 DOM 里只剩一个按钮,都可能得到同样的结果。
处理方式取决于谁负责这个宽度。页面负责外部排版时,可以在页面自己的容器上设宽度。有稳定单根的控件可以沿用 Vue 的根元素继承。组件库如果承诺传入的 class 能直接样式化触发器,就要让这个触发器成为明确的样式目标。这样业务代码加宽度、悬停样式或布局类时,可以继续使用组件原有的调用方式。
一个按钮,两项匹配条件
Vue 把 <style scoped> 里的 .compact 编译成类似 .compact[data-v-parent] 的选择器。以下省略了其他属性,并用 data-v-parent 代替真实标记。浏览器只有在同一个元素同时满足两项条件时才会应用声明,和 Vue 文档中的 scoped CSS 编译示例 一样。
<!-- 调用方编译出来的选择器是 .compact[data-v-parent]。 -->
<button class="compact">窗口边框</button>
class 一路通过 $attrs 进入触发按钮。data-v-* 由 Vue 运行时按组件根元素规则向下应用。普通 VDOM 渲染 <slot /> 时会用一个 Fragment 承载输出,具体在 renderSlot。它在渲染树里保留结构,在 HTML 里没有对应的外壳,所以即使 Fragment 里只有一个按钮,作用域标记也会在这个边界停下。设置选择器里的 SelectRoot 和 PopperRoot 正好通过插槽组合触发器和菜单,这个结构可以从 Reka 的 SelectRoot 模板 看出来。
组件外面套了几层包装,最后依然只渲染一个带 class 的元素,调用方的 scoped 样式还是丢了。这也是 Vue Core #2669 里的例子。同一讨论还提到,如果让 $attrs 一律携带父组件的标记,父组件只想给自己的 input 设置颜色,规则却可能命中子组件里接收 $attrs 的内部输入框。组件库知道它对外公开的是哪一个节点,因此可以只对那个节点做转发。
在组件库里公开一个明确的样式目标
Reka 在修复 RadioGroupItem 和 ToggleGroupItem 时,从包装组件的 setup 中读取当前 VNode 的 scopeId,再把它作为属性交给实际控件。选择器和 Tooltip 可以共用这段逻辑。以下是 useForwardedScopeAttrs() 默认调用的等效实现,组件模板仍负责决定哪个元素接收标记。
import { getCurrentInstance } from 'vue';
export default function useForwardedScopeAttrs(): Readonly<Record<string, ''>> {
const scopeId = getCurrentInstance()?.vnode.scopeId;
return scopeId ? { [scopeId]: '' } : {};
}
<script setup lang="ts">
import { SelectRoot, SelectTrigger } from 'reka-ui';
import { useForwardedScopeAttrs } from '@sheng/vue-composables';
defineOptions({ inheritAttrs: false });
const triggerScopeAttrs = useForwardedScopeAttrs({ includeSlotScopeIds: true });
</script>
<template>
<select-root>
<select-trigger v-bind="{ ...$attrs, ...triggerScopeAttrs }">打开菜单</select-trigger>
</select-root>
</template>
选择器把 class 和标记绑定到 SelectTrigger。Tooltip 使用 as-child,所以绑定在实际的按钮或 span 上。两者都显式开启 includeSlotScopeIds,让触发器也能接收外层插槽的样式。业务组件可直接使用 class 和 scoped 规则,浮层沿用各自的样式接口。
普通 VDOM 和 Vue 3.6.0-rc.14 的 Vapor 互操作层都会填入组件 VNode 的 scopeId,因此 VDOM 封装可以从同一个字段读取调用方标记。多层祖先标记、纯 Vapor 封装端和 SSR 水合需要分别验证。只有几个稳定的视觉选项时,组件也可以提供 prop 或 CSS 自定义属性。
公开控件怎样接到工具栏的 :slotted() 样式
假设 Page.vue 把 <ActionButton class="action">保存</ActionButton> 放进 <Toolbar> 的默认插槽。页面给 .action 设置 font-weight: 600,工具栏则用 :slotted(.action) 把插槽里的操作按钮设为至少 96px 宽。两条规则分别写在各自的 <style scoped> 里,编译后要求不同的属性。
| 样式来自哪里 | 编译后的选择器(属性名为示意) | Vue 记录的位置 |
|---|---|---|
Page.vue 的 .action |
.action[data-v-page] |
ActionButton VNode 的 scopeId |
Toolbar.vue 的 :slotted(.action) |
.action[data-v-toolbar-s] |
ActionButton VNode 的 slotScopeIds |
ActionButton 有一个根 div,并把 $attrs 交给里面的按钮。Vue 会给根 div 加上插槽标记 data-v-toolbar-s,而 .action 在按钮上。于是即使按默认方式把 data-v-page 补给了按钮,工具栏的插槽选择器还是差一个匹配条件。渲染工具栏的 <slot /> 时,VDOM 的 renderSlot 会给工具栏的作用域 ID 拼上 -s,作为插槽内容的独立标记。
如果 ActionButton 对外公开的样式目标就是内层按钮,并且它也要接收插槽容器的 :slotted() 样式,就在 ActionButton 自己的 setup 中调用 useForwardedScopeAttrs({ includeSlotScopeIds: true })。一起绑定到按钮的属性从 { 'data-v-page': '' } 变为 { 'data-v-page': '', 'data-v-toolbar-s': '' },这时字重和最小宽度都能命中。同一个组件放在工具栏之外时,当前 VNode 上没有这枚工具栏标记,传 true 也只会转发页面的标记。
即使调用方没传 class,补给按钮的 -s 标记也会让 :slotted(button) 生效。这是两个控件对工具栏开放的样式契约。组合函数默认只转发普通作用域标记。关于工具栏应该在什么情况下使用插槽选择器,见用插槽选择器 slotted 给传入内容设样式。
ESLint 管内部字段的访问位置
共享项目预设检测到 Vue 后,默认启用 @sheng/vue-no-direct-vnode-scope-id。规则沿当前文件的词法绑定追溯 Vue 的 getCurrentInstance(),检查 scopeId 与 slotScopeIds。普通对象上的同名属性会放过。兼容函数可以用后置 flat config 为自己的文件关闭规则。规则只报告诊断,组件的公开接口决定属性该绑定到哪个节点。
inheritAttrs: false、v-bind="$attrs" 和插槽单独出现时都有合法用途。单个 SFC 的语法树看不到第三方组件最终把插槽渲染到了哪里,也无法判断组件公开的样式目标。静态规则可以集中管理已知的内部字段访问。要知道某个控件有没有漏掉标记,还要从真实调用方测起。
在浏览器里验证样式命中
Marker 的设置页用 Vapor 渲染,ShSelect 和 ShTooltip 用 VDOM 封装 Reka。设置选择器只改成直接绑定 class 时,Chromium 读到的 max-width 为 none。转发标记以后,getComputedStyle(button).maxWidth 是 340px,宽窗里也能和旁边的字体控件对齐。目录里的文件名提示则检查按钮的 display: grid,并在提示框打开后检查该标记留在按钮侧。
另一组 Chromium 回归测试用编译过的 :slotted() 样式检查真实组件。:slotted(.action) 给选择器按钮和 as="span" 的 Tooltip 触发器设置了 97px 的最小宽度,:slotted(button) 给按钮设置了 3px 的字距。测试还分别在浮层留在原位和传送到 body 时打开菜单和提示框,确认两处浮层都没有工具栏的插槽标记,也没有被专门用于探测浮层的 :slotted() 规则命中。