Draw
Draw
Nom fonctionnel: Dessin
À quoi sert ce widget ?
Permet de créer, éditer et supprimer des dessins cartographiques pour annoter une analyse ou préparer une intervention.
Conseil: un viewer “trop outillé” devient vite bruyant. Activez ce widget uniquement s’il sert un parcours utilisateur clair.
Quand l’activer
- Quand l’utilisateur doit mesurer, identifier ou qualifier des objets.
- Quand un diagnostic rapide est attendu sans outil SIG desktop.
- Quand les résultats doivent être visibles immédiatement.
En clair
- Côté utilisateur: Vous augmentez fortement l’autonomie métier dans l’application.
- Côté intégration: Vérifiez la qualité des géométries et la disponibilité des couches interrogées.
Prise en main
Accéder au widget
- Cliquez sur le bouton “Dessiner” dans la barre latérale.
- La fenêtre “Dessiner” apparaît et une couche “Votre dessin” est créée dans le TOC.
Le configurer sans se tromper
- Renommez la couche de dessin directement dans la table des contenus.
- Vérifiez la mention d’édition en cours pour confirmer que la couche est modifiable.
Ce que l’utilisateur voit
- Point: localiser un emplacement avec symbole personnalisable.
- Ligne: représenter un itinéraire ou un segment mesurable.
- Polygone: délimiter une zone, un périmètre ou une emprise.
- Texte: poser des annotations directement sur la carte.
- Formulaire de style: couleur, taille, opacité, labels et attributs.
Parcours utilisateur (le plus courant)
- Choisissez un type de dessin dans le panneau supérieur.
- Personnalisez son apparence dans le formulaire associé.
- Dessinez sur la carte: clic simple pour un point, sommets + double-clic pour terminer une ligne/polygone.
- Passez en mode sélection pour éditer géométrie et attributs.
- Utilisez l’action de suppression pour retirer un objet; la couche disparaît si elle devient vide.
Exemples concrets
- Tracer une zone d’analyse et afficher sa superficie.
- Dessiner un itinéraire et afficher sa distance en kilomètres.
- Annoter des emplacements clés avec des points et icônes personnalisées.
Configuration (aperçu)
| Option | Type | Défaut | Description |
|---|---|---|---|
widgetId | string | - | Identifiant unique de l’instance Draw. |
active | boolean | false | Active l’ouverture du widget au démarrage. |
inToolbar | boolean ou objet ou string | selon widget | Définit si le widget est visible dans une toolbar, et sous quelle forme. |
container | string ou objet | selon widget | Choisit le conteneur de rendu (drawer, dialog, floating, toolbar-tabs, hidden). |
Pour le détail complet (et toujours à jour), utilisez la référence technique et le schéma ci-dessous.
Liens techniques et code
- Référence technique du widget: Référence technique du widget
- Schéma principal:
schemas/drawFullConfigSchema - API technique du widget:
types/DrawFullConfig - Code source (déclaration):
packages/common/src/lib/widgets/draw/draw.declaration.ts - Code source (config):
packages/common/src/lib/widgets/draw/draw.config.ts
Exemple minimal (copier-coller)
{ "widgetId": "draw", "widgetClass": "Draw", "active": false, "inToolbar": true, "config": {}}Exemple avancé
{ "widgetId": "draw-advanced", "widgetClass": "Draw", "active": true, "handleOpenAtStartup": false, "inToolbar": { "type": "button", "toolbarId": "default-toolbar", "order": 10 }, "onActivate": { "deactivate": { "classes": [] } }, "config": {}}Points d’attention
- Le résultat dépend des couches visibles au moment de l’action.
- Des services lents dégradent la réactivité du widget.
- Les unités et la projection influencent les valeurs affichées.
Dépannage
| Symptôme | Vérification rapide |
|---|---|
| Le widget semble actif mais ne renvoie rien. | Vérifiez la visibilité des couches cibles et les droits d’accès. |
| Les mesures paraissent incohérentes. | Vérifiez projection, unité, précision et source altimétrique. |
FAQ
Peut-on garder plusieurs outils d’analyse ouverts ?
Possible, mais mieux vaut piloter les conflits avec onActivate.deactivate.classes.
Les résultats sont-ils exportables ?
Selon le widget: export natif, partage ou reprise dans un autre flux.
Captures à ajouter
- (Capture à ajouter)
/assets/screenshots/TODO/draw-01.png: widget ouvert avec configuration standard. - (Capture à ajouter)
/assets/screenshots/TODO/draw-02.png: interaction principale et résultat attendu.
Liens PDF source
Outil de dessin_01af63e5bd3c4f66a00bb606f1ca3bf6-120226-0848-32.pdfUS010 - Outil de dessin_bbb726ed41bb4098b6d28b1f844ec793-120226-0857-106.pdf