Aller au contenu principal

HTMLExtentElement

Propriétés​

units​

La propriété units est en lecture seule et renvoie la valeur initiale de l'attribut de contenu units.

checked​

HTMLExtentElement.checked est une valeur booléenne en lecture/écriture qui active ou désactive le map-extent, et reflète l'attribut checked. L'état checked est reflété dans l'interface utilisateur du contrôle de couche pour le map-extent, s'il n'est pas dans l'état hidden, via une case à cocher à côté du nom du map-extent. La propriété "checked" peut être utilisée pour modifier par programme l'état checked de l'étendue. La propriété checked ne peut pas être modifiée si la propriété disabled est définie.

Pour activer l'état checked d'un map-extent :

let extent = document.querySelector('map-extent');
extent.checked = true; // les valeurs valides sont true | false

Pour lire l'état coché de l'étendue de la carte :

let extent = document.querySelector('map-extent');
let isChecked = extent.checked;

hidden​

HTMLExtentElement.hidden est une valeur booléenne en lecture/écriture qui cache ou dé-cache le map-extent map-extent dans le contrôle de couche uniquement.
L'état hidden n'a pas de rapport avec la présence du contenu du map-extent sur la carte, il n'affecte que la présence du map-extent dans le contrôle des couches. Cela peut être utile pour simplifier la représentation du contrôle des couches d'une couche parentale contenant un seul map-extent, sans encombrer l'interface utilisateur.

Permet de définir/mettre à jour si l'étendue de la carte est cachée dans le contrôle de la couche :

let extent = document.querySelector('map-extent');
extent.hidden = true; // les valeurs valides sont true | false

Pour obtenir la valeur cachée de <map-extent> :

let extent = document.querySelector('map-extent');
let isHidden = extent.hidden;

disabled​

HTMLExtentElement.disabled fournit un accès en mode READ-ONLY à l'état désactivé de l'élément map-extent. Un map-extent devient désactivé si son contenu n'est pas rendu, soit parce qu'il est complètement en dehors des limites du map-extent actuel, soit parce qu'une erreur est associée au au traitement du map-extent, telle qu'une projection incompatible avec la projection de la carte. Lorsqu'un map-extent est désactivé, l'utilisateur peut toujours interagir avec lui d'une certaine manière dans le contrôle de couche, mais il ne sera pas visible dans la fenêtre de visualisation de la carte. Si un map-extent est activé, à la suite d'une manipulation de la carte, par exemple, le map-extent deviendra totalement interactif dans le contrôle de couche, et devrait être visible dans la fenêtre d'affichage de la carte (bien que difficile à voir, en fonction de l'opacité et de la taille de l'élément, entre autres considérations).

label​

HTMLExtentElement.label reflète l'attribut de contenu label et spécifie un nom accessible de repli pour l'étendue dans le contrôle de couche. Si l'attribut de contenu n'est pas fourni, une variante internationalisée de "Sub-Layer" sera renvoyée comme valeur par défaut.

Pour définir/mettre à jour l'étiquette de <map-extent> :

let extent = document.querySelector('map-extent');
extent.label = "Nouveau nom accessible";

Pour obtenir la valeur de l'étiquette de <map-extent> :

let extent = document.querySelector('map-extent');
let label = extent.label;

opacity​

HTMLExtentElement.opacity fournit un accès en mode lecture/écriture à la valeur opacity, et est reflétée dans le contrôle de couche pour chaque map-extent, sous "Opacity". Si aucun attribut de contenu attribut opacity n'est défini, l'attribution de la propriété opacity ne créera pas pas l'attribut, mais l'opacité du contenu sur la carte et dans la représentation du contrôle de couche (entrée du curseur) sera modifiée.

Pour définir/mettre à jour l'opacité de <map-extent> :

let extent = document.querySelector('map-extent');
extent.opacity = 0.5; // valeurs valides de 0 à 1

Pour obtenir la valeur d'opacité de <map-extent> :

let extent = document.querySelector('map-extent');
let opacity = extent.opacity;

extent​

HTMLExtentElement.extent fournit un accès en LECTURE SEULE aux coordonnées en haut à gauche et en bas à droite du rectangle de délimitation minimal de la couche sous forme d'objet.

Pour obtenir la valeur de l'étendue de <map-extent> :

let map-extent = document.querySelector('map-extent');
let extent = map-extent.extent;

L'objet extent est structuré comme suit :

Cliquez pour afficher l'objet extent
{
    "projection": "CBMTILE",
    "topLeft": {
        "tcrs": [
            {
                "horizontal": 942.662039991251,
                "vertical": 1029.0945982508472
            },
/* un objet avec des propriétés "horizontal" et "vertical" pour chaque niveau de zoom dans le tableau */
            {
                "horizontal": 546743983.1949257,
                "vertical": 596874866.9854914
            }
        ],
        "tilematrix": [
            {
                "horizontal": 3.6822735937158244,
                "vertical": 4.019900774417372
            },
/* un objet avec des propriétés "horizontal" et "vertical" pour chaque niveau de zoom dans le tableau */
            {
                "horizontal": 2135718.6843551784,
                "vertical": 2331542.4491620758
            }
        ],
/* gcrs signifie "système de référence des coordonnées géographiques" */
        "gcrs": {
            "horizontal": -75.73195696514524,
            "vertical": 45.40761073808424
        },
/* pcrs signifie "système de référence des coordonnées projetées" */
        "pcrs": {
            "horizontal": 1509108.7182317898,
            "vertical": -170864.4342066869
        }
    },
    "bottomRight": {
        "tcrs": [
            {
                "horizontal": 942.7503158533199,
                "vertical": 1029.1828741129164
            },
            {
                "horizontal": 546795183.1949255,
                "vertical": 596926066.9854914
            }
        ],
        "tilematrix": [
            {
                "horizontal": 3.6826184213020308,
                "vertical": 4.0202456020035795
            },
            {
                "horizontal": 2135918.684355178,
                "vertical": 2331742.4491620758
            }
        ],
        "gcrs": {
            "horizontal": -75.67858731979081,
            "vertical": 45.387937810298354
        },
        "pcrs": {
            "horizontal": 1512495.3916717991,
            "vertical": -174251.10764670372
        }
    }
}

Méthodes​

zoomTo()​

HTMLExtentElement.zoomTo() zoomer sur l'étendue de la sous-couche dans la carte, au niveau de zoom maximal dans lequel l'étendue s'ajuste complètement.

let map-extent = document.querySelector('map-extent');
map-extent.zoomTo();

Evénements​

Nom de l'événementDescription
map-changeDéclenché lorsque l'étendue est cochée ou décochée via le menu des couches (en cliquant ou en utilisant le clavier)

Exemples​

Spécifications​

Spécification
HTMLExtentElement

Exigences​

Signaler les problèmes liés à ces exigences sur GitHub

exigence amélioration peu pratique indécis en cours de discussion

Spéc.VisualiseurAPI
Propriétéscompletcompletcomplet
Méthodess/os/os/o
Evénementss/os/os/o