Iframes, Video und Canvas: Was sich nicht in Figma importieren lässt und warum

Ein Iframe enthält ein anderes Dokument, Canvas sind per Skript gezeichnete Pixel, Videobilder sind kein Markup. Warum das den Import bremst und was hilft.

REFERENCEDESIGNERVeröffentlicht

Warum sich diese drei Elemente dem Import entziehen

Ein Iframe, ein Canvas und ein Video zeigen jeweils etwas auf dem Bildschirm, das nicht im Layout-Markup der Seite beschrieben ist. Ein Iframe enthält ein zweites Dokument. Ein Canvas enthält Pixel, die ein Skript gezeichnet hat. Ein Video enthält Bilder, die ein Player während der Wiedergabe dekodiert. Ein Werkzeug, das Markup und Stile in Figma-Ebenen umwandelt, hat hier nichts, womit es arbeiten könnte. Rechne mit einer Lücke, einem flachen Bild oder einem Posterbild statt mit lebendigem Inhalt.

Dieser Artikel erklärt den Grund für jedes der drei Elemente anhand dessen, was MDN und Figma dokumentieren. Die öffentliche Seite von UnHTML nennt nicht, wie Iframe-, Video- oder Canvas-Elemente behandelt werden, deshalb macht dieser Text dazu keine Aussage. Dein Importbericht ist das Protokoll dessen, was mit deiner Seite passiert ist.

Iframes: ein zweites Dokument im ersten

Ein Iframe ist kein Layoutkasten. Laut MDN bettet das Element <iframe> ein anderes Dokument ein, und jedes eingebettete Dokument ist ein verschachtelter Browserkontext mit einem eigenen document. Die gespeicherte Seite enthält ein <iframe>-Tag und eine src-URL. Der Inhalt hinter dieser URL ist eine andere Seite.

Inhalte anderer Ursprünge sind unerreichbar

Skripte können auf die meisten Eigenschaften eines Fensters mit anderem Ursprung nicht zugreifen, auch nicht ein Frame auf sein übergeordnetes Fenster. Beide Seiten sprechen nur über Window.postMessage() miteinander. Welche Ursprünge eine Seite überhaupt einbetten dürfen, steuert die Direktive frame-ancestors einer Content Security Policy, weshalb sich manche Seiten nicht in einen Frame laden lassen.

Für einen Import heißt das: Die Hostseite und der Frame sind getrennte Aufnahmen. Wer die Hostseite speichert, speichert nicht, was der Frame anzeigt.

Der eine Fall, in dem das Markup in der Seite steckt

Das Attribut srcdoc trägt Inline-HTML, das src überschreibt. Das ist die Ausnahme: Der eingebettete Inhalt steht im Attribut und ist damit zumindest in der Datei vorhanden. Die meisten Einbettungen, denen du begegnest (Karten, Videoplayer, Zahlungsformulare, Werbeplätze), nutzen src, und ihr Inhalt liegt woanders.

Laut MDN kostet jeder Iframe den Browser außerdem zusätzlichen Speicher und zusätzliche Ressourcen, eine Seite mit mehreren ist also schwer und keine einzelne saubere Ebene.

Canvas: Pixel ohne Struktur

Das Canvas-Element ist eine Bitmap, auf die ein Skript zeichnet, mit der 2D-Canvas-API oder mit WebGL. MDN benennt die Folge direkt: Das Element „ist nur eine Bitmap und liefert keine Informationen über gezeichnete Objekte“, und gezeichneter Inhalt ist nicht Teil des DOM.

Das ist das ganze Problem. Ein Button aus <div> und CSS hat einen Kasten, eine Füllung, einen Radius und einen Text, den du auf Figma-Eigenschaften abbilden kannst. Ein auf ein Canvas gezeichneter Button hat nichts davon. Es gibt nur Pixel, und nichts im Markup sagt, wo eine Form endet.

Figma sagt das Gleiche über seine eigene Aufnahme. Der Leitfaden zum Umwandeln von Code-Bildschirmen in bearbeitbare Designebenen warnt, dass „komplexe, scrollgesteuerte oder per Canvas gerenderte Seiten unvollständig erfasst werden können“, und dass Seiten mit viel JavaScript-Animation, <canvas>-Rendering oder virtualisierten Listen eventuell nicht sauber übersetzt werden.

Skripte liefern einen zweiten Grund. Die öffentliche Seite von UnHTML nennt, dass Skripte, Inline-Ereignishandler und javascript:-URLs vor dem Rendern entfernt werden und dass eine per JavaScript aufgebaute Seite nur dann mit aktivierten Skripten neu gerendert wird, wenn du das Abrufen von Remote-Inhalten freigibst, und zwar in einem isolierten Frame. Ein Canvas, dessen Bild nur existiert, weil ein Skript lief, hat in einer gespeicherten Datei, in der dieses Skript nie lief, wenig zu zeigen.

Video: Markup, das du lesen kannst, Bilder, die du nicht lesen kannst

Das Video ist das freundlichste der drei Elemente. Das Video-Element kann ein Attribut poster tragen, ein Bild, das beim Laden des Videos erscheint, sowie ein oder mehrere <source>-Elemente, die auf Dateien zeigen. Beides ist einfaches Markup. Die laufenden Bilder sind es nicht: Sie kommen aus einer Datei oder einem Stream, und ein Player dekodiert sie.

