<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é.
media
L'attribut media est utilisé pour exprimer les conditions de média de carte sous lesquelles le contenu de la couche doit être utilisé (si un contenu en ligne est présent) ou chargé à partir de l'URL spécifiée dans l'attribut src, si cet attribut est présent. Les conditions de média de carte sont évaluées à true ou false.
Une couche pour laquelle la condition de média de carte est évaluée à false est, par défaut, masquée.
Une couche pour laquelle la condition de média de carte est évaluée à true est ajoutée à la carte selon son attribut checked et est ajoutée au contrôle des couches en fonction de son attribut hidden.
Les requêtes de média de carte peuvent inclure des propriétés de la carte comme documenté dans l'API matchMedia.
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 |