Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.node Schreibgeschützt

Gibt das Element zurück, dessen Position sich verschoben hat (null, wenn es entfernt wurde).

LayoutShiftAttribution.previousRect Schreibgeschützt

Gibt ein DOMRectReadOnly-Objekt zurück, das die Position des Elements vor der Verschiebung darstellt.

LayoutShiftAttribution.currentRect Schreibgeschü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 von JSON.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.

js
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

Browser-Kompatibilität

Siehe auch