Element: Methode moveBefore()

Syntax

moveBefore(movedNode, referenceNode)

Parameter

movedNode

Ein Node, der den zu verschiebenden Knoten darstellt. Beachten Sie, dass dies ein Element- oder CharacterData-Knoten sein muss.

referenceNode

Ein Node, vor den movedNode verschoben wird, oder null. Wenn der Wert null ist, wird movedNode am Ende der Kindknoten des aufrufenden Knotens eingefügt.

Rückgabewert

Keiner (undefined).

Ausnahmen

HierarchyRequestError DOMException

Wird in einer der folgenden Situationen ausgelöst:

• Der angegebene movedNode ist nicht Teil des DOM und Sie versuchen, ihn in einen Knoten zu verschieben, der Teil des DOM ist, oder umgekehrt.
• Der angegebene movedNode ist ein Vorgänger des Element, auf dem moveBefore() aufgerufen wird.
• Sie versuchen, movedNode zwischen zwei verschiedenen Dokumenten zu verschieben.
• Der angegebene movedNode ist kein Element- oder CharacterData-Knoten.

NotFoundError DOMException

Der angegebene referenceNode ist kein Kindknoten des Knotens, auf dem Sie moveBefore() aufrufen, also des Knotens, in den Sie movedNode zu verschieben versuchen.

TypeError

Das zweite Argument wurde nicht angegeben.

Beschreibung

Die Methode moveBefore() verschiebt einen angegebenen Knoten an eine neue Position im DOM. Sie bietet eine ähnliche Funktionalität wie die Methode Node.insertBefore(), entfernt den Knoten jedoch nicht und fügt ihn anschließend wieder ein. Das bedeutet, dass der Zustand des Knotens (der beim Verschieben mit insertBefore() und ähnlichen Mechanismen zurückgesetzt würde) nach dem Verschieben erhalten bleibt. Dazu gehören:

• Der Zustand von Animationen und Transitions.
• Der Ladezustand von <iframe>.
• Interaktivitätszustände (zum Beispiel :focus und :active).
• Der Zustand eines Vollbild-Elements.
• Der Offen-/Geschlossen-Zustand von Popovers.
• Der modale Zustand von <dialog>-Elementen (modale Dialoge werden nicht geschlossen).

Der Wiedergabezustand von <video>- und <audio>-Elementen ist nicht in der obigen Liste enthalten, da diese Elemente ihren Zustand beim Entfernen und erneuten Einfügen unabhängig vom verwendeten Mechanismus beibehalten.

Wenn Sie Änderungen am DOM mithilfe eines MutationObserver beobachten, werden mit moveBefore() verschobene Knoten mit einem entfernten Knoten und einem hinzugefügten Knoten erfasst.

Einschränkungen von moveBefore()

Bei der Verwendung von moveBefore() sind einige Einschränkungen zu beachten:

• Es funktioniert nur beim Verschieben eines Knotens innerhalb desselben Dokuments.
• Es funktioniert nicht, wenn Sie versuchen, einen Knoten, der nicht mit dem DOM verbunden ist, in ein bereits verbundenes Elternelement zu verschieben, oder umgekehrt.

In solchen Fällen schlägt moveBefore() mit einer HierarchyRequestError-Ausnahme fehl. Wenn die oben genannten Einschränkungen Anforderungen für Ihren speziellen Anwendungsfall sind, sollten Sie stattdessen Node.insertBefore() verwenden oder try...catch einsetzen, um die Fehler zu behandeln, die in solchen Fällen auftreten.

Verschieben benutzerdefinierter Elemente unter Beibehaltung des Zustands

Jedes Mal, wenn die Position eines benutzerdefinierten Elements im DOM über Element.moveBefore() oder ähnliche Methoden wie Node.insertBefore() aktualisiert wird, werden seine Lebenszyklus-Callbacks disconnectedCallback() und connectedCallback() ausgelöst. Da diese Callbacks typischerweise verwendet werden, um erforderlichen Initialisierungs- oder Bereinigungscode auszuführen, der am Anfang oder Ende des Lebenszyklus des Elements ausgeführt werden soll, kann ihre Ausführung beim Verschieben des Elements (statt beim Entfernen oder Einfügen) Probleme mit seinem Zustand verursachen.

Sie können den Callback connectedMoveCallback() verwenden, um den Zustand eines benutzerdefinierten Elements beizubehalten. Wenn Sie moveBefore() verwenden, um ein benutzerdefiniertes Element zu verschieben, wird connectedMoveCallback() anstelle von connectedCallback() und disconnectedCallback() ausgeführt.

Weitere Informationen finden Sie unter Verschieben benutzerdefinierter Elemente.

Beispiele

Grundlegende Verwendung von moveBefore()

In dieser Demo veranschaulichen wir die grundlegende Verwendung von moveBefore().

HTML

Das HTML enthält ein <article>-Element mit einem <div>-Element und zwei <section>-Elementen. Das <div> enthält ein <button>, das wir später verwenden, um es zu verschieben.

<article id="wrapper">
  <div id="mover">
    <button>Move me!</button>
  </div>
  <section id="section1">
    <h2>Section 1</h2>
  </section>
  <section id="section2">
    <h2>Section 2</h2>
  </section>
</article>

CSS

Wir stellen einige einfache Stilregeln für das Erscheinungsbild und die Abstände der Kästen bereit und verwenden Flexbox, um deren Inhalt zu zentrieren.

#section1,
#section2,
#mover {
  width: 200px;
  height: 80px;
  border: 5px solid rgb(0 0 0 / 0.25);
  margin-bottom: 10px;
  display: flex;
  align-items: center;
  justify-content: center;
}

#section1,
#section2 {
  background-color: hotpink;
}

#mover {
  background-color: orange;
}

JavaScript

In unserem Skript fügen wir dem <button> über addEventListener() einen click-Event-Listener hinzu. Wenn auf die Schaltfläche geklickt wird, überprüfen wir, ob der nextElementSibling unseres mover-<div> das erste <section>-Element ist. Falls ja, rufen wir moveBefore() auf dem wrapper-<article> auf und geben an, dass das <div> vor das zweite <section> verschoben werden soll. Andernfalls verwenden wir moveBefore(), um das <div> vor das erste <section> zu verschieben.

const wrapper = document.getElementById("wrapper");
const section1 = document.getElementById("section1");
const section2 = document.getElementById("section2");
const mover = document.getElementById("mover");
const moveBtn = document.querySelector("button");

moveBtn.addEventListener("click", () => {
  if (mover.nextElementSibling === section1) {
    wrapper.moveBefore(mover, section2);
  } else {
    wrapper.moveBefore(mover, section1);
  }
});

Ergebnis

Das gerenderte Beispiel sieht folgendermaßen aus:

Klicken Sie einige Male auf den <button> und beachten Sie, wie er zwischen den beiden Positionen wechselt.

Demonstration der Zustandserhaltung

In dieser Demo stellen wir mehrere Mechanismen bereit, um ein <div>-Element mit einer eingebetteten YouTube-Anwendung zwischen zwei verschiedenen Containern zu verschieben. Dabei wird gezeigt, wie moveBefore() den Wiedergabezustand der Einbettung beibehält, die anderen Mechanismen jedoch nicht.

HTML

Das HTML enthält ein <article>-Element mit zwei <section>-Elementen. Das erste <section>-Element enthält ein <div>-Element, das den YouTube-Einbettungscode enthält. Außerdem haben wir ein <div>-Element mit drei