Iframes, vidéo et canvas : ce qui ne s'importe pas dans Figma et pourquoi
Un iframe contient un autre document, un canvas est fait de pixels dessinés par script et les images d'une vidéo ne sont pas du balisage. Pourquoi, et que faire.
Pourquoi ces trois éléments résistent à l'import
Un iframe, un canvas et une vidéo affichent chacun à l'écran quelque chose que le balisage de mise en page de la page ne décrit pas. Un iframe contient un second document. Un canvas contient des pixels qu'un script a dessinés. Une vidéo contient des images qu'un lecteur décode pendant la lecture. Un outil qui transforme balisage et styles en calques Figma n'a ici rien à exploiter. Attendez-vous à un vide, à une image à plat ou à une image d'affiche à la place du contenu vivant.
Cet article explique la raison pour chacun, à partir de ce que documentent MDN et Figma. La page publique d'UnHTML n'indique pas comment sont traités les éléments iframe, vidéo ou canvas, donc ce texte n'affirme rien à ce sujet. Votre rapport d'import est la trace de ce qui est arrivé à votre page.
Iframes : un second document dans le premier
Un iframe n'est pas une boîte de mise en page. Selon MDN, l'élément <iframe> intègre un autre document, et chaque document intégré est un contexte de navigation imbriqué avec son propre document. La page que vous avez enregistrée contient une balise <iframe> et une URL src. Le contenu derrière cette URL est une autre page.
Le contenu d'une autre origine reste hors d'atteinte
Les scripts ne peuvent pas accéder à la plupart des propriétés d'une fenêtre d'une autre origine, y compris un cadre qui tente d'atteindre son parent. Les deux côtés communiquent par Window.postMessage() et rien d'autre. Les origines autorisées à intégrer une page sont contrôlées par la directive frame-ancestors d'une Content Security Policy, si bien que certaines pages refusent d'être placées dans un cadre.
Pour un import, cela signifie que la page hôte et le cadre sont des captures distinctes. Enregistrer la page hôte n'enregistre pas ce qu'affiche le cadre.
Le seul cas où le balisage est dans la page
L'attribut srcdoc porte du HTML en ligne qui l'emporte sur src. C'est l'exception : le contenu intégré se trouve dans l'attribut, donc il est au moins présent dans le fichier. La plupart des intégrations que vous croiserez (cartes, lecteurs vidéo, formulaires de paiement, emplacements publicitaires) utilisent src, et leur contenu est ailleurs.
Selon MDN, chaque iframe coûte aussi au navigateur de la mémoire et des ressources supplémentaires, donc une page qui en compte plusieurs est lourde et non un seul calque propre.
Canvas : des pixels sans structure
L'élément canvas est une image bitmap sur laquelle un script dessine, avec l'API canvas 2D ou WebGL. MDN est direct sur la conséquence : l'élément « n'est qu'une image bitmap et ne fournit aucune information sur les objets dessinés », et le contenu dessiné ne fait pas partie du DOM.
Voilà tout le problème. Un bouton fait de <div> et de CSS a une boîte, un fond, un rayon et un texte que vous pouvez faire correspondre à des propriétés Figma. Un bouton dessiné sur un canvas n'a rien de tout cela. Il n'y a que des pixels, et rien dans le balisage n'indique où une forme se termine.
Figma dit la même chose de sa propre capture. Son guide pour transformer des écrans codés en calques de design modifiables avertit que « les sites complexes à défilement ou rendus en canvas peuvent être capturés de façon imparfaite », et que les pages avec beaucoup d'animation JavaScript, de rendu <canvas> ou de listes virtualisées peuvent ne pas se traduire proprement.
Les scripts ajoutent une seconde raison. La page publique d'UnHTML indique que les scripts, les gestionnaires d'événements en ligne et les URL javascript: sont supprimés avant le rendu, et qu'une page construite par JavaScript n'est rendue à nouveau avec les scripts actifs que si vous activez la récupération à distance, dans un cadre isolé. Un canvas dont l'image n'existe que parce qu'un script s'est exécuté a peu à montrer dans un fichier enregistré où ce script n'a jamais tourné.
Vidéo : du balisage lisible, des images qui ne le sont pas
La vidéo est la plus accommodante des trois. L'élément video peut porter un attribut poster, une image affichée pendant le téléchargement de la vidéo, et un ou plusieurs éléments <source> qui pointent vers des fichiers. Les deux sont du balisage simple. Les images en lecture ne le sont pas : elles arrivent d'un fichier ou d'un flux et un lecteur les décode.
Figma a une forme équivalente de son côté. Selon l'aide de Figma sur l'ajout d'images et de vidéos aux designs, il n'existe pas de type de calque propre aux images et aux vidéos. Elles sont traitées comme des fonds. Une image d'affiche statique s'insère donc naturellement dans Figma comme fond d'image, alors qu'une vidéo animée ne devient pas des calques modifiables.
Si votre page est longue et riche en médias, lisez aussi les plafonds de calques et les images à chargement différé, car les médias à chargement différé peuvent être absents au moment de la capture.
Que faire à la place
Quatre gestes pratiques aident, et aucun ne demande de fonction spéciale.
- Importez la page intégrée séparément. Si l'iframe affiche une page que vous contrôlez ou que vous pouvez utiliser, capturez-la à part et placez-la dans votre fichier Figma à côté de la page hôte.
- Exportez vous-même une image. Pour un canvas ou une vidéo, faites une capture d'écran ou exportez une image de la source, puis insérez-la comme fond d'image. Ce sera une image, pas des formes modifiables, et c'est le résultat honnête.
- Utilisez l'affiche. Pour une vidéo avec un attribut
poster, l'image d'affiche est le substitut le plus propre pour la mise en page. - Capturez une section. Figma suggère d'essayer la capture d'élément sur la section concernée plutôt que sur la page entière quand une capture paraît fausse.
Les pages avec des médias découpés ou masqués ont leurs propres limites, traitées dans prise en charge et solutions de repli pour les masques et clip-path.
Référence rapide
| Élément | Ce que contient le balisage | Pourquoi il résiste à l'import | Substitut qui fonctionne |
|---|---|---|---|
<iframe> | Une URL src (ou du HTML srcdoc) | Le contenu est un document séparé avec son propre contexte de navigation | Capturer la page intégrée séparément |
<canvas> | Une surface bitmap, aucun objet dessiné | Un script dessine les pixels et le DOM ne garde aucune trace des formes | Une image exportée utilisée comme fond |
<video> | poster, URL de <source>, texte de repli | Les images viennent d'un lecteur et Figma stocke la vidéo comme un fond | L'image d'affiche ou une image exportée |
Lisez le tableau ligne par ligne. Dans chaque cas, la boîte de mise en page existe, avec une largeur et une hauteur visibles, mais ce qu'il y a dans la boîte ne vit pas dans le balisage. C'est pourquoi le vide que vous voyez est un vide de contenu et non un défaut de style, et pourquoi bricoler le CSS avant la capture aide rarement.
Dimensionner l'espace réservé
Même quand le contenu ne peut pas passer, la boîte le peut. Notez la largeur et la hauteur rendues de chaque iframe, canvas ou vidéo dans le navigateur, puis donnez à votre image de remplacement la même taille pour que la mise en page autour reste lisible. Les espacements, l'alignement et le reste de la mise en page restent ainsi fidèles pendant que vous décidez comment représenter l'élément manquant.
Vérifier le rapport d'import
Ne supposez rien. La page publique d'UnHTML décrit un rapport d'import de chaque police substituée, de chaque cadre ramené en position absolue et de chaque image ignorée, ainsi qu'un budget de nœuds qui protège contre les exports incontrôlés. Ouvrez le rapport après chaque import, repérez la section où se trouvaient l'iframe, le canvas ou la vidéo, et regardez ce que le fichier montre à cet endroit. C'est la preuve pour votre page, qu'aucun article général ne peut fournir.
Résumé
Iframes, canvas et vidéo résistent à l'import pour une raison simple : ce que vous voyez n'est pas dans le balisage de mise en page de la page. Un iframe est un autre document, un canvas est fait de pixels dessinés par script sans DOM, et les images d'une vidéo viennent d'un lecteur. Remplacez chacun par quelque chose que Figma modélise bien : une capture séparée, une image exportée ou une affiche, et laissez le rapport d'import confirmer ce qui s'est passé.
Questions fréquentes
Un iframe s'importe-t-il dans Figma ?
Un iframe contient un document séparé, donc son contenu ne fait pas partie de la page que vous avez capturée. Traitez-le comme un trou dans la mise en page et importez la page intégrée séparément si vous en avez besoin. La page publique d'UnHTML n'indique pas le traitement des iframes, lisez donc votre rapport d'import.
Pourquoi mon canvas est-il vide ou à plat après l'import ?
Un canvas est une image bitmap dessinée par script, sans DOM pour ce qui a été dessiné. Une capture statique n'a aucune forme à transformer en calques. Figma avertit lui-même que les pages rendues en canvas peuvent être capturées de façon imparfaite.
Que devient une vidéo ?
Le balisage porte une image d'affiche et des URL source, mais les images en lecture ne sont pas du balisage statique. Figma modélise la vidéo comme un fond, utilisez donc l'affiche ou une image que vous exportez.