本文深入探讨了SASS中占位符选择器（placeholder selectors）与`@extend`指令在处理`:focus`等交互状态样式时可能遇到的问题。重点解析了将占位符嵌套在复杂选择器中导致样式无法生效的原因，并提供了正确的SASS结构和最佳实践，确保通过`@extend`高效复用焦点样式，避免常见陷阱，提升代码的可维护性与复用性。
在SASS的开发实践中，@extend指令和占位符选择器（以%开头的选择器）是实现样式复用和减少CSS输出体积的强大工具。然而，如果不理解其底层工作原理，尤其是在处理如:focus等交互状态时，可能会遇到样式不生效的问题。
理解SASS占位符与@extend
SASS的占位符选择器，例如%button-styling，本身并不会被编译成CSS。它们只有在被@extend指令引用时，其包含的样式才会被合并到引用它的选择器中。这种机制使得我们可以定义一系列可复用的样式片段，而无需担心它们会额外增加CSS文件的大小，除非它们被实际使用。
常见问题：占位符嵌套与复杂选择器
一个常见的误解是，可以在一个占位符内部定义另一个占位符，并在同一父占位符内部通过@extend引用它。考虑以下示例代码：
%button-styling {
color: $grey;
// 错误的占位符嵌套方式
%btn-focus {
color: $white;
}
&::focus,
&.focus {
@extend %btn-focus; // 这里的extend可能无法按预期工作
}
}这段代码的意图是定义一个通用的按钮样式%button-styling，并在其中为:focus和.focus状态定义一个单独的焦点样式%btn-focus，然后通过@extend应用它。然而，这种做法会导致%btn-focus中的样式无法生效。
根据SASS官方文档的说明，任何包含占位符选择器的复杂选择器都不会被编译到CSS中。在上述示例中，%btn-focus被定义在%button-styling内部，这意味着它本身也是一个复杂选择器的一部分（尽管是嵌套的）。更重要的是，当SASS解析%button-styling内部的&::focus, &.focus { @extend %btn-focus; }时，它会尝试将%btn-focus的样式合并进来。但由于%btn-focus自身定义在一个不会被直接输出的上下文中，并且它本身也是一个占位符，这种嵌套和引用的方式违反了SASS的编译规则，导致最终的CSS中缺少焦点样式。
正确的SASS结构与实践
要正确地使用占位符和@extend来管理焦点样式，我们应该将占位符定义在顶层，确保它们是独立的、可被全局引用的样式片段。然后，在需要应用这些样式的地方，通过@extend指令进行引用。
以下是修正后的SASS代码示例：
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
// 定义颜色变量
$grey: red;
$white: #FFF;
// 1. 定义独立的焦点占位符样式
%btn-focus {
color: $white; // 焦点状态下的颜色
}
// 2. 定义基础按钮占位符样式
%button-styling {
color: $grey; // 默认颜色
// 3. 在基础样式中引用焦点占位符
// &::focus 表示元素在获得焦点时
// &.focus 表示元素具有 .focus 类时
&:focus,
&.focus {
@extend %btn-focus; // 扩展焦点样式
}
}
// 4. 将占位符样式应用到实际的HTML元素选择器
button {
@extend %button-styling; // 按钮元素将拥有基础和焦点样式
}代码解析：
%btn-focus： 这是一个独立的占位符，专门用于定义焦点状态下的样式。它位于SASS文件的顶层，确保可以被任何选择器引用。
%button-styling： 这是一个定义按钮基础样式的占位符。
&:focus, &.focus { @extend %btn-focus; }： 在%button-styling内部，我们使用&引用当前选择器（即将来扩展%button-styling的实际选择器，例如button）。然后，我们为:focus伪类和.focus类扩展了%btn-focus中定义的样式。由于%btn-focus是一个顶层占位符，SASS可以正确地将其样式合并到button:focus和button.focus中。
-
button { @extend %button-styling; }： 最后，我们将%button-styling扩展到实际的button元素选择器上。这将导致SASS生成如下的CSS：
button { color: red; /* 来自 %button-styling 的基础样式 */ } button:focus, button.focus { color: #FFF; /* 来自 %btn-focus，通过 %button-styling 扩展 */ }
HTML 使用示例
在HTML中，你可以通过两种方式触发这些焦点样式：
<div> <!-- 通过添加 .focus 类来手动触发焦点样式 --> <button class="focus">带 .focus 类的按钮</button> </div> <div> <!-- 通过浏览器默认的焦点行为触发焦点样式 --> <button>普通按钮</button> </div>
当第一个按钮拥有.focus类时，或当第二个按钮通过键盘Tab键导航等方式获得焦点时，它们都将显示为白色文本。
注意事项与总结
- 占位符的独立性： 始终将占位符定义为独立的、顶层结构，而不是嵌套在其他复杂选择器或占位符内部。这确保了它们的可发现性和可扩展性。
- @extend的范围： @extend指令应该用于将占位符的样式合并到实际的CSS选择器中（例如button），或者在另一个占位符内部引用顶层占位符。
- 避免复杂选择器中的占位符： 牢记SASS的规则——包含占位符的复杂选择器不会被输出。这意味着像div %my-placeholder这样的选择器不会生成任何CSS，除非%my-placeholder被@extend到。
- 可读性和维护性： 采用清晰的占位符命名约定（如%component-state）可以提高代码的可读性和维护性。
通过遵循这些最佳实践，您可以有效地利用SASS的@extend和占位符选择器来构建模块化、高效且易于维护的样式表，尤其是在处理各种交互状态（如:hover, :active, :focus）时。
