Přehled
https://github.com/brianmcleer/mapswitcher-widget
Widget pro přepínání map nabízí rozbalovací nabídku, která umožňuje přecházet mezi různými aplikacemi Experience Builder a přitom zachovat aktuální rozsah mapy a úroveň přiblížení. Widget zachytí fragment hash v URL zdrojové aplikace a připojí ho k URL cílové aplikace.
Poznámka: Starší verze tohoto widgetu obsahovala natvrdo zadané adresy URL, takže ji nebylo možné sdílet v komunitě Esri. Verze Experience Builder 1.19 přinesla zásadní změny, kvůli kterým bylo nutné widget přepracovat. Tato verze umožňuje správcům konfigurovat adresy URL v panelu nastavení widgetu, takže se hodí k širšímu šíření.
Nastavení konfigurace
Panel nastavení widgetu obsahuje konfiguraci webů:
Konfigurace webů:
- Popisek: Zobrazovaný název, který se objeví v rozbalovací nabídce
- URL: Úplná adresa URL cílové aplikace Experience Builder
Pomocí tlačítka „Přidat web“ lze přidat více webů. Jednotlivé weby lze odebrat tlačítkem „Odebrat“. Widget nevyžaduje připojení k widgetu mapy.
Funkce widgetu
Widget zobrazuje rozbalovací nabídku s nakonfigurovanými weby. Zástupný text zní „Vyberte mapu k zobrazení“.
Funkce:
Když uživatel vybere cíl v rozbalovací nabídce:
- Widget zachytí aktuální fragment hash URL (vše za symbolem #)
- Tento hash obsahuje parametry stavu mapy: souřadnice středu, úroveň přiblížení, měřítko, rotaci a prostorovou referenci
- Widget připojí tento hash k URL vybraného cíle
- Prohlížeč přejde do nové aplikace
Funkce:
- Funguje s libovolným souřadnicovým systémem (Web Mercator, State Plane, WGS84 atd.)
- Zachovává středový bod, úroveň přiblížení a rotaci
- Adresy URL se konfigurují v panelu nastavení
Protokol změn:
12. 10. 2026: Widget nyní přebírá jazyk aplikace (?locale=, přepínače jazyků, profilu ArcGIS nebo prohlížeče) ve 39 jazycích; součástí je i průvodce nápovědou.
Máte vlastní widgety? Stejný bezplatný nástroj, exb-i18n-kit, je dokáže přeložit jediným příkazem: localize. Tady je přehled toho, jak překládá jednotlivé fráze:
- Nejdřív Esri. Načítá překlady, které už jsou součástí vaší instalace Experience Builder, takže fráze jako „Přiblížit na“ používají stejné znění jako widgety od Esri.
- Standardní termíny. Názvy jednotek, jako jsou stopy a akry, pocházejí z Unicode CLDR, tedy ze stejných dat, která používají prohlížeče.
- Sdílená překladová paměť. Zbývající text se překládá pomocí sdíleného slovníku vytvořeného s LibreTranslate, překladačem s otevřeným zdrojovým kódem, a modelů Opus-MT od Helsinki-NLP pro bosenštinu, chorvatštinu a srbštinu. Nástroj běží zdarma na GitHubu, takže nepotřebujete klíč API ani účet.
- Propojení. Vyhledá také anglický text pevně zadaný mimo soubor překladů widgetu, například výchozí nastavení nebo průvodce nápovědou, a propojí ho s překlady.
Ruční úpravy mají vždy přednost před strojovým překladem a nikdy se nepřepisují. Některé překlady vytvořil stroj, takže pokud narazíte na nepřesné znění, napište sem lepší návrh.
2. 10. 2026: Při použití widgetu Basemap Gallery Custom widget si Map Switcher při přepnutí do jiné aplikace EB zapamatuje podkladovou mapu.
23. 7. 2026: Widget Map Switcher byl aktualizován pro Experience Builder 1.21, aby se odstranily chyby v editoru TypeScriptu, včetně typování komponent React a importů neměnné konfigurace. Byla také zvýšena verze widgetu a nejnovější vydání je nyní dostupné na GitHubu.
4. 6. 2026: Do widgetu byly přidány soubory package.json a package-lock.json. Widget nemá žádné závislosti třetích stran, takže není třeba nic dalšího instalovat. Nastavení spočívá ve standardním spuštění příkazu npm install ve složce client, které už provádíte. Díky uživateli @SunshineLuke90 za návrh a za vysvětlení postupu při přípravě balíčku.
