JavaScript Methoden
Für die Interaktion mit anderen Funktionalitäten der Website werden verschiedene Methoden zur Verfügung gestellt.
Dies bietet die Möglichkeit das Popup oder Funktionalitäten des Popups ohne Interaktion vom User zu steuern, oder Statusabfragen zu Einwilligungen abzufragen.
Grundsätzlich bieten alle Layouts die selben Methoden. Das bedeutet, egal ob der TCF Modus aktiviert ist oder nicht, stehen die selbe Basisfunktionalität zur Verfügung.
Methoden
Nach Initialisierung des Scripts durch den Browser sind folgende Methoden via window Objekt verfügbar. Bei einigen Layouts gibt es auch die Möglichkeit, die Methoden via window.legalweb.popup Objekt aufzurufen (ohne „lw“ Prefix).
Einzelne Integrationen aktivieren, deaktivieren, Status abfragen
- lwEnableIntegration(integrationId: string):void
- lwDisableIntegration(integrationId: string):void
- lwIsIntegrationEnabled(integrationId: string):bool
Als „integrationId“ wird der Wert des „data-slug“ Attributs des Switches im Popup erwartet.
Kategorien aktivieren, deaktivieren, Status abfragen
- lwIsIntegrationCategoryEnabled(integrationId):bool
- lwConsentIabIntegrations(categoryId: string, consentStatus: boolean):void
- lwConsentIabIntegrations(consentStatus: boolean):void
Popup Methoden
Folgende Methoden simulieren „Klicks“ auf die Buttons.
- lwConsentAcceptSelected():void
- lwConsentDenyAll():void
- lwConsentIabIntegrations():void
Methoden zum Anzeigen und Schließen des Popups. Wichtig: es werden keine weitere Methoden ausgeführt, die eine Einwilligung oder Ablehnen ausführen.
- lwShowPopup(options : {tab: string} = null):void
- lwHidePopup():void
- lwShowNotice():void
- lwHideNotice():void
Embeddings dynamisch einfügen
Um dynamisch einen Placeholder für ein Embedding zu erzeugen, kann die nachfolgende Methode verwendet werden. Als “nodeToAdd” wird eine gültige DOM Node erwartet, an die der Placeholder angehängt (via append) wird. “integrationSlug” ist die Id des Dienstes (zB. embeddings_youtube, embeddings_googlemaps). “callbackMethod” ist jene Methode, die ausgeführt wird sobald der Inhalt vom Besucher aktiviert (durch Consent) wird. Falls es bereits eine Zustimmung gibt, wird gleich “callbackMethod” augeführt.
Andwendungszweck: zB: Anzeigen eines Previewbildes von Videos anstatt des Placeholders.
- lwAddPlaceholderWithCallbackToNode(nodeToAdd, integrationSlug, callbackMethod):void
Manuelle Initialisierung des legal web JavaScripts
Falls Popup und/oder Notice nicht via DOMContentLoaded Event geladen werden, steht eine Methode zum benutzerdefinierten Initialisieren zur Verfügung. Diese Methode initialisiert das “komplette” Frontend, zeigt aber noch nichts an. Zusätzlich muss das Popup auch manuell via der im vorigen Punkt genannten Methoden angezeigt/aufgerufen werden.
„language“ ist das zweistellige Kürzel der Sprache (de, en, it, …)
- lwCdnInit(language: string):void
Temporäres Deaktivieren der Legalweb Funktionen für einen Request
Wird bei einer URL der Parameter lwDisableLegalweb angehängt, wird keine Popup, keine Notice angezeigt, keine Integrationen geladen, keine Inhalte blockiert.
