Iframes, vídeo y canvas: qué no se puede importar a Figma y por qué

Un iframe contiene otro documento, un canvas son píxeles dibujados por script y los fotogramas de un vídeo no son marcado. Por qué se resisten y qué hacer.

REFERENCEDESIGNERPublicado

Por qué estos tres elementos se resisten a la importación

Un iframe, un canvas y un vídeo muestran en pantalla algo que el marcado de diseño de la página no describe. Un iframe contiene un segundo documento. Un canvas contiene píxeles que dibujó un script. Un vídeo contiene fotogramas que un reproductor decodifica mientras se reproduce. Una herramienta que convierte marcado y estilos en capas de Figma no tiene aquí nada con lo que trabajar. Espera un hueco, una imagen plana o un fotograma de póster en lugar del contenido vivo.

Este artículo explica el motivo de cada caso con lo que documentan MDN y Figma. La página pública de UnHTML no indica cómo trata los elementos iframe, vídeo o canvas, así que aquí no se afirma nada al respecto. Tu informe de importación es el registro de lo que ocurrió con tu página.

Iframes: un segundo documento dentro del primero

Un iframe no es una caja de diseño. Según MDN, el elemento <iframe> incrusta otro documento, y cada documento incrustado es un contexto de navegación anidado con su propio document. La página que guardaste contiene una etiqueta <iframe> y una URL src. El contenido que hay detrás de esa URL es otra página.

El contenido de otro origen queda fuera de alcance

Los scripts no pueden acceder a la mayoría de las propiedades de una ventana de otro origen, incluido un marco que intenta llegar a su padre. Ambos lados se comunican mediante Window.postMessage() y nada más. Qué orígenes pueden incrustar una página lo controla la directiva frame-ancestors de una Content Security Policy, de modo que algunas páginas se niegan a mostrarse dentro de un marco.

Para una importación esto significa que la página anfitriona y el marco son capturas distintas. Guardar la página anfitriona no guarda lo que muestra el marco.

El único caso en que el marcado sí está en la página

El atributo srcdoc lleva HTML en línea que prevalece sobre src. Es la excepción: el contenido incrustado está dentro del atributo, así que al menos está presente en el archivo. La mayoría de las incrustaciones que encontrarás (mapas, reproductores de vídeo, formularios de pago, huecos publicitarios) usan src, y su contenido vive en otro sitio.

Según MDN, cada iframe también cuesta al navegador memoria y recursos adicionales, así que una página con varios es pesada y no una sola capa limpia.

Canvas: píxeles sin estructura

El elemento canvas es un mapa de bits sobre el que dibuja un script, con la API 2D de canvas o con WebGL. MDN es directo sobre la consecuencia: el elemento «es solo un mapa de bits y no ofrece información sobre los objetos dibujados», y el contenido dibujado no forma parte del DOM.

Ahí está todo el problema. Un botón hecho con <div> y CSS tiene una caja, un relleno, un radio y un texto que puedes asignar a propiedades de Figma. Un botón dibujado en un canvas no tiene nada de eso. Solo hay píxeles, y nada en el marcado dice dónde termina una forma.

Figma dice lo mismo de su propia captura. Su guía para convertir pantallas de código en capas de diseño editables advierte de que los «sitios complejos con desplazamiento o renderizados en canvas pueden capturarse de forma imperfecta», y de que las páginas con mucha animación JavaScript, renderizado <canvas> o listas virtualizadas pueden no traducirse limpiamente.

Los scripts añaden un segundo motivo. La página pública de UnHTML indica que los scripts, los controladores de eventos en línea y las URL javascript: se eliminan antes de renderizar, y que una página construida con JavaScript solo se vuelve a renderizar con scripts activos si activas la descarga remota, dentro de un marco aislado. Un canvas cuya imagen solo existe porque un script se ejecutó tiene poco que mostrar en un archivo guardado donde ese script nunca se ejecutó.

Vídeo: marcado que puedes leer, fotogramas que no

El vídeo es el más amable de los tres. El elemento video puede llevar un atributo poster, una imagen que se muestra mientras el vídeo se descarga, y uno o varios elementos <source> que apuntan a archivos. Ambos son marcado simple. Los fotogramas en reproducción no lo son: llegan de un archivo o de un flujo y un reproductor los decodifica.

