Widgets toevoegen aan een webpagina

Twee opties

Een widget integreren op uw gastwebsite is mogelijk via:

• embedcode

• Javascript

U integreert de widget altijd zelf. De widgets zijn volledig responsief en passen zich dus aan de schermgrootte van de gebruiker aan.

Scope

Alle Javascript-afhankelijkheden van een widget worden altijd gedownload en geladen in een geïsoleerde scope. Zo ontstaan er geen versieconflicten tussen de webpagina en de widget.

Open

Een widget toevoegen aan een webpagina via embedcode

De embedcode van een widget is een script-tag om toe te voegen binnen het body-element van een webpagina. Een embedcode maakt gebruik van synchrone operaties om een placeholder te voorzien in de webpagina. Hierdoor is het niet mogelijk om embedcodes asynchroon te gebruiken.

Om een global header te gebruiken met eenvoudig toegangsbeheer, volstaat het de embedcode toe te voegen aan de webpagina. De widget neemt de authenticatieflow voor zijn rekening.

Een widget toevoegen aan een webpagina via Javascript (als alternatief voor de embedcode)

De Javascript-code wordt voorzien waarbij via de bootstrap-functie een widget-URL wordt omgezet naar een widget-instantie. Deze bootstrap-functie zal asynchroon een instantie van een widget aanmaken en een referentie teruggeven. Zodra de referentie is teruggegeven, kan het koppelen aan een DOM-element plaatsvinden.

In het onderstaande codevoorbeeld staat hoe een widget-instantie te koppelen aan een DOM-element en vervolgens het mount-gedrag te triggeren.