Lorixen.
DE

Eingebettete Formulare: iframe-Höhe automatisch anpassen

Kurz gesagt: Buchungsformulare, Terminkalender, Bewertungs-Widgets oder Stellenbörsen werden oft als iframe in die eigene Website eingebettet. Das Problem: Ein iframe hat eine feste Höhe. Ist der Inhalt länger, erscheint ein zweiter Scrollbalken mitten auf der Seite, ist er kürzer, bleibt eine große Lücke. Wenn sich der Inhalt ändert, etwa nach dem Absenden eines Formulars, passt die Höhe gar nicht mehr. Der Browser kann die Höhe nicht automatisch anpassen, wenn der eingebettete Inhalt von einer anderen Domain stammt. Die übliche Lösung ist eine kleine Absprache zwischen den beiden Seiten per postMessage. Dieser Artikel zeigt, wie das funktioniert, was Sie bei der Sicherheit beachten müssen und welche Alternativen es gibt.

Warum die Höhe nicht von selbst passt

Ein iframe ist ein eigenes Fenster innerhalb Ihrer Seite. Stammt der Inhalt von derselben Domain, kann Ihr Skript hineinsehen und die Höhe des Inhalts auslesen. Stammt er von einer anderen Domain, verhindert der Browser diesen Zugriff aus Sicherheitsgründen. MDN beschreibt diese Grundregel: Skripte auf verschiedenen Seiten dürfen nur dann aufeinander zugreifen, wenn die Seiten denselben Ursprung haben, also dasselbe Protokoll, dieselbe Domain und denselben Port.

Für eingebettete Dienste ist genau das der Normalfall: Das Buchungssystem liegt bei einem Anbieter, Ihre Website bei Ihnen. Die Seite außen weiß deshalb nicht, wie hoch der Inhalt innen ist.

Die Lösung: Nachrichten zwischen den Fenstern

MDN beschreibt window.postMessage() als Methode, die eine sichere Kommunikation zwischen Fenstern verschiedenen Ursprungs ermöglicht, etwa zwischen einer Seite und einem darin eingebetteten iframe. Die Idee: Der eingebettete Inhalt misst seine eigene Höhe und schickt sie als Nachricht an die umgebende Seite. Diese setzt daraufhin die Höhe des iframes.

Im eingebetteten Inhalt misst ein kleines Skript die Höhe und meldet jede Änderung. Mit ResizeObserver lässt sich das elegant lösen. MDN beschreibt diese Schnittstelle als Weg, Änderungen an den Abmessungen eines Elements zu melden:

const ziel = "https://www.ihrebetrieb.de";
new ResizeObserver(() => {
  const hoehe = document.documentElement.scrollHeight;
  parent.postMessage({ typ: "hoehe", wert: hoehe }, ziel);
}).observe(document.body);

Auf Ihrer Seite nimmt ein Skript die Nachricht an und setzt die Höhe:

window.addEventListener("message", (e) => {
  if (e.origin !== "https://buchung.anbieter.example") return;
  if (!e.data || e.data.typ !== "hoehe") return;
  const h = Number(e.data.wert);
  if (Number.isFinite(h) && h > 0 && h < 10000) {
    document.querySelector("#buchung").style.height = h + "px";
  }
});

Sicherheit nicht vergessen

MDN gibt zu postMessage klare Sicherheitshinweise, die hier direkt zutreffen.

Absender prüfen. Wer Nachrichten von anderen Websites erwartet, sollte laut MDN immer die Identität des Absenders über die Eigenschaft origin prüfen. Jedes Fenster kann Nachrichten schicken, auch eine fremde Seite. Im Beispiel oben werden nur Nachrichten vom Buchungsanbieter angenommen.

Inhalt prüfen. Auch nach geprüfter Herkunft sollten Sie laut MDN den Aufbau der Nachricht prüfen. Sonst könnte eine Lücke beim vertrauten Absender zu einer Lücke auf Ihrer Seite werden. Im Beispiel wird deshalb nur eine Zahl in einem sinnvollen Bereich als Höhe übernommen, und es wird niemals Text aus der Nachricht als HTML eingefügt.

Ziel festlegen. Beim Senden sollten Sie laut MDN immer einen genauen Zielursprung angeben, nicht den Platzhalter *. Andernfalls könnte die Nachricht bei einer anderen Seite landen, falls das Fenster inzwischen eine andere Adresse anzeigt. Für eine reine Höhenangabe ist das Risiko gering, aber die Gewohnheit schützt, sobald Nachrichten mehr enthalten.

