Übersicht
https://github.com/brianmcleer/mapswitcher-widget
Das Map-Switcher-Widget bietet eine Dropdown-Oberfläche, über die zwischen verschiedenen Experience-Builder-Anwendungen gewechselt werden kann. Dabei bleiben der aktuelle Kartenausschnitt und Zoomfaktor erhalten. Das Widget erfasst den URL-Hash der Quellanwendung und hängt ihn an die Ziel-URL an.
Hinweis: Eine frühere Version dieses Widgets enthielt fest im Code hinterlegte URLs. Dadurch konnte es nicht in der Esri Community geteilt werden. Mit Experience Builder 1.19 wurden inkompatible Änderungen eingeführt, die eine Neuentwicklung des Widgets erforderlich machten. In dieser Version können Administratoren URLs über das Widget-Einstellungsfeld konfigurieren, sodass es sich für eine breitere Verteilung eignet.
Konfigurationseinstellungen
Das Widget-Einstellungsfeld enthält die Standortkonfiguration:
Standortkonfiguration:
- Bezeichnung: Der Anzeigename, der im Dropdown-Menü erscheint
- URL: Die vollständige URL zur Zielanwendung in Experience Builder
Über die Schaltfläche „Standort hinzufügen“ können mehrere Standorte hinzugefügt werden. Einträge lassen sich über die Schaltfläche „Entfernen“ neben dem jeweiligen Eintrag löschen. Das Widget benötigt keine Verbindung zu einem Karten-Widget.
Funktionsweise des Widgets
Das Widget zeigt ein Dropdown-Menü mit den konfigurierten Standorten an. Der Platzhaltertext lautet „Karte zur Ansicht auswählen“.
Funktionsweise:
Wenn ein Benutzer im Dropdown-Menü ein Ziel auswählt:
- erfasst das Widget den aktuellen URL-Hash (alles nach dem Symbol #)
- Dieser Hash enthält Parameter zum Kartenstatus: Mittelpunktkoordinaten, Zoomstufe, Maßstab, Drehung und Raumbezug
- hängt das Widget diesen Hash an die ausgewählte Ziel-URL an
- wechselt der Browser zur neuen Anwendung
Funktionen:
- Funktioniert mit jedem Koordinatensystem (Web Mercator, State Plane, WGS84 usw.)
- Behält Mittelpunkt, Zoomstufe und Drehung bei
- URLs können im Einstellungsfeld konfiguriert werden
Änderungsprotokoll:
12.10.2026: Das Widget übernimmt jetzt die App-Sprache (?locale=, die Sprachauswahl, das ArcGIS-Profil oder den Browser) und unterstützt 39 Sprachen; eine Anleitung ist ebenfalls enthalten.
Haben Sie eigene benutzerdefinierte Widgets? Dasselbe kostenlose Tool, exb-i18n-kit, kann sie mit einem einzigen Befehl übersetzen: localize. So ermittelt es die Übersetzung für jede Phrase:
- Zuerst Esri. Das Tool liest die Übersetzungen aus, die bereits in Ihrer Experience-Builder-Installation vorhanden sind. Eine Phrase wie „Zoom to“ wird also so übersetzt, wie es auch die Esri-eigenen Widgets tun.
- Standardbegriffe. Einheiten wie Fuß und Acres stammen aus Unicode CLDR, derselben Datenquelle, die auch Browser verwenden.
- Gemeinsamer Übersetzungsspeicher. Alles Übrige stammt aus einem gemeinsamen Wörterbuch, das mit LibreTranslate, einem Open-Source-Übersetzungsprogramm, sowie den Opus-MT-Modellen von Helsinki-NLP für Bosnisch, Kroatisch und Serbisch erstellt wurde. Das Tool läuft kostenlos auf GitHub. Sie benötigen also weder einen API-Schlüssel noch ein Konto.
- Integration. Das Tool findet auch englische Texte, die außerhalb der Übersetzungsdatei des Widgets fest im Code hinterlegt sind, etwa eine Standardeinstellung oder eine Anleitung, und bindet sie ein, damit auch sie übersetzt werden.
Manuell erstellte Korrekturen haben immer Vorrang vor maschinellen Übersetzungen und werden nie überschrieben. Einige Übersetzungen wurden maschinell erstellt. Falls Ihnen eine unpassende auffällt, antworten Sie hier mit einem besseren Formulierungsvorschlag.
02.10.2026: Bei Verwendung des benutzerdefinierten Widgets „Basemap Gallery“ merkt sich Map Switcher die Grundkarte, wenn Sie zu einer anderen EB-Anwendung wechseln.
23.07.2026: Das Map-Switcher-Widget wurde für Experience Builder 1.21 aktualisiert, um TypeScript-Editorfehler zu beheben, darunter Probleme mit der Typisierung von React-Komponenten und unveränderlichen Konfigurationsimporten. Außerdem wurde die Widget-Version erhöht. Die neueste Version ist jetzt auf GitHub verfügbar.
04.06.2026: package.json und package-lock.json wurden zum Widget hinzugefügt. Dieses Widget hat keine Abhängigkeiten von Drittanbietern, es muss also nichts Zusätzliches installiert werden. Die Einrichtung besteht lediglich aus dem standardmäßigen npm install in Ihrem Client-Ordner, das Sie ohnehin bereits ausführen. Vielen Dank an @SunshineLuke90 für den Vorschlag und die Erläuterung des Verpackungsansatzes.
