CSS Containment
contentvisibilityautostatechange 事件会在设置了 content-visibility 的元素开始或不再与用户相关,且正在跳过其内容时触发。
在元素不再与用户相关时(在开始和结束事件之间),用户代理会跳过元素的渲染(包括布局和绘制),这可以显著提高页面渲染速度。element/contentvisibilityautostatechange_event 事件为应用代码在不需要时开始或停止渲染过程(如在 canvas 上绘画)提供了便利,进而节约了处理能力。
注意因为元素内容即使被隐藏不可见也仍将保持语义相关性(例如使用辅助技术的用户),所以不应使用此事件跳过重要的 DOM 语义更新。
语法
在 EventTarget.addEventListener 等方法中使用事件名称,或设置事件处理器属性。
addEventListener("contentvisibilityautostatechange", (event) => {});
oncontentvisibilityautostatechange = (event) => {};
[!NOTE] 事件的类型为 ContentVisibilityAutoStateChangeEvent。
示例
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) {
// …
}
规范
浏览器兼容性
参见
- ContentVisibilityAutoStateChangeEvent
- CSS 局限
- content-visibility 属性
- contain 属性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