Figma tiene una forma equivalente por su lado. Según la ayuda de Figma sobre añadir imágenes y vídeos a los diseños, no existe un tipo de capa específico para imágenes y vídeos. Se tratan como rellenos. Así, una imagen de póster estática encaja de forma natural en Figma como relleno de imagen, mientras que un vídeo en movimiento no se convierte en capas editables.

Si tu página es larga y tiene muchos medios, lee también sobre los límites de capas y las imágenes diferidas, ya que los medios de carga diferida pueden no estar presentes cuando se ejecuta la captura.

Qué hacer en su lugar

Cuatro medidas prácticas ayudan, y ninguna necesita una función especial.

  1. Importa la página incrustada por separado. Si el iframe muestra una página que controlas o que puedes usar, captúrala aparte y colócala en tu archivo de Figma junto a la página anfitriona.
  2. Exporta tú mismo un fotograma. Para un canvas o un vídeo, haz una captura de pantalla o exporta un fotograma del original y colócalo como relleno de imagen. Será una imagen, no formas editables, y ese es el resultado honesto.
  3. Usa el póster. Para un vídeo con atributo poster, la imagen del póster es el sustituto más limpio para el diseño.
  4. Captura una sección. Figma sugiere probar la captura de elemento sobre la sección concreta, en lugar de la página entera, cuando una captura sale mal.

Las páginas con medios recortados o enmascarados tienen sus propios límites, tratados en compatibilidad y alternativas para máscaras y clip-path.

Referencia rápida

ElementoQué contiene el marcadoPor qué se resiste a la importaciónSustituto que funciona
<iframe>Una URL src (o HTML en srcdoc)El contenido es un documento aparte con su propio contexto de navegaciónCapturar la página incrustada por separado
<canvas>Una superficie de mapa de bits, sin objetos dibujadosEl script dibuja los píxeles y el DOM no guarda registro de las formasUna imagen exportada usada como relleno
<video>poster, URL de <source>, texto alternativoLos fotogramas vienen de un reproductor y Figma guarda el vídeo como rellenoLa imagen del póster o un fotograma exportado

Lee la tabla por filas. En cada caso la caja de diseño existe, con un ancho y un alto que puedes ver, pero lo que hay dentro de la caja no vive en el marcado. Por eso el hueco que ves es un hueco de contenido y no un fallo de estilo, y por eso retocar el CSS antes de capturar rara vez ayuda.

Dimensionar el marcador de posición

Aunque el contenido no pueda pasar, la caja sí. Anota el ancho y el alto renderizados de cada iframe, canvas o vídeo en el navegador y da a tu imagen sustituta el mismo tamaño, para que el diseño de alrededor se siga leyendo bien. Así el espaciado, la alineación y el resto del diseño se mantienen fieles mientras decides cómo representar la pieza que falta.

Revisa el informe de importación

No des nada por supuesto. La página pública de UnHTML describe un informe de importación con cada fuente sustituida, cada marco revertido a posición absoluta y cada imagen omitida, y un presupuesto de nodos que protege frente a volcados descontrolados. Abre el informe después de cada importación, localiza la sección donde estaba el iframe, el canvas o el vídeo y mira qué muestra el archivo ahí. Esa es la prueba sobre tu página, algo que ningún artículo general puede darte.

Resumen

Los iframes, el canvas y el vídeo se resisten a la importación por una razón sencilla: lo que ves no está en el marcado de diseño de la página. Un iframe es otro documento, un canvas son píxeles dibujados por script sin DOM, y los fotogramas de un vídeo vienen de un reproductor. Sustituye cada uno por algo que Figma modele bien: una captura aparte, una imagen exportada o un póster, y deja que el informe de importación confirme lo ocurrido.

Preguntas frecuentes

¿Se importa un iframe a Figma?

Un iframe contiene un documento aparte, así que su contenido no forma parte de la página que capturaste. Trátalo como un hueco en el diseño e importa la página incrustada por separado si la necesitas. La página pública de UnHTML no indica cómo trata los iframes, así que consulta tu informe de importación.

¿Por qué mi canvas aparece vacío o plano tras la importación?

Un canvas es un mapa de bits dibujado por script, sin DOM para lo dibujado. Una captura estática no tiene formas que convertir en capas. El propio Figma advierte de que las páginas renderizadas en canvas pueden capturarse de forma imperfecta.

¿Qué pasa con un vídeo?

El marcado lleva una imagen de póster y URL de origen, pero los fotogramas en reproducción no son marcado estático. Figma modela el vídeo como un relleno, así que usa el póster o un fotograma que exportes.