Widget 2.0
    • PPL Access Point Widget — Implementační příručka pro e-shopy
    • 1. Quick Start — integrace za 5 minut
    • 2. Vložení widgetu do stránky
    • 3. Statická HTML integrace
    • 4. Integrace: Vanilla JavaScript
    • 5. Integrace: PHP
    • 6. Integrace: React
    • 7. Kompletní API reference
    • 8. Pokročilé scénáře
    • 9. Přehled komunikačních kanálů
    Přepní do angličtiny

    4. Integrace: Vanilla JavaScript

    Pro e-shopy s vlastním JavaScriptem — dynamická konfigurace, zachytávání událostí, imperativní ovládání.

    4.1 Získání reference na widget#

    Widget lze získat několika způsoby:

    4.2 Zachytávání událostí#

    Widget emituje čtyři typy událostí. Všechny mají prefix ppl-accesspointwidget- a prochází přes Shadow DOM (díky composed: true).

    4.3 Modal checkout flow — typický scénář e-shopu#

    Kompletní příklad integrace do pokladny e-shopu:

    4.4 Dynamické vytvoření widgetu přes JavaScript#

    Widget lze vytvořit kompletně z JavaScriptu bez předchozího HTML zápisu. To je užitečné, když chcete widget načíst až po výběru typu doručení zákazníkem.

    Varianta A — konfigurace přes HTML atribut (JSON string)#

    Varianta B — konfigurace přes JavaScript property (objekt)#

    Poznámka: Při dynamickém vytvoření je doporučeno přidat event listenery před vložením elementu do DOM (pomocí appendChild), aby nedošlo ke ztrátě událostí.

    4.5 Dynamická konfigurace za běhu#

    Metoda configure() umožňuje změnit konfiguraci za běhu. Provádí partial merge — změní pouze zadané parametry a ostatní zachová.

    4.6 Získání vybraného výdejního místa#

    Kromě zachytávání události select lze poslední výběr získat i imperativně:

    4.7 Reset widgetu#

    Resetuje widget do výchozího stavu — odstraní výběr a resetuje filtry:

    4.8 Přepínání mezi inline a modal režimem#

    Modified at 2026-04-22 11:33:12
    Previous
    3. Statická HTML integrace
    Next
    5. Integrace: PHP
    Built with