Integración mediante iFrame
Los iFrames son la tecnología fundamental detrás de la integración de temporizadores de gettickr.app en sitios web. Entender cómo trabajar con iFrames te da la flexibilidad para integrar temporizadores en cualquier plataforma web o página con código personalizado.
¿Qué es un iFrame?
Un iFrame (marco en línea) es un elemento HTML que integra otra página HTML dentro de tu página actual. Cuando usas un iFrame para integrar un temporizador, estás creando una ventana en tu página web que muestra tu temporizador desde gettickr.app.
| Aspecto | Descripción |
|---|---|
| Tecnología | Elemento HTML estándar (<iframe>) |
| Soporte de navegadores | Todos los navegadores modernos (Chrome, Firefox, Safari, Edge) |
| Compatibilidad | Funciona en todas las plataformas web |
| Complejidad | Simple - solo pega código HTML |
| Flexibilidad | Control total sobre tamaño, posición y estilo |
Estructura básica del código iFrame
El código iFrame básico para integrar un temporizador sigue una estructura HTML simple:
Atributos del iFrame explicados
| Atributo | Propósito | Valor de ejemplo | Requerido |
|---|---|---|---|
src | URL del temporizador a mostrar | https://gettickr.app/r/#abc123 | ✅ Sí |
width | Ancho del iFrame | 800 (píxeles) o 100% (responsive) | ✅ Sí |
height | Alto del iFrame | 400 (píxeles) | ✅ Sí |
frameborder | Borde alrededor del iFrame | 0 (sin borde) | ⬜ Opcional |
allowfullscreen | Habilitar pantalla completa | No necesita valor | ⬜ Opcional |
loading | Cuándo cargar el iFrame | lazy (cargar cuando es visible) | ⬜ Opcional |
title | Descripción de accesibilidad | "Temporizador de cuenta atrás" | ⬜ Recomendado |
Crear tu código iFrame
Sigue estos pasos para crear código iFrame para tu temporizador:
Paso 1: Obtén la URL de tu temporizador
- Crea y personaliza tu temporizador en el Editor
- En la sección Renderer, encuentra la URL de visualización de tu temporizador
- Copia la URL completa (se ve como
https://gettickr.app/r/#TU-ID-DE-TEMPORIZADOR)
Paso 2: Elige tus dimensiones
Decide el ancho y alto basándote en el diseño de tu temporizador y dónde aparecerá:
| Ubicación del temporizador | Ancho recomendado | Alto recomendado | Relación de aspecto |
|---|---|---|---|
| Ancho completo | 100% | 400-600px | ~16:9 o 16:6 |
| Sección hero | 1200px o 100% | 600px | 2:1 |
| Barra lateral | 300-400px | 200-300px | ~4:3 |
| Ancho de contenido | 800px | 400px | 2:1 |
| Widget pequeño | 400px | 200px | 2:1 |
Paso 3: Construye tu código
Reemplaza TU-ID-DE-TEMPORIZADOR con el ID real de tu temporizador de la URL:
Paso 4: Añade a tu sitio web
Copia el código iFrame completo y pégalo en tu sitio web:
- Editor HTML/Código: Pega directamente en tu HTML
- Constructor de sitios web: Usa bloque "HTML personalizado" o "Código de integración"
- CMS: Añade a bloque HTML, widget HTML personalizado o editor de texto (modo HTML)
Consideraciones de seguridad
Los navegadores modernos implementan características de seguridad para iFrames para proteger a los usuarios:
| Característica de seguridad | Qué hace | Compatibilidad con gettickr.app |
|---|---|---|
| Requisito HTTPS | Muchos sitios solo permiten iFrames HTTPS | ✅ gettickr.app usa HTTPS |
| X-Frame-Options | Controla quién puede integrar el contenido | ✅ Permite integración |
| Encabezados CSP | Restricciones de política de seguridad de contenido | ✅ En lista blanca |
| Atributo Sandbox | Restringe capacidades del iFrame | ⬜ No necesario para temporizadores |
Atributo sandbox opcional
Si tu política de seguridad del sitio web lo requiere, puedes añadir restricciones sandbox:
Optimización del rendimiento
Carga diferida (Lazy Loading)
Aplaza la carga de iFrames hasta que estén cerca del viewport:
Beneficios:
- Carga inicial de página más rápida
- Ancho de banda reducido para usuarios que no se desplazan hasta el temporizador
- Mejor rendimiento en dispositivos móviles
Mejores prácticas de rendimiento
| Práctica | Por qué | Cómo |
|---|---|---|
| Un temporizador por página | Minimizar uso de recursos | Usar uno, no múltiples |
| Tamaño apropiado | No cargar iFrames enormes innecesariamente | Ajustar a dimensiones de diseño |
| Carga diferida | Cargar solo cuando sea necesario | Añadir loading="lazy" |
| Evitar iFrames anidados | La complejidad perjudica el rendimiento | Solo un nivel |
Estilos responsive avanzados
Relación de aspecto responsive
Para mantener proporciones correctas en todos los tamaños de pantalla:
Cómo funciona:
- El contenedor exterior usa
padding-bottompara crear espacio proporcional padding-bottom: 50%crea una relación 2:1 (ancho:alto)- El iFrame se posiciona absolutamente para llenar el contenedor
- El resultado es un temporizador que escala perfectamente
Cálculo de padding-bottom
| Relación de aspecto deseada | Fórmula | Valor padding-bottom |
|---|---|---|
| 16:9 (pantalla ancha) | (9 ÷ 16) × 100 | 56.25% |
| 4:3 (tradicional) | (3 ÷ 4) × 100 | 75% |
| 2:1 (temporizador ancho) | (1 ÷ 2) × 100 | 50% |
| 1:1 (cuadrado) | (1 ÷ 1) × 100 | 100% |
| 3:1 (muy ancho) | (1 ÷ 3) × 100 | 33.33% |
Tamaños específicos por breakpoint
Usa media queries para diferentes dimensiones en móvil/tablet/escritorio:
Ejemplos de integración
Temporizador centrado simple
Temporizador con título y descripción
Temporizador en barra lateral
Temporizador de ancho completo con fondo
Solución de problemas
El temporizador no aparece
| Problema | Solución |
|---|---|
| Espacio en blanco donde debería estar el temporizador | Verificar que la URL del temporizador es correcta |
| No hay iFrame visible en absoluto | Verificar modo HTML (no editor visual) |
| Mensaje de error en el iFrame | El temporizador puede haber sido eliminado o la URL es incorrecta |
| Pantalla negra | Las dimensiones del iFrame pueden ser incorrectas |
Problemas de tamaño
| Problema | Solución |
|---|---|
| El temporizador aparece muy pequeño | Aumentar valores de ancho y alto |
| El temporizador aparece cortado | Verificar que las dimensiones del iFrame coincidan con el diseño del temporizador |
| El temporizador se sale del contenedor | Añadir max-width: 100% al iFrame |
| Barras de desplazamiento no deseadas | Establecer scrolling="no" o overflow: hidden |
| Relación de aspecto incorrecta en móvil | Implementar contenedor de relación de aspecto responsive |
Problemas específicos de plataforma
| Plataforma | Problema común | Solución |
|---|---|---|
| WordPress | El editor visual elimina código | Usar editor de código o bloque HTML |
| Wix | iFrame no permitido en texto | Usar elemento HTML iFrame del menú Añadir |
| Squarespace | Soporte limitado de iFrame | Usar bloque de código, no bloque de texto |
| Shopify | iFrame en plantillas liquid | Usar sintaxis Liquid adecuada para HTML |
| Webflow | Elemento embed necesario | Usar elemento Embed, no HTML Embed |
Errores de consola del navegador
Verifica la consola de desarrollador del navegador (F12) para mensajes de error:
Solución: Contacta con tu proveedor de hosting web. Tu sitio puede estar bloqueando iFrames.
Solución: Asegúrate de que la URL del temporizador usa https:// no
http://
Solución: Actualiza tu política de seguridad de contenido para permitir gettickr.app
Accesibilidad
Mejores prácticas de accesibilidad
| Práctica | Implementación | Beneficio |
|---|---|---|
| Atributo title | title="Temporizador de cuenta atrás" | Descripción del lector de pantalla |
| Texto descriptivo | Añadir encabezado antes del temporizador | Contexto para todos los usuarios |
| Alto contraste | Diseñar temporizador con colores accesibles | Legibilidad para baja visión |
| Tamaño de texto | Usar fuentes grandes en el diseño del temporizador | Fácil de leer |
| Texto alternativo | Proporcionar contexto textual alrededor | Usuarios sin JavaScript |
Ejemplo accesible completo
Próximos pasos
- Integración con WordPress - Guía específica de plataforma para WordPress
- Integración con Shopify - Configuración de temporizador para e-commerce
- Integración HTML personalizada - Técnicas de implementación avanzadas
- Personalizar diseño del temporizador - Haz que tu temporizador coincida con la estética de tu sitio web