LayoutShift: value 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

LayoutShift 接口的只读属性 value 返回布局移动得分,该得分计算为影响分数(视口移动的部分所占比例)乘以距离分数(移动距离占视口的比例)。

一个介于 0.01.0 之间的数字,表示布局移动得分。

其计算方法是:影响分数(视口移动的部分所占比例)乘以距离分数(移动距离占视口的比例)。

layout shift score = impact fraction * distance fraction

有关更多详细信息,请参阅 web.dev 上的 布局移动得分

示例

记录条目的布局移动得分

以下示例显示了如何使用 value 属性来记录布局移动得分。

js
const observer = new PerformanceObserver((list) => {
  for (const entry of list.getEntries()) {
    // Count layout shifts without recent user input only
    if (!entry.hadRecentInput) {
      console.log("Entry's layout shift score:", entry.value);
    }
  }
});

observer.observe({ type: "layout-shift", buffered: true });

规范

规范
布局不稳定 API
# dom-layoutshift-value

浏览器兼容性