From c0ab01de95a1674c26a372b7a618a4f298d32754 Mon Sep 17 00:00:00 2001 From: AliyanH Date: Wed, 15 Mar 2023 10:25:20 -0400 Subject: [PATCH 1/2] remove ot implemented sign --- docs/api/mapml-viewer-api.mdx | 15 --------------- .../current/api/mapml-viewer-api.mdx | 15 --------------- 2 files changed, 30 deletions(-) diff --git a/docs/api/mapml-viewer-api.mdx b/docs/api/mapml-viewer-api.mdx index 865bdb03..4627374f 100644 --- a/docs/api/mapml-viewer-api.mdx +++ b/docs/api/mapml-viewer-api.mdx @@ -139,11 +139,6 @@ let extent = map.extent; ### lat To set the latitude: - -:::caution -[Needs to be implemented](https://github.com/Maps4HTML/Web-Map-Custom-Element/issues/588), currently doesn't pan the map on changes -::: - ```js let map = document.querySelector('mapml-viewer'); map.lat = 21.4; // if it's an invalid value, nothing happens @@ -160,11 +155,6 @@ let latitude = map.lat; ### lon To set the longitude: - -:::caution -[Needs to be implemented](https://github.com/Maps4HTML/Web-Map-Custom-Element/issues/588), currently doesn't pan the map on changes -::: - ```js let map = document.querySelector('mapml-viewer'); map.lon = 21.4; // if it's an invalid value, nothing happens @@ -198,11 +188,6 @@ let projection = map.projection; ### zoom To set the zoom: - -:::caution -[Needs to be implemented](https://github.com/Maps4HTML/Web-Map-Custom-Element/issues/588), currently doesn't zoom the map on changes -::: - ```js let map = document.querySelector('mapml-viewer'); map.zoom = 3; // if it's an invalid value, nothing happens diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/api/mapml-viewer-api.mdx b/i18n/fr/docusaurus-plugin-content-docs/current/api/mapml-viewer-api.mdx index aebaa22b..8fc6d211 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/api/mapml-viewer-api.mdx +++ b/i18n/fr/docusaurus-plugin-content-docs/current/api/mapml-viewer-api.mdx @@ -139,11 +139,6 @@ let extent = map.extent; ### lat Pour définir la latitude : - -:::caution -[À mettre en œuvre](https://github.com/Maps4HTML/Web-Map-Custom-Element/issues/588), à l’heure actuelle, n’effectue pas de mouvements panoramiques vers les modifications de la carte -::: - ```js let map = document.querySelector('mapml-viewer'); map.lat = 21.4; // rien ne se produit si la valeur n’est pas valide @@ -160,11 +155,6 @@ let latitude = map.lat; ### lon Pour définir la longitude : - -:::caution -[À mettre en œuvre](https://github.com/Maps4HTML/Web-Map-Custom-Element/issues/588), à l’heure actuelle, n’effectue pas de mouvements panoramiques vers les modifications de la carte -::: - ```js let map = document.querySelector('mapml-viewer'); map.lon = 21.4; // rien ne se produit si la valeur n’est pas valide @@ -198,11 +188,6 @@ let projection = map.projection; ### zoom Pour définir le niveau de zoom : - -:::caution -[À mettre en œuvre](https://github.com/Maps4HTML/Web-Map-Custom-Element/issues/588), à l’heure actuelle, n’effectue pas un zoom sur les changements apportés à la carte -::: - ```js let map = document.querySelector('mapml-viewer'); map.zoom = 3; // rien ne se produit si la valeur n’est pas valide From 49d5c01e3987f70486bf978d1c55da3d9ea80cce Mon Sep 17 00:00:00 2001 From: Peter Rushforth Date: Thu, 16 Mar 2023 15:38:23 -0400 Subject: [PATCH 2/2] Update lat, lon and zoom content attribute () and IDL (HTMLMapmlViewerElement) descriptions to make clear that they operate on intial values only. --- docs/api/mapml-viewer-api.mdx | 17 +++++++++++++---- docs/elements/mapml-viewer.md | 6 +++--- .../current/api/mapml-viewer-api.mdx | 18 +++++++++++++++--- .../current/elements/mapml-viewer.md | 6 +++--- 4 files changed, 34 insertions(+), 13 deletions(-) diff --git a/docs/api/mapml-viewer-api.mdx b/docs/api/mapml-viewer-api.mdx index 4627374f..be9c25bc 100644 --- a/docs/api/mapml-viewer-api.mdx +++ b/docs/api/mapml-viewer-api.mdx @@ -16,10 +16,10 @@ The HTMLMapmlViewerElement interface represents the `` element. | [controls](#controls) | Turns native map controls on or off. Reflects the controls attribute. | | [controlsList](#controlslist) | Allows to change the set of native controls. Reflects the controlslist attribute. | | [extent](#extent) | Returns the extent of the current map view. Read only. | -| [lat](#lat) | Get the map's latitude. Reflects the lat attribute. Read only. | -| [lon](#lon) | Get the map's longitude. Reflects the lon attribute. Read only. | +| [lat](#lat) | Get or set the map's latitude. Reflects to the lat content attribute. No effect on map dynamic state. | +| [lon](#lon) | Get or set the map's longitude. Reflects to the lon content attribute. No effect on map dynamic state. | | [projection](#projection) | The map's projection. Reflects the projection attribute. | -| [zoom](#zoom) | The map's zoom level. Reflects the zoom attribute. | +| [zoom](#zoom) | Get or set the map's zoom level. Reflects to the zoom content attribute. No effect on map dynamic state. | ### controls @@ -143,6 +143,9 @@ To set the latitude: let map = document.querySelector('mapml-viewer'); map.lat = 21.4; // if it's an invalid value, nothing happens ``` +Note that the value supplied does not affect the map viewer state, except at +document load, or when an instance of a `` element is constructed +and programmatically added to the DOM. To change the value, use [zoomTo()](#zoomTo); To get the latitude: ```js @@ -159,6 +162,9 @@ To set the longitude: let map = document.querySelector('mapml-viewer'); map.lon = 21.4; // if it's an invalid value, nothing happens ``` +Note that the value supplied does not affect the map viewer state, except at +document load, or when an instance of a `` element is constructed +and programmatically added to the DOM. To change the value, use [zoomTo()](#zoomTo); To get the longitude: ```js @@ -190,8 +196,11 @@ let projection = map.projection; To set the zoom: ```js let map = document.querySelector('mapml-viewer'); -map.zoom = 3; // if it's an invalid value, nothing happens +map.zoom = 3; // if it's an invalid value, will default to 0 ``` +Note that the value supplied does not affect the map viewer state, except at +document load, or when an instance of a `` element is constructed +and programmatically added to the DOM. To change the value, use [zoomTo()](#zoomTo); To get the longitude: ```js diff --git a/docs/elements/mapml-viewer.md b/docs/elements/mapml-viewer.md index 74219c2a..f07007a4 100644 --- a/docs/elements/mapml-viewer.md +++ b/docs/elements/mapml-viewer.md @@ -58,19 +58,19 @@ The default projection is `OSMTILE`. ### `zoom` -`zoom` - a non-negative integer. The value establishes the initial zoom level of the map. For a small scale view of the world, use a lower value. Use larger values for larger scales (smaller area maps). The maximum value depends on the particular `projection` and data source. Many map data sources have limited zoom levels available. +`zoom` - a non-negative integer. The value establishes the _initial_ zoom level of the map, and is required. The value is updated when the map stops moving. For a smaller scale view of the world, use a lower value. Use larger values for larger scales (smaller area maps). The maximum value depends on the particular `projection` and data source. Many map data sources have limited zoom levels available. --- ### `lat` -`lat` - a real number latitude. The value establishes the initial latitude of the of the center of the map. Latitudes on Earth range from -90.0 (south) to 90.0 (north). Many projections are not able to display all latitudes, and most projections have a limited range of locations where distortion is controlled or limited. In particular, OSMTILE (Web Mercator) can only display content between the latitude range -84 to 84. +`lat` - a real number latitude. The value establishes the _initial_ latitude of the of the center of the map, and is required. The value is updated when the map stops moving. Latitudes on Earth range from -90.0 (south) to 90.0 (north). Many projections are not able to display all latitudes, and most projections have a limited range of locations where distortion is controlled or limited. In particular, OSMTILE (Web Mercator) can only display content between the latitude range -84 to 84. --- ### `lon` -`lon` - a real number longitude. The value establishes the initial longitude of the of the center of the map.Longitudes on Earth range from -180.0 (west) to 180.0 (east). Similar comments related to distortion apply to those for latitude. Be careful, this attribute is named "lon" NOT "long", and if you use "long" your map won't work properly. +`lon` - a real number longitude. The value establishes the _initial_ longitude of the of the center of the map, and is required. The value is updated when the map stops moving. Longitudes on Earth range from -180.0 (west) to 180.0 (east). Similar comments related to distortion apply to those for latitude. Be careful, this attribute is named "lon" NOT "long", and if you use "long" your map won't work properly. --- diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/api/mapml-viewer-api.mdx b/i18n/fr/docusaurus-plugin-content-docs/current/api/mapml-viewer-api.mdx index 8fc6d211..142e0ccf 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/api/mapml-viewer-api.mdx +++ b/i18n/fr/docusaurus-plugin-content-docs/current/api/mapml-viewer-api.mdx @@ -16,10 +16,10 @@ L’interface HTMLMapmlViewerElement représente l’élément ``. | [controls](#controls) | Active ou désactive les contrôles natifs de la carte. Reproduit l’attribut controls. | | [controlsList](#controlslist) | Permet de changer l’ensemble des contrôles natifs. Reproduit l’attribut controlslist. | | [extent](#extent) | Retourne l’étendue de la carte affichée. En lecture seule. | -| [lat](#lat) | Permet d’obtenir la latitude de la carte. Reproduit l’attribut lat. En lecture seule. | -| [lon](#lon) | Permet d’obtenir la longitude de la carte. Reproduit l’attribut lon. En lecture seule. | +| [lat](#lat) | Obtient ou définit la latitude de la carte. Reproduit dans l’attribut de contenu lat. Aucun effet sur l'état dynamique de la carte. | +| [lon](#lon) | Obtient ou définit la longitude de la carte. Reproduit dans l’attribut de contenu lon. Aucun effet sur l'état dynamique de la carte.| | [projection](#projection) | Projection de la carte. Reproduit l’attribut projection. | -| [zoom](#zoom) | Niveau de zoom de la carte. Reproduit l’attribut zoom. | +| [zoom](#zoom) | Obtient ou définit le niveau de zoom de la carte. Reproduit dans l’attribut de contenu zoom. Aucun effet sur l'état dynamique de la carte.| ### controls @@ -143,6 +143,10 @@ Pour définir la latitude : let map = document.querySelector('mapml-viewer'); map.lat = 21.4; // rien ne se produit si la valeur n’est pas valide ``` +Notez que la valeur fournie n'affecte pas l'état de la visionneuse de carte, +sauf au chargement du document, ou lorsqu'une instance d'un élément `` +est construite et ajoutée par programme au DOM. Pour modifier la valeur, utilisez +[zoomTo()](#zoomTo) Pour obtenir la latitude : ```js @@ -159,6 +163,10 @@ Pour définir la longitude : let map = document.querySelector('mapml-viewer'); map.lon = 21.4; // rien ne se produit si la valeur n’est pas valide ``` +Notez que la valeur fournie n'affecte pas l'état de la visionneuse de carte, +sauf au chargement du document, ou lorsqu'une instance d'un élément `` +est construite et ajoutée par programme au DOM. Pour modifier la valeur, utilisez +[zoomTo()](#zoomTo) Pour obtenir la longitude : ```js @@ -192,6 +200,10 @@ Pour définir le niveau de zoom : let map = document.querySelector('mapml-viewer'); map.zoom = 3; // rien ne se produit si la valeur n’est pas valide ``` +Notez que la valeur fournie n'affecte pas l'état de la visionneuse de carte, +sauf au chargement du document, ou lorsqu'une instance d'un élément `` +est construite et ajoutée par programme au DOM. Pour modifier la valeur, utilisez +[zoomTo()](#zoomTo) Pour obtenir la longitude : ```js diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/elements/mapml-viewer.md b/i18n/fr/docusaurus-plugin-content-docs/current/elements/mapml-viewer.md index f09684a1..3f0b08ec 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/elements/mapml-viewer.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/elements/mapml-viewer.md @@ -57,19 +57,19 @@ La projection par défaut est `OSMTILE`. ### `zoom` -`zoom` - entier non négatif. Cette valeur établit le niveau de zoom initial de la carte. Pour obtenir une vue du monde à petite échelle, utilisez une valeur faible. Utilisez des valeurs supérieures pour obtenir une vue à grande échelle (cartes de petites zones). La valeur maximale dépend de la `projection` en question et de la source des données. Bon nombre des sources de données cartographiques offrent des niveaux de zoom limités. +`zoom` - entier non négatif. Cette valeur définit le niveau de zoom initial de la carte et est obligatoire. La valeur est mise à jour lorsque la carte cesse de se déplacer. Pour obtenir une vue du monde à petite échelle, utilisez une valeur faible. Utilisez des valeurs supérieures pour obtenir une vue à grande échelle (cartes de petites zones). La valeur maximale dépend de la `projection` en question et de la source des données. Bon nombre des sources de données cartographiques offrent des niveaux de zoom limités. --- ### `lat` -`lat` - nombre réel de la latitude. Cette valeur établit la latitude initiale du centre de la carte. Sur Terre, les latitudes vont de -90.0 (Sud) à 90.0 (Nord). De nombreuses projections ne permettent pas d’afficher toutes les latitudes et la plupart permettent de contrôler ou de limiter la distorsion dans un certain nombre d’emplacements. En particulier, OSMTILE (Web Mercator) peut afficher seulement le contenu compris entre les latitudes -84 à 84. +`lat` - nombre réel de la latitude. Cette valeur établit la latitude initiale du centre de la carte. La valeur est mise à jour lorsque la carte cesse de se déplacer. Sur Terre, les latitudes vont de -90.0 (Sud) à 90.0 (Nord). De nombreuses projections ne permettent pas d’afficher toutes les latitudes et la plupart permettent de contrôler ou de limiter la distorsion dans un certain nombre d’emplacements. En particulier, OSMTILE (Web Mercator) peut afficher seulement le contenu compris entre les latitudes -84 à 84. --- ### `lon` -`lon` - nombre réel de la longitude. Cette valeur établit la longitude initiale du centre de la carte. Sur Terre, les longitudes vont de -180.0 (Ouest) à 180.0 (Est). Les mêmes commentaires formulés précédemment concernant la distorsion s’appliquent. Faites attention, le nom de cet attribut est « lon » et non « long »; votre carte ne fonctionnera pas correctement si vous utilisez « long ». +`lon` - nombre réel de la longitude. Cette valeur établit la longitude initiale du centre de la carte. La valeur est mise à jour lorsque la carte cesse de se déplacer. Sur Terre, les longitudes vont de -180.0 (Ouest) à 180.0 (Est). Les mêmes commentaires formulés précédemment concernant la distorsion s’appliquent. Faites attention, le nom de cet attribut est « lon » et non « long »; votre carte ne fonctionnera pas correctement si vous utilisez « long ». ---