surya-webframe
v1.0.7
Published
Librería para montar iframes agregando la query string de la URL actual
Maintainers
Readme
SuryaWebFrame
SuryaWebFrame es una librería que permite montar un iframe dentro de un elemento HTML, incorporando los parámetros de la query string de la URL actual en la URL de destino del iframe. De esta manera, puedes conservar los parámetros originales en la nueva URL que se genere para el iframe.
Características
- Inyección de parámetros: Toma automáticamente los parámetros de la URL (por ejemplo,
?utm_source=google) y los añade a la URL del iframe. - Enlace dinámico: Genera la URL objetivo incluyendo
dealerCodeyuserCode. - Fácil de usar: Solo necesitas instanciar la clase y llamar a un método para montar el iframe.
Uso con UNPKG
Para usar la librería desde UNPKG, incluye la siguiente etiqueta <script> en tu documento HTML, apuntando a la versión adecuada de tu paquete:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>Ejemplo de SuryaWebFrame</title>
<style>
body {
margin: 0 0;
}
iframe {
display: block;
width: 100vw;
height: 100vh;
border: none;
}
</style>
</head>
<body>
<!-- Elemento contenedor donde se inyectará el iframe -->
<div id="iframe-container"></div>
<!-- Incluir el script desde UNPKG -->
<script src="https://unpkg.com/surya-webframe@latest/dist/surya-webframe.umd.js"></script>
<script>
// Desestructurar las APIs desde el bundle UMD
const { SuryaWebFrame, setupSuryaWebFrameListener } = window.SuryaWebFrameBundle;
// Listener para capturar envíos de GTM
setupSuryaWebFrameListener();
// Ejemplo de uso
const dealerCode = "XXXXX";
const userCode = "YYYYY";
// Crea una instancia de la clase
const webframe = new SuryaWebFrame(dealerCode, userCode);
// Monta el iframe en el elemento con ID "iframe-container"
webframe.mountIframe("iframe-container");
</script>
</body>
</html>