大网数据广告活动
Web 标准与前端开发

:scope

· 52CE 我爱测

**`:scope`** CSS 伪类表示作为选择器要匹配的作为参考点或作用域的元素。

:scope CSS 伪类表示作为选择器要匹配的作为参考点或作用域的元素。

/* 选择一个限制作用域的元素 */
:scope {
  background-color: lime;
}

:scope 匹配的元素取决于它的使用上下文:

  • 当在样式表的根级别使用时,:scope 等效于 :root——在常规 HTML 文档中匹配 html 元素。
  • 当在 @scope 块中使用时,:scope 匹配块所定义的作用域的根。它提供了一种从 @scope 块内部应用样式到作用域的根的方法。
  • 当在 DOM API 调用(例如 Element.querySelector、Element.querySelectorAll、Element.matches 或 Element.closest())中使用时,:scope 匹配调用此类方法的元素。

语法

:scope {
  /* ... */
}

示例

使用 :scope 来代替 :root

此示例展示了当在样式表的根级别使用时,:scope 等效于 :root。在当前示例中,提供的 CSS 会将 <html> 元素的背景颜色设置为橙色。

HTML

<html></html>

CSS

:scope {
  background-color: orange;
}

结果

使用 :scope 来代替 :root

使用 :scope 来为 @scope 块的作用域的根元素设置样式

在此示例中,我们使用两个单独的 @scope 块来匹配 .light-scheme 和 .dark-scheme 类中的链接。请注意,:scope 用于选择作用域的根元素并为其设置样式。在此示例中,作用域的根是应用了这些类的 div 元素。

HTML

<div class="light-scheme">
  <p>
    MDN 涵盖了很多有关
    <a href="/zh-CN/docs/Web/HTML">HTML</a>、<a href="/zh-CN/docs/Web/CSS"
      >CSS</a
    >
    和
    <a href="/zh-CN/docs/Web/JavaScript">JavaScript</a> 的信息。
  </p>
</div>

<div class="dark-scheme">
  <p>
    MDN 涵盖了很多有关
    <a href="/zh-CN/docs/Web/HTML">HTML</a>、<a href="/zh-CN/docs/Web/CSS"
      >CSS</a
    >
    和
    <a href="/zh-CN/docs/Web/JavaScript">JavaScript</a> 的信息。
  </p>
</div>

CSS

div {
  padding: 10px;
}
@scope (.light-scheme) {
  :scope {
    background-color: plum;
  }

  a {
    color: darkmagenta;
  }
}

@scope (.dark-scheme) {
  :scope {
    background-color: darkmagenta;
    color: antiquewhite;
  }

  a {
    color: plum;
  }
}

结果

使用 :scope 来为 @scope 块的作用域的根元素设置样式

在 JavaScript 中使用 :scope

此示例演示了如何在 JavaScript 中使用 :scope 伪类。如果你需要获取已获取的 Element 的直接后代,这可能会很有用。

HTML

<div id="context">
  <div id="element-1">
    <div id="element-1.1"></div>
    <div id="element-1.2"></div>
  </div>
  <div id="element-2">
    <div id="element-2.1"></div>
  </div>
</div>
<p>选择的元素 id:<span id="results"></span></p>

JavaScript

const context = document.getElementById("context");
const selected = context.querySelectorAll(":scope > div");

document.getElementById("results").innerHTML = Array.prototype.map
  .call(selected, (element) => `#${element.getAttribute("id")}`)
  .join("、");

结果

context 的作用域是 id 为 context 的元素。所选元素是此上下文的直接子元素——element-1 和 element-2——但不包括它们的后代。

在 JavaScript 中使用 :scope

规范

浏览器兼容性

参见

  • @scope at 规则
  • :root 伪类
  • DOM 树节点的选择和遍历
  • Element.querySelector() 和 Element.querySelectorAll()
  • Document.querySelector() 和 Document.querySelectorAll()
  • DocumentFragment.querySelector() 和 DocumentFragment.querySelectorAll()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。