Widget Couches de carte personnalisées
Une version modifiée du widget Couches de carte d’Experience Builder. Il offre toutes les fonctionnalités du widget standard, auxquelles s’ajoutent celles présentées ci-dessous. Ce widget a été transféré depuis une question sur les widgets personnalisés, où se trouvait la version originale.
GitHub : https://github.com/brianmcleer/map-layers-custom-widget
Fonctionnalités ajoutées au widget Couches de carte standard
- Inclusion automatique des nouvelles sous-couches : les sous-couches nouvellement ajoutées à un groupe désigné apparaissent dans les applications déployées sans modifier les paramètres ni redéployer l’application.
- Mise en évidence d’une couche : isoler une couche ou une sous-couche de service cartographique et masquer les autres, avec une option explicite pour quitter ce mode.
- Badge indiquant le nombre de couches visibles.
- Liste des couches réductible, avec possibilité de la réduire au démarrage.
- Ajouter des données : ajouter une couche par URL (service ArcGIS, tuiles vectorielles, WMS, WMTS, GeoJSON, CSV, KML) ou à partir d’un fichier local (GeoJSON, CSV, KML, shapefile compressé).
- Opacité générale : un seul curseur règle l’opacité de toutes les couches.
- Sélecteur de fond de carte utilisant les fonds de carte de l’organisation.
- Panneau de légende.
- Vues enregistrées : enregistrer des ensembles de visibilité des couches et les exporter ou les importer au format JSON.
- Nombre de résultats correspondant à la recherche, y compris les sous-couches des services cartographiques, avec un filtre pour n’afficher que les couches visibles.
- Outils par lot : tout activer ou désactiver, réinitialiser la visibilité, zoomer sur les couches visibles, exporter une image de la carte, tout développer ou réduire.
- Outils par couche : clignotement, copie de l’URL, actualisation, détails de la couche, déplacement en haut ou en bas, retrait du groupe.
Chaque fonctionnalité peut être activée ou désactivée dans les paramètres du widget.
Prérequis
Experience Builder Developer Edition 1.19 ou 1.20 (React 19). EB 1.18 et les versions antérieures ne sont pas prises en charge.
Installation
- Téléchargez le fichier zip de la version et décompressez-le.
- Placez le dossier map-layers-custom de façon à ce que son fichier manifest.json se trouve directement dans client/your-extensions/widgets/map-layers-custom/.
- Exécutez npm install dans le dossier client.
- Redémarrez le client et actualisez complètement le générateur.
Les instructions d’installation complètes et les conseils de dépannage se trouvent dans le fichier README sur GitHub.
Historique des modifications :
12/10/2026 : Le widget suit désormais la langue de l’application (?locale=, le sélecteur de langue, le profil ArcGIS ou le navigateur) dans 39 langues, guide d’aide compris.
Vous avez vos propres widgets personnalisés ? Le même outil gratuit, exb-i18n-kit, peut les traduire en une seule commande : localize. Voici comment il traduit chaque expression :
- Esri d’abord. Il récupère les traductions déjà présentes dans votre installation d’Experience Builder : ainsi, une expression comme « Zoom to » reprend la formulation utilisée par les widgets d’Esri.
- Termes standard. Les noms d’unités, comme pieds et acres, proviennent d’Unicode CLDR, les mêmes données qu’utilisent les navigateurs.
- Mémoire de traduction partagée. Le reste provient d’un dictionnaire partagé créé avec LibreTranslate, un traducteur libre, ainsi que les modèles Opus-MT de Helsinki-NLP pour le bosniaque, le croate et le serbe. L’outil s’exécute gratuitement sur GitHub : vous n’avez donc besoin ni d’une clé API ni d’un compte.
- Intégration. Il repère également les textes anglais codés en dur en dehors du fichier de traduction du widget, comme un paramètre par défaut ou un guide d’aide, et les relie au système de traduction pour qu’ils soient eux aussi traduits.
Les corrections faites à la main sont toujours prioritaires sur la traduction automatique et ne sont jamais écrasées. Certaines traductions étant générées automatiquement, n’hésitez pas à proposer ici une meilleure formulation si vous en repérez une qui ne convient pas.
30/09/26 :
- Choisir une seule couche par groupe : configurer un groupe pour qu’une seule couche puisse être activée à la fois (boutons radio).
- Copier un lien vers ces couches : partager un lien qui ouvre l’application avec les mêmes couches activées.
- Exporter la liste des couches : enregistrer toutes les couches, tous les groupes et toutes les sous-couches, avec leur état activé/désactivé et leur URL, dans un fichier CSV.
- Vérification de l’état des couches : les services sont vérifiés à intervalles réguliers et ceux qui ne répondent plus sont signalés dans la liste.
- Signalement des couches défectueuses : les couches qui ne se chargent pas ou ne s’affichent pas sont signalées, même lorsqu’elles sont profondément imbriquées dans des groupes.
- Vues prédéfinies : le créateur de l’application peut enregistrer des vues de couches visibles par tous les utilisateurs.
- Imagerie à proximité : ajouter des images aériennes et satellitaires couvrant la vue actuelle.
- Favoris : ajouter des couches aux favoris et filtrer la liste pour n’afficher que celles-ci.
- Noms de couches épurés : option pour améliorer la lisibilité des noms, par exemple en remplaçant les traits de soulignement par des espaces.
- Zoomer jusqu’à ce que la couche soit visible : un clic zoome sur une couche grisée à l’échelle actuelle.
- Télémétrie d’utilisation : les clics sur les couches incluent désormais le chemin du groupe auquel appartient la couche.
11/09/26 :
Ajout d’un bouton Aide dans l’en-tête, qui ouvre un guide succinct consultable décrivant uniquement les fonctionnalités activées dans votre application, ainsi qu’une indication « Nouveau ici ? » affichée une seule fois.
23/07/26 : Mise à jour du widget Couches de carte personnalisées pour assurer sa compatibilité avec Experience Builder 1.21 et corriger les erreurs de l’éditeur TypeScript. Il s’agit uniquement d’une mise à jour de maintenance, sans changement des fonctionnalités du widget.