Keine Empfänger ohne Bedarf. MDN weist darauf hin, dass der sicherste Weg ist, gar keinen Empfänger für Nachrichten einzurichten, wenn man keine erwartet. Bauen Sie den Empfänger also nur auf Seiten ein, die wirklich ein solches iframe enthalten.

Wenn Sie den eingebetteten Inhalt nicht selbst kontrollieren

Bei Diensten von Drittanbietern können Sie das Skript im iframe nicht selbst einbauen. Viele Anbieter liefern deshalb ein eigenes Einbettungsskript mit, das genau diese Absprache übernimmt. Statt eines reinen iframe-Codes bieten sie einen Code mit einem zusätzlichen Skript an. Fragen Sie beim Anbieter nach, ob es eine solche Variante gibt und welche Nachrichten er schickt.

Gibt es keine, bleibt eine feste Höhe, die für den längsten typischen Zustand passt, oder ein Link, der den Dienst in einem eigenen Fenster öffnet. Auf Handys ist ein eigenes Fenster oft ohnehin angenehmer als ein schmales eingebettetes Formular.

Weitere Punkte für gute Einbettungen

  • Startwert setzen. Geben Sie dem iframe eine sinnvolle Anfangshöhe, damit die Seite beim Laden nicht stark springt, bevor die erste Nachricht ankommt.
  • Titel vergeben. Das Attribut title am iframe beschreibt für Screenreader, was eingebettet ist, etwa „Terminbuchung“.
  • Scrollen nach Absenden. Nach dem Absenden eines Formulars springt die Bestätigung oft an eine Stelle, die außerhalb des sichtbaren Bereichs liegt. Eine zusätzliche Nachricht kann die umgebende Seite bitten, zum iframe zu scrollen.
  • Breite fließend. Die Breite sollte sich mit width: 100% an den Platz anpassen, die Höhe kommt über die Nachricht.

Testen auf verschiedenen Geräten

Prüfen Sie die Einbettung nicht nur am großen Bildschirm. Auf Handys ändert sich die Höhe des Inhalts oft stärker, weil Texte umbrechen und Elemente untereinander statt nebeneinander stehen. Gehen Sie den ganzen Ablauf durch, vom ersten Schritt bis zur Bestätigung, und achten Sie darauf, ob sich die Höhe bei jedem Schritt anpasst. Drehen Sie das Gerät einmal ins Querformat und zurück. Öffnen Sie auch Fehlermeldungen, etwa durch ein leeres Pflichtfeld, denn sie verlängern das Formular oft unerwartet. Wenn Ihre Seite Cookie-Einwilligungen verwendet, prüfen Sie außerdem, ob das iframe erst nach der Zustimmung geladen wird und die Höhenanpassung dann trotzdem funktioniert.

Beispiel zur Veranschaulichung

Eine Freiburger Physiotherapiepraxis (Beispiel zur Veranschaulichung) bettet die Online-Terminbuchung eines Anbieters als iframe mit fester Höhe ein. Auf Handys erscheint ein zweiter Scrollbalken, und nach der Auswahl eines Termins ist der Bestätigungsknopf nur durch Scrollen im iframe erreichbar. Der Anbieter bietet ein Einbettungsskript an, das die Höhe per postMessage meldet. Die Praxis tauscht den Code aus, vergibt einen Titel und eine Anfangshöhe. Die Buchung passt sich nun bei jedem Schritt an, und der zweite Scrollbalken verschwindet.

Typische Fehler

  • Nachrichten ohne Prüfung des Absenders annehmen.
  • Werte aus der Nachricht ungeprüft als HTML einfügen.
  • Beim Senden den Platzhalter * als Ziel verwenden.
  • Keine Anfangshöhe setzen, sodass die Seite beim Laden springt.
  • Das iframe ohne beschreibenden Titel einbinden.

Häufige Fragen

Kann CSS die Höhe eines iframes automatisch an den Inhalt anpassen?

Für Inhalte von einer anderen Domain derzeit nicht verlässlich. Deshalb ist die Absprache per Nachricht der übliche Weg.

Ist postMessage sicher?

Ja, wenn Sie Absender und Inhalt prüfen und beim Senden ein genaues Ziel angeben, wie MDN es empfiehlt.

Was, wenn der Anbieter keine Lösung anbietet?

Dann bleibt eine feste Höhe für den längsten typischen Zustand oder ein Link, der den Dienst in einem eigenen Fenster öffnet.

Wenn eingebettete Formulare oder Widgets auf Ihrer Website mit Scrollbalken und Lücken kämpfen, binden wir sie gern sauber und sicher ein: Einbettung verbessern.

Quellen

WhatsAppTermin buchen