Aperçu
https://github.com/brianmcleer/mapswitcher-widget
Le widget Map Switcher offre une interface déroulante pour naviguer entre différentes applications Experience Builder tout en conservant l'étendue et le niveau de zoom actuels de la carte. Le widget capture le fragment de hachage URL de l'application source et l'ajoute à l'URL de destination.
Remarque : Une version antérieure de ce widget contenait des URL codées en dur dans le code, ce qui empêchait son partage sur la communauté Esri. Experience Builder 1.19 a introduit des changements majeurs nécessitant une refonte du widget. Cette version permet aux administrateurs de configurer les URL via le panneau des paramètres du widget, ce qui le rend adapté à une distribution plus large.
Paramètres de Configuration
Le panneau des paramètres du widget contient la configuration des sites :
Configuration des Sites :
- Étiquette: Le nom affiché qui apparaît dans le menu déroulant
- URL: L'URL complète vers l'application Experience Builder cible
Plusieurs sites peuvent être ajoutés en utilisant le bouton « Ajouter un site ». Les sites peuvent être supprimés avec le bouton « Supprimer » pour chaque entrée. Le widget ne nécessite pas de connexion à un widget carte.
Fonctionnalité du Widget
Le widget affiche un menu déroulant avec les options de sites configurés. Le texte d'espace réservé indique « Sélectionnez la carte à afficher ».
Fonctionnalité :
Lorsqu'un utilisateur sélectionne une destination dans le menu déroulant :
- Le widget capture le fragment de hachage URL actuel (tout ce qui suit le symbole #)
- Ce hachage contient les paramètres d'état de la carte : coordonnées du centre, niveau de zoom, échelle, rotation et référence spatiale
- Le widget ajoute ce hachage à l'URL de destination sélectionnée
- Le navigateur navigue vers la nouvelle application
Caractéristiques :
- Fonctionne avec n'importe quel système de coordonnées (Web Mercator, State Plane, WGS84, etc.)
- Conserve le point central, le niveau de zoom et la rotation
- URLs configurées dans le panneau des paramètres
Journal des modifications :
23/07/2026 : Mise à jour du widget Map Switcher pour Experience Builder 1.21 afin de résoudre les erreurs dans l'éditeur TypeScript, y compris la typage des composants React et les importations immuables de configuration. La version du widget a également été augmentée et la dernière version est maintenant disponible sur GitHub.
04/06/2026 : Ajout des fichiers package.json et package-lock.json au widget. Ce widget n'a aucune dépendance tierce, donc rien d'autre à installer. L'installation se fait simplement via la commande npm install dans votre dossier client comme vous le faites déjà. Merci à @SunshineLuke90 pour la suggestion et pour avoir expliqué l'approche d'emballage.