Figma hat auf seiner Seite eine passende Form. Laut der Figma-Hilfe zum Hinzufügen von Bildern und Videos zu Designs gibt es keinen eigenen Ebenentyp für Bilder und Videos. Sie werden als Füllungen behandelt. Ein statisches Posterbild passt also natürlich als Bildfüllung in Figma, während ein bewegtes Video nicht zu bearbeitbaren Ebenen wird.

Wenn deine Seite lang und medienlastig ist, lies auch über Ebenenlimits und träge geladene Bilder, denn träge geladene Medien sind beim Aufnehmen unter Umständen noch nicht vorhanden.

Was du stattdessen tun kannst

Vier praktische Schritte helfen, und keiner braucht eine Sonderfunktion.

  1. Importiere die eingebettete Seite einzeln. Zeigt der Iframe eine Seite, die du kontrollierst oder nutzen darfst, nimm sie getrennt auf und lege sie in deiner Figma-Datei neben die Hostseite.
  2. Exportiere ein Bild selbst. Mach bei einem Canvas oder Video einen Screenshot oder exportiere ein Einzelbild aus der Quelle und setze es als Bildfüllung ein. Es wird ein Bild sein, keine bearbeitbaren Formen, und das ist das ehrliche Ergebnis.
  3. Nutze das Poster. Bei einem Video mit poster-Attribut ist das Posterbild der sauberste Platzhalter für das Layout.
  4. Nimm einen Abschnitt auf. Figma empfiehlt, die Elementaufnahme für den betreffenden Abschnitt statt für die ganze Seite zu probieren, wenn eine Aufnahme falsch aussieht.

Seiten mit beschnittenen oder maskierten Medien haben eigene Grenzen, beschrieben in Unterstützung und Fallbacks für Masken und clip-path.

Kurzreferenz

ElementWas das Markup enthältWarum es sich dem Import entziehtErsatz, der funktioniert
<iframe>Eine src-URL (oder srcdoc-HTML)Der Inhalt ist ein getrenntes Dokument mit eigenem BrowserkontextDie eingebettete Seite einzeln aufnehmen
<canvas>Eine Bitmap-Fläche, keine gezeichneten ObjekteEin Skript zeichnet die Pixel, und das DOM kennt die Formen nichtEin exportiertes Bild als Füllung
<video>poster, <source>-URLs, ErsatztextDie Bilder kommen aus einem Player, und Figma speichert Video als FüllungDas Posterbild oder ein exportiertes Einzelbild

Lies die Tabelle zeilenweise. In jedem Fall gibt es den Layoutkasten mit sichtbarer Breite und Höhe, aber was im Kasten steckt, liegt nicht im Markup. Deshalb ist die Lücke, die du siehst, eine Inhaltslücke und kein Stilfehler, und deshalb hilft das Herumschrauben am CSS vor der Aufnahme selten.

Den Platzhalter richtig dimensionieren

Auch wenn der Inhalt nicht mitkommt, kann der Kasten mitkommen. Notiere die gerenderte Breite und Höhe jedes Iframes, Canvas oder Videos im Browser und gib deinem Ersatzbild dieselbe Größe, damit das umgebende Layout weiter stimmig wirkt. So bleiben Abstände, Ausrichtung und der Rest des Layouts ehrlich, während du entscheidest, wie du das fehlende Stück darstellst.

Den Importbericht prüfen

Nimm nichts an. Die öffentliche Seite von UnHTML beschreibt einen Importbericht über jede ersetzte Schrift, jeden auf absolute Position zurückgesetzten Frame und jedes übersprungene Bild, dazu ein Knotenbudget, das vor ausufernden Dumps schützt. Öffne den Bericht nach jedem Import, suche die Stelle, an der Iframe, Canvas oder Video saß, und sieh nach, was die Datei dort zeigt. Das ist der Beleg für deine Seite, den kein allgemeiner Artikel liefern kann.

Zusammenfassung

Iframes, Canvas und Video entziehen sich dem Import aus einem einfachen Grund: Was du siehst, steht nicht im Layout-Markup der Seite. Ein Iframe ist ein anderes Dokument, ein Canvas besteht aus per Skript gezeichneten Pixeln ohne DOM, und die Bilder eines Videos kommen aus einem Player. Ersetze jedes durch etwas, das Figma gut abbildet: eine getrennte Aufnahme, ein exportiertes Bild oder ein Poster, und lass den Importbericht bestätigen, was passiert ist.

Häufige Fragen

Wird ein Iframe in Figma importiert?

Ein Iframe enthält ein getrenntes Dokument, sein Inhalt ist also nicht Teil der aufgenommenen Seite. Behandle ihn als Loch im Layout und importiere die eingebettete Seite einzeln, falls du sie brauchst. Die öffentliche Seite von UnHTML nennt die Behandlung von Iframes nicht, lies also deinen Importbericht.

Warum ist mein Canvas nach dem Import leer oder flach?

Ein Canvas ist eine per Skript gezeichnete Bitmap, ohne DOM für das Gezeichnete. Eine statische Aufnahme hat keine Formen, die sich in Ebenen umwandeln ließen. Figma selbst warnt, dass per Canvas gerenderte Seiten unvollständig erfasst werden können.

Was passiert mit einem Video?

Das Markup trägt ein Posterbild und Quell-URLs, aber laufende Bilder sind kein statisches Markup. Figma bildet Video als Füllung ab, nutze also das Poster oder ein von dir exportiertes Einzelbild.