LayoutShiftAttribution
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die Schnittstelle LayoutShiftAttribution liefert Debugging-Informationen über Elemente, deren Position sich verschoben hat.
Instanzen von LayoutShiftAttribution werden beim Aufruf von LayoutShift.sources in einem Array zurückgegeben.
Instanzeigenschaften
LayoutShiftAttribution.nodeSchreibgeschützt-
Gibt das Element zurück, dessen Position sich verschoben hat (
null, wenn es entfernt wurde). LayoutShiftAttribution.previousRectSchreibgeschützt-
Gibt ein
DOMRectReadOnly-Objekt zurück, das die Position des Elements vor der Verschiebung darstellt. LayoutShiftAttribution.currentRectSchreibgeschützt-
Gibt ein
DOMRectReadOnly-Objekt zurück, das die Position des Elements nach der Verschiebung darstellt.
Instanzmethoden
LayoutShiftAttribution.toJSON()-
Gibt ein einfaches, JSON-serialisierbares Objekt zurück, das das
LayoutShiftAttribution-Objekt darstellt. Die Methode wird vonJSON.stringify()automatisch aufgerufen.
Beispiele
Das folgende Beispiel beobachtet Layoutverschiebungen und ermittelt das Element mit den größten Auswirkungen. Das Array sources ist nach der Größe des betroffenen Bereichs absteigend sortiert. Das erste Element (sources[0]) steht daher für das Element, das am stärksten zur Layoutverschiebung beigetragen hat. Weitere Einzelheiten dazu finden Sie unter Web Vitals im Einsatz debuggen.
const observer = new PerformanceObserver((list) => {
for (const entry of list.getEntries()) {
if (!entry.sources || entry.sources.length === 0) continue;
const mostImpactfulSource = entry.sources[0];
console.log("Layout shift score:", entry.value);
console.log("Most impactful element:", mostImpactfulSource.node);
console.log("Previous position:", mostImpactfulSource.previousRect);
console.log("Current position:", mostImpactfulSource.currentRect);
}
});
observer.observe({ type: "layout-shift", buffered: true });
Spezifikationen
| Spezifikation |
|---|
| Layout Instability API> # sec-layout-shift-attribution> |