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

ContentVisibilityAutoStateChangeEvent

· 52CE 我爱测

`ContentVisibilityAutoStateChangeEvent`** 接口是 element/contentvisibilityautostatechange_event 事件的对象。对于设置了 content-visibility 的任意元素,在元素开始或不再与用户相关,且正在跳过其内容时触发此事件。

CSS Containment

ContentVisibilityAutoStateChangeEvent 接口是 element/contentvisibilityautostatechange_event 事件的对象。对于设置了 content-visibility 的任意元素,在元素开始或不再与用户相关,且正在跳过其内容时触发此事件。

在元素不再与用户相关时(在开始和结束事件之间),用户代理会跳过元素的渲染(包括布局和绘制),这可以显著提高页面渲染速度。element/contentvisibilityautostatechange_event 事件为应用代码在不需要时开始或停止渲染过程(如在 canvas 上绘画)提供了便利,进而节约了处理能力。

注意因为元素内容即使被隐藏不可见也仍将保持语义相关性(例如使用辅助技术的用户),所以不应使用此事件跳过重要的 DOM 语义更新。

构造函数

  • ContentVisibilityAutoStateChangeEvent.ContentVisibilityAutoStateChangeEvent
    • : 创建新的 ContentVisibilityAutoStateChangeEvent 对象实例。

实例属性

从其父接口 Event 继承属性。

  • ContentVisibilityAutoStateChangeEvent.skipped
    • : 如果用户代理正在跳过元素的渲染则返回 true,否则返回 false。

示例

const canvasElem = document.querySelector("canvas");

canvasElem.addEventListener("contentvisibilityautostatechange", stateChanged);
canvasElem.style.contentVisibility = "auto";

function stateChanged(event) {
  if (event.skipped) {
    stopCanvasUpdates(canvasElem);
  } else {
    startCanvasUpdates(canvasElem);
  }
}

// 在画布需要开始更新时调用此方法。
function startCanvasUpdates(canvas) {
  // …
}

// 在画布需要停止更新时调用此方法。
function stopCanvasUpdates(canvas) {
  // …
}

规范

浏览器兼容性

参见

  • element/contentvisibilityautostatechange_event 事件
  • CSS 局限
  • content-visibility 属性
  • contain 属性

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

资料来源与适用范围

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

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

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