<map-layer>
Les cartes sont composées d’une ou de plusieurs couches. Ces couches sont appliquées par l’élément personnalisé <map-layer>.
Tout le contenu <mapml-viewer> est compris dans un ou plusieurs éléments <map-layer>, en ligne ou extraits à distance, qui représentent le contenu de la couche.
<map-layer label="Ma couche" checked>
...le contenu de la couche s’affiche ici...
</map-layer>
<map-layer> n’est pas un élément ‘void’ – il doit être fermé par une balise </map-layer>.
Le contenu de la carte peut être en ligne, comme il est illustré ci-dessous – entre les balises de début <map-layer> et de fin </map-layer> – ou extrait, à partir de l’URL de l’attribut source <map-layer src="..."></map-layer> :
<map-layer label="Ma couche" src="https://example.org/mapml/mylayer" checked></map-layer>
Le présent document utilise principalement la convention du contenu en ligne. Le contenu extrait d’une carte suit une sémantique similaire, à la différence qu’il est analysé par l’analyseur XML du navigateur et qu’il doit donc suivre les conventions applicables aux documents MapML ainsi que les règles de syntaxe XML.
Attributs
src
Contient le chemin d’accès vers un document MapML.
checked
L’attribut <map-layer checked> et la valeur « property » sont boolean. Si elle est présente, la valeur « property » vérifiée est considérée comme ‘true’; si elle n’est pas présente, la valeur « property » est 'false'. Notez que c’est la présence de l’attribut qui fait que la valeur est « true », et non la valeur de l’attribut. Par exemple, l’attribut checked="false" s’avère en fait être « checked », comme il est décrit dans MDN Web Docs.
hidden
L’attribut <map-layer hidden> et la valeur « property » sont boolean. Si elle est présente, la couche est masquée dans le contrôle des couches.
label
Le contenu en ligne utilise l’attribut label comme étiquette de texte affichée de la couche dans le contrôle des couches. Dans le contenu extrait, l’attribut label est ignoré, et l’élément extrait <map-title> est utilisé.
opacity
L'attribut opacity définit l'opacité initiale de l'élément <map-layer>. Les valeurs d'opacity valides vont de "0.0" à "1.0" et sont reflétées dans le contrôle de couche
sous "Opacité" pour chaque couche. Lorsque l'attribut opacity n'est pas présent, l'opacité est fixée à "1.0" par défaut.
Exemples
Opacité de couche
L'exemple suivant définit l'opacity initiale d'un élément <map-layer>, à 0,5 sur 1,0.
<mapml-viewer projection="CBMTILE" zoom="2" lat="45" lon="-90" controls>
<map-layer opacity="0.5" label="CBMT" src="https://geogratis.gc.ca/mapml/en/cbmtile/cbmt/" checked></map-layer>
</mapml-viewer>
Spécifications
| Spécification |
|---|
| Élément MapML « layer » |
Exigences
Signaler les problèmes liés à ces exigences sur GitHub
exigence amélioration peu pratique indécis en cours de discussion
| Spéc. | Visualiseur | API | |
|---|---|---|---|
| Rendu des couches de base (5.1) | |||
Afficher un fichier image en tant que couche d’une carte (5.1.3) | en cours d’examen | limité | |
| Navigation des utilisateurs (vue panoramique et zoom) (5.4) | |||
Maintenir une échelle raisonnable pour les étiquettes et les lignes lors d’un zoom (5.4.5) | limité | complet |