Feedjoltdocs
DesenvolupadorsWidget

Visió general del widget

Com funciona el widget de Feedjolt: una etiqueta script async munta un botó i carrega un iframe aïllat en fer clic. Instal·lació, què es carrega i aïllament.

El widget és una sola etiqueta <script> a la teva pàgina que descarrega una petita configuració del teu espai, munta un botó de llançament i carrega un iframe en lazy quan l'usuari fa clic. Fins al clic, zero cost d'iframe.

Instal·lació

<script async src="https://www.feedjolt.com/widget-loader.js"
        data-workspace="EL_TEU_SLUG_D_ESPAI"></script>

Això és el mínim. Recarrega la pàgina; veuràs un botó flotant.

Què es carrega

  • widget-loader.js - ~5 KB. Llegeix els teus atributs data-*, descarrega /api/widget/embed/{workspace}/config, munta un botó.
  • L'iframe - només es carrega quan l'usuari fa clic al botó. Allotjat a https://www.feedjolt.com/{locale}/portal/{workspace}?mode=widget&.... Fins al clic, sense càrrega d'iframe.
  • postMessage entre marcs - fet servir per l'iframe per demanar al pare que tanqui o redimensioni. Sense trackers de tercers.

Com s'aïlla de la teva pàgina

El widget corre en un <iframe>, així que el seu CSS, fonts i JS estan aïllats dels teus. Els teus estils no poden trencar el widget; el widget no pot arribar al teu DOM.

Això també vol dir que la personalització profunda d'estil és limitada. El color i la posició del botó vénen dels teus ajustos per espai; el contingut de l'iframe es tematitza amb la mateixa paleta.

Cap a on

  • Configuració - els cinc atributs data-* i els ajustos del panell per espai.
  • Personalització - el que pots ajustar avui.
  • CSP - les directives de Content Security Policy que necessita el widget.

On this page