From 770c722d7556ce38a9bb5b16707113fc804ff84e Mon Sep 17 00:00:00 2001 From: Kevin Kim Date: Tue, 7 Feb 2023 15:17:10 -0500 Subject: [PATCH 01/10] add documentation for map-caption --- docs/elements/mapml-viewer.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/elements/mapml-viewer.md b/docs/elements/mapml-viewer.md index 9b1cb0129..66ca07d9d 100644 --- a/docs/elements/mapml-viewer.md +++ b/docs/elements/mapml-viewer.md @@ -86,6 +86,20 @@ The default projection is `OSMTILE`. --- +## Child Elements + +### `` + +This element contains the contents of `` associated to a given map. Details on the layer elements and it's syntax can be found [here](/docs/layers/layer). + +--- + +### `` + +This element contains an invisible caption to ``, which is adapted by screen readers when the map is in focus. + +--- + ## Specifications | Specification | From de13131e39c6cd1849b6f72f2dd8f47fb57c32a7 Mon Sep 17 00:00:00 2001 From: Kevin Kim Date: Fri, 10 Feb 2023 13:15:16 -0500 Subject: [PATCH 02/10] mention that one map-caption should be created per map --- docs/elements/mapml-viewer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/elements/mapml-viewer.md b/docs/elements/mapml-viewer.md index 66ca07d9d..57b817159 100644 --- a/docs/elements/mapml-viewer.md +++ b/docs/elements/mapml-viewer.md @@ -96,7 +96,7 @@ This element contains the contents of `` associated to a given map ### `` -This element contains an invisible caption to ``, which is adapted by screen readers when the map is in focus. +This element contains an invisible caption to ``, which is adapted by screen readers when the map is in focus. Only one `` should be created for each map. --- From 1146a6ba15714fcf578592fa5eca598965afaadf Mon Sep 17 00:00:00 2001 From: Kevin Kim Date: Mon, 13 Feb 2023 09:32:30 -0500 Subject: [PATCH 03/10] add french version --- .../current/elements/mapml-viewer.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) 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 b55548f44..6e695ab1c 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 @@ -85,6 +85,20 @@ La projection par défaut est `OSMTILE`. --- +## Éléments-enfants + +### `` + +Cet élément contient le contenu de `` associé à une carte donnée. Des détails sur les éléments de couche et leur syntaxe peuvent être trouvés [ici](/docs/layers/layer). + +--- + +### `` + +Cet élément contient une légende invisible pour ``, qui est adaptée par les lecteurs d'écran lorsque la carte est en focus. Un seul `` doit être créé pour chaque carte. + +--- + ## Spécifications | Spécification | From ddaaa2d3e7eaa4a8ea7d9f25c0781bb543dae15e Mon Sep 17 00:00:00 2001 From: prushfor Date: Tue, 14 Feb 2023 11:57:28 -0500 Subject: [PATCH 04/10] Tweak description and translation of element child of --- docs/elements/mapml-viewer.md | 5 ++++- .../current/elements/mapml-viewer.md | 6 +++++- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/docs/elements/mapml-viewer.md b/docs/elements/mapml-viewer.md index 57b817159..d189a8c91 100644 --- a/docs/elements/mapml-viewer.md +++ b/docs/elements/mapml-viewer.md @@ -96,7 +96,10 @@ This element contains the contents of `` associated to a given map ### `` -This element contains an invisible caption to ``, which is adapted by screen readers when the map is in focus. Only one `` should be created for each map. +`` may be the first or last element child of ``. +Its content is a simple text string that is not visually rendered (at this time), +but the caption should be read by screen readers when the `` is +focused, as it is used to generate the `` attribute value. --- 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 6e695ab1c..4174140b4 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 @@ -95,7 +95,11 @@ Cet élément contient le contenu de `` associé à une carte donn ### `` -Cet élément contient une légende invisible pour ``, qui est adaptée par les lecteurs d'écran lorsque la carte est en focus. Un seul `` doit être créé pour chaque carte. +`` peut être le premier ou le dernier élément enfant de ``. +Son contenu est une simple chaîne de texte qui n'est pas rendue visuellement actuellement, +mais le contenu devrait être lu par les lecteurs d'écran lorsque le `` +est focalisé, car il est utilisé pour générer la valeur de l'attribut +``. --- From 75e516d406246f7105080c48310fb448d68d0078 Mon Sep 17 00:00:00 2001 From: Kevin Kim Date: Tue, 14 Feb 2023 16:23:41 -0500 Subject: [PATCH 05/10] add mapcaption page --- docs/elements/map-caption.md | 55 +++++++++++++++++++ docs/elements/mapml-viewer.md | 2 +- .../current/elements/map-caption.md | 55 +++++++++++++++++++ .../current/elements/mapml-viewer.md | 2 +- sidebars.js | 1 + static/demo/map-caption-demo/index.html | 49 +++++++++++++++++ 6 files changed, 162 insertions(+), 2 deletions(-) create mode 100644 docs/elements/map-caption.md create mode 100644 i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md create mode 100644 static/demo/map-caption-demo/index.html diff --git a/docs/elements/map-caption.md b/docs/elements/map-caption.md new file mode 100644 index 000000000..e7916120a --- /dev/null +++ b/docs/elements/map-caption.md @@ -0,0 +1,55 @@ +--- +id: map-caption +title: "" +slug: /elements/map-caption/ +--- + +The `` element is a child of `` and is used to define an invisible caption that is adapted by screen readers when the map is in focus. Only one `` should be created for each map. + + +--- + +## Specifications + +| Specification | +|--------------------------------------------------------------| +| [MapML caption element](https://maps4html.org/MapML/spec/#the-map-element-0) | + +--- + +## Requirements + +[Report problems with these requirements on GitHub](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/new?title=-SUMMARIZE+THE+PROBLEM-&body=-DESCRIBE+THE+PROBLEM-) + +

requirement +enhancement +impractical +undecided +under discussion

+ +| | Spec | Viewer | API | +|:---------------------------------------------------------------------------------|:------: |:-----: |:---: | +| [**Rendering base layers (5.1)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-rendering) | | | | +|
Embed an interactive map viewer, using HTML markup (5.1.1)
| [full](https://maps4html.org/MapML/spec/#the-map-element-0) | full | [full](https://maps4html.org/MapML/spec/#webidl-1442763376) | +|
Generate a default map for a given area (5.1.2)
| Not Planned | Not Planned | Not Planned | +|
Display a basic map without JavaScript (5.1.5)
| full | [limited](https://maps4html.org/experiments/progressive-enhancement/) | | +|
Display map content in a users preferred language (5.1.6)
| [full](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/136) | [full](https://github.com/Maps4HTML/mapml-extension) | | +| [**Interpreting locations and map positions (5.3)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-locations) | | | | +|
Select map view from latitude and longitude point (5.3.1)
| full | full | [full](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#zoomtolat-lon-zoom) | +|
Display map tiles defined in various common coordinate systems (5.3.3)
| [full](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/14) | full | [full](https://maps4html.org/web-map-doc/docs/api/custom-projections) | +|
Reproject map tile data into a new projection or globe view (5.3.4)
| [under discussion](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/3) | none | | +|
Save the location or export to other application (5.3.5)
| limited | limited | | +| [**User navigation (pan and zoom) (5.4)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-user-navigation) | | | | +|
Zoom the map independently from the rest of the page (5.4.1)
| full | full | | +|
Pan the map display (5.4.2)
| full | full | | +|
Wrap/duplicate data tiles when panning around the globe (5.4.4)
| none | partial| | | +| [**Custom styling (5.5)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-custom-styling) | | | | +|
Apply custom styling to map controls (5.5.2)
| none | none | | +|
Toggle whether default controls are displayed (5.5.3)
| full | full | | +| [**Controlling the displayed map view and responding to user actions (6.2)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#client-apis-map-viewport) | | | | +|
Subscribe to notifications of map events (6.2.3)
| [pending](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#events) | limited | [full](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#events) | +|
Move the map to display a given location (6.2.5)
| full | full | | +--- + +> - [Edit this page on **Github**](https://github.com/Maps4HTML/web-map-doc/edit/main/docs/elements/map-caption.md) +> - [Chat with us on **Gitter**](https://gitter.im/Maps4HTML/chat) \ No newline at end of file diff --git a/docs/elements/mapml-viewer.md b/docs/elements/mapml-viewer.md index 57b817159..4ecc18fb6 100644 --- a/docs/elements/mapml-viewer.md +++ b/docs/elements/mapml-viewer.md @@ -96,7 +96,7 @@ This element contains the contents of `` associated to a given map ### `` -This element contains an invisible caption to ``, which is adapted by screen readers when the map is in focus. Only one `` should be created for each map. +This element contains an invisible caption to ``, which is adapted by screen readers when the map is in focus. Only one `` should be created for each map. Details on the layer elements and it's syntax can be found [here](../map-caption). --- diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md b/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md new file mode 100644 index 000000000..6dbb06f24 --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md @@ -0,0 +1,55 @@ +--- +id: map-caption +title: "" +slug: /elements/map-caption/ +--- + +L'élément `` est un enfant de `` et est utilisé pour définir une légende invisible qui est adaptée par les lecteurs d'écran lorsque la carte est en focus. Un seul élément `` doit être créé pour chaque carte. + + +--- + +## Spécifications + +| Specification | +|--------------------------------------------------------------| +| [Élément MapML « légende »](https://maps4html.org/MapML/spec/#the-map-element-0) | + +--- + +## Exigences + +[Signaler les problèmes liés à ces exigences sur GitHub](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/new?title=-SUMMARIZE+THE+PROBLEM-&body=-DESCRIBE+THE+PROBLEM-) + +

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

+ +| | Spéc. | Visualiseur | API | +|:---------------------------------------------------------------------------------|:------: |:-----: |:---: | +| [**Rendu des couches de base (5.1)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-rendering) | | | | +|
Intégrer un visualiseur de cartes interactives, à l’aide du balisage HTML (5.1.1)
| [complet](https://maps4html.org/MapML/spec/#the-map-element-0) | complet | [complet](https://maps4html.org/MapML/spec/#webidl-1442763376) | +|
Gérer une carte par défaut pour une région donnée (5.1.2)
| Non prévu | Non prévu | Non prévu | +|
Afficher une carte de base sans JavaScript (5.1.5)
| complet | [limité](http://maps4html.org/experiments/progressive-enhancement/) | | +|
Afficher le contenu d’une carte dans la langue préférée de l’utilisateur (5.1.6)
| [complet](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/136) | [complet](https://github.com/Maps4HTML/mapml-extension) | | +| [**Interpréter les lieux et les positions sur une carte (5.3)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-locations) | | | | +|
Sélectionner la vue d’une carte à partir d’un point de latitude et de longitude (5.3.1)
| complet | complet | [complet](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#zoomtolat-lon-zoom) | +|
Afficher les pavés de carte définis dans divers systèmes de coordonnées courants (5.3.3)
| [complet](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/14) | complet | [complet](https://maps4html.org/web-map-doc/docs/api/custom-projections) | +|
Reprojeter les données des pavés de carte dans une nouvelle projection ou dans la vue Globe (5.3.4)
| [en cours de discussion](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/3) | aucun | | +|
Sauvegarder l’emplacement ou l’exporter dans une autre application (5.3.5)
| limité | limité | | +| [**Navigation des utilisateurs (vue panoramique et zoom) (5.4)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-user-navigation) | | | | +|
Faire un zoom sur la carte indépendamment du reste de la page (5.4.1)
| complet | complet | | +|
Afficher une vue panoramique de la carte (5.4.2)
| complet | complet | | +|
Encapsuler ou dupliquer des pavés de données au moment d’afficher une vue panoramique du monde (5.4.4)
| none | partial| | | +| [**Custom styling (5.5)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-custom-styling) | | | | +|
Appliquer un style personnalisé aux commandes d’une carte (5.5.2)
| aucun | aucun | | +|
Choisir d’afficher les commandes par défaut ou non (5.5.3)
| complet | complet | | +| [**Contrôler la vue de la carte affichée et répondre aux actions de l’utilisateur (6.2)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#client-apis-map-viewport) | | | | +|
S’abonner aux avis concernant les événements liés à une carte (6.2.3)
| [en attente](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#events) | limité | [complet](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#events) | +|
Déplacer la carte pour afficher un emplacement donné (6.2.5)
| complet | complet | | +--- + +> - [Modifier cette page sur **Github**](https://github.com/Maps4HTML/web-map-doc/edit/main/docs/elements/map-caption.md) +> - [Discutez avec nous sur **Gitter**](https://gitter.im/Maps4HTML/chat) \ No newline at end of file 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 6e695ab1c..5d5375f19 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 @@ -95,7 +95,7 @@ Cet élément contient le contenu de `` associé à une carte donn ### `` -Cet élément contient une légende invisible pour ``, qui est adaptée par les lecteurs d'écran lorsque la carte est en focus. Un seul `` doit être créé pour chaque carte. +Cet élément contient une légende invisible pour ``, qui est adaptée par les lecteurs d'écran lorsque la carte est en focus. Un seul `` doit être créé pour chaque carte. Des détails sur les éléments de couche et leur syntaxe peuvent être trouvés [ici](../map-caption). --- diff --git a/sidebars.js b/sidebars.js index b7887226b..24cc6c3a5 100644 --- a/sidebars.js +++ b/sidebars.js @@ -7,6 +7,7 @@ module.exports = { ], 'Mapping Elements': [ 'elements/mapml-viewer', + 'elements/map-caption', 'elements/layer', 'elements/mapml', 'elements/extent', diff --git a/static/demo/map-caption-demo/index.html b/static/demo/map-caption-demo/index.html new file mode 100644 index 000000000..bc66bd24b --- /dev/null +++ b/static/demo/map-caption-demo/index.html @@ -0,0 +1,49 @@ + + + + + + + Demo + + + + + + + + + + + + +
+ +

MapML Demo: <map-caption>

+ +
+ +
+ + +
+ +
+ + +
+
+ + +
+ +
+ + + + From a51c6aa765185092d7f2ded4736b1cbc496a81aa Mon Sep 17 00:00:00 2001 From: Kevin Kim Date: Tue, 14 Feb 2023 16:56:43 -0500 Subject: [PATCH 06/10] modify text --- docs/elements/map-caption.md | 3 ++- .../current/elements/map-caption.md | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/elements/map-caption.md b/docs/elements/map-caption.md index e7916120a..201be73cd 100644 --- a/docs/elements/map-caption.md +++ b/docs/elements/map-caption.md @@ -4,7 +4,8 @@ title: "" slug: /elements/map-caption/ --- -The `` element is a child of `` and is used to define an invisible caption that is adapted by screen readers when the map is in focus. Only one `` should be created for each map. +The `` element is a child of `` and is used to define a simple text string that is not visually rendered (at this time), +but the caption should be read by screen readers when the `` is focused, as it is used to generate the `` attribute value. `` may be the first or last element child of ``. --- diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md b/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md index 6dbb06f24..409d38d2f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md @@ -4,7 +4,8 @@ title: "" slug: /elements/map-caption/ --- -L'élément `` est un enfant de `` et est utilisé pour définir une légende invisible qui est adaptée par les lecteurs d'écran lorsque la carte est en focus. Un seul élément `` doit être créé pour chaque carte. +L'élément `` est un enfant de `` et est utilisé pour définir une simple chaîne de texte qui n'est pas rendue visuellement, +mais le contenu devrait être lu par les lecteurs d'écran lorsque le `` est focalisé, car il est utilisé pour générer la valeur de l'attribut ``. `` peut être le premier ou le dernier élément enfant de ``. --- From 434033edce3807d5649480d73a64f981f647d9fc Mon Sep 17 00:00:00 2001 From: Kevin Kim Date: Wed, 15 Feb 2023 09:38:46 -0500 Subject: [PATCH 07/10] modify text --- docs/elements/mapml-viewer.md | 1 + .../current/elements/mapml-viewer.md | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/elements/mapml-viewer.md b/docs/elements/mapml-viewer.md index d189a8c91..4cc84cb64 100644 --- a/docs/elements/mapml-viewer.md +++ b/docs/elements/mapml-viewer.md @@ -100,6 +100,7 @@ This element contains the contents of `` associated to a given map Its content is a simple text string that is not visually rendered (at this time), but the caption should be read by screen readers when the `` is focused, as it is used to generate the `` attribute value. +Further details and it's syntax can be found [here](../map-caption/). --- 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 4174140b4..f71bbfa4a 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 @@ -99,7 +99,7 @@ Cet élément contient le contenu de `` associé à une carte donn Son contenu est une simple chaîne de texte qui n'est pas rendue visuellement actuellement, mais le contenu devrait être lu par les lecteurs d'écran lorsque le `` est focalisé, car il est utilisé pour générer la valeur de l'attribut -``. +``. Plus de détails et sa syntaxe sont disponibles [ici](../map-caption/). --- From e88b21803ca4441e12316b3ff380fbb4148cf770 Mon Sep 17 00:00:00 2001 From: AliyanH Date: Wed, 15 Feb 2023 10:16:38 -0500 Subject: [PATCH 08/10] small bug fix --- docs/elements/map-caption.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/elements/map-caption.md b/docs/elements/map-caption.md index 201be73cd..ebc205978 100644 --- a/docs/elements/map-caption.md +++ b/docs/elements/map-caption.md @@ -8,6 +8,7 @@ The `` element is a child of `` and is used to define but the caption should be read by screen readers when the `` is focused, as it is used to generate the `` attribute value. `` may be the first or last element child of ``. + --- ## Specifications From 24280576d65117e24ce226f9a8fd752d3dc81757 Mon Sep 17 00:00:00 2001 From: Kevin Kim Date: Wed, 15 Feb 2023 10:33:05 -0500 Subject: [PATCH 09/10] bug fix for fr version --- .../current/elements/map-caption.md | 1 + 1 file changed, 1 insertion(+) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md b/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md index 409d38d2f..77c0a3a66 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md @@ -8,6 +8,7 @@ L'élément `` est un enfant de `` et est utilisé po mais le contenu devrait être lu par les lecteurs d'écran lorsque le `` est focalisé, car il est utilisé pour générer la valeur de l'attribut ``. `` peut être le premier ou le dernier élément enfant de ``. + --- ## Spécifications From 7a161f18c9bde192fbb4f20db6b36fe747903a52 Mon Sep 17 00:00:00 2001 From: Kevin Kim Date: Wed, 15 Feb 2023 14:15:48 -0500 Subject: [PATCH 10/10] Add map-caption documentation --- docs/elements/map-caption.md | 32 ++++++------------- docs/elements/mapml-viewer.md | 18 ----------- .../current/elements/map-caption.md | 32 ++++++------------- .../current/elements/mapml-viewer.md | 18 ----------- static/demo/map-caption-demo/index.html | 2 +- 5 files changed, 19 insertions(+), 83 deletions(-) diff --git a/docs/elements/map-caption.md b/docs/elements/map-caption.md index ebc205978..4120d0030 100644 --- a/docs/elements/map-caption.md +++ b/docs/elements/map-caption.md @@ -4,8 +4,12 @@ title: "" slug: /elements/map-caption/ --- -The `` element is a child of `` and is used to define a simple text string that is not visually rendered (at this time), -but the caption should be read by screen readers when the `` is focused, as it is used to generate the `` attribute value. `` may be the first or last element child of ``. +The `` element is a child of `` and is used to define +a simple text string that is not visually rendered (at this time). +The caption should be read by screen readers when the `` is focused, +as it generates the `` value, if no aria-label +has been specified by the HTML author. `` may be the first or last +element child of ``. @@ -15,7 +19,7 @@ but the caption should be read by screen readers when the `` is fo | Specification | |--------------------------------------------------------------| -| [MapML caption element](https://maps4html.org/MapML/spec/#the-map-element-0) | +| [Not yet specified](https://github.com/Maps4HTML/MapML/issues/234) | --- @@ -31,26 +35,8 @@ but the caption should be read by screen readers when the `` is fo | | Spec | Viewer | API | |:---------------------------------------------------------------------------------|:------: |:-----: |:---: | -| [**Rendering base layers (5.1)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-rendering) | | | | -|
Embed an interactive map viewer, using HTML markup (5.1.1)
| [full](https://maps4html.org/MapML/spec/#the-map-element-0) | full | [full](https://maps4html.org/MapML/spec/#webidl-1442763376) | -|
Generate a default map for a given area (5.1.2)
| Not Planned | Not Planned | Not Planned | -|
Display a basic map without JavaScript (5.1.5)
| full | [limited](https://maps4html.org/experiments/progressive-enhancement/) | | -|
Display map content in a users preferred language (5.1.6)
| [full](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/136) | [full](https://github.com/Maps4HTML/mapml-extension) | | -| [**Interpreting locations and map positions (5.3)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-locations) | | | | -|
Select map view from latitude and longitude point (5.3.1)
| full | full | [full](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#zoomtolat-lon-zoom) | -|
Display map tiles defined in various common coordinate systems (5.3.3)
| [full](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/14) | full | [full](https://maps4html.org/web-map-doc/docs/api/custom-projections) | -|
Reproject map tile data into a new projection or globe view (5.3.4)
| [under discussion](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/3) | none | | -|
Save the location or export to other application (5.3.5)
| limited | limited | | -| [**User navigation (pan and zoom) (5.4)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-user-navigation) | | | | -|
Zoom the map independently from the rest of the page (5.4.1)
| full | full | | -|
Pan the map display (5.4.2)
| full | full | | -|
Wrap/duplicate data tiles when panning around the globe (5.4.4)
| none | partial| | | -| [**Custom styling (5.5)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-custom-styling) | | | | -|
Apply custom styling to map controls (5.5.2)
| none | none | | -|
Toggle whether default controls are displayed (5.5.3)
| full | full | | -| [**Controlling the displayed map view and responding to user actions (6.2)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#client-apis-map-viewport) | | | | -|
Subscribe to notifications of map events (6.2.3)
| [pending](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#events) | limited | [full](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#events) | -|
Move the map to display a given location (6.2.5)
| full | full | | +| [**Interpreting locations & map positions (5.3)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-locations) | | | | +|
Provide an accessible name for a map
| [under discussion](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/260) | [provisional](https://maps4html.org/web-map-doc/docs/elements/map-caption/) | [under discussion](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/260) | --- > - [Edit this page on **Github**](https://github.com/Maps4HTML/web-map-doc/edit/main/docs/elements/map-caption.md) diff --git a/docs/elements/mapml-viewer.md b/docs/elements/mapml-viewer.md index a4aba0544..c07bc5d60 100644 --- a/docs/elements/mapml-viewer.md +++ b/docs/elements/mapml-viewer.md @@ -98,24 +98,6 @@ The default projection is `OSMTILE`. --- -## Child Elements - -### `` - -This element contains the contents of `` associated to a given map. Details on the layer elements and it's syntax can be found [here](/docs/layers/layer). - ---- - -### `` - -`` may be the first or last element child of ``. -Its content is a simple text string that is not visually rendered (at this time), -but the caption should be read by screen readers when the `` is -focused, as it is used to generate the `` attribute value. -Further details and it's syntax can be found [here](../map-caption/). - ---- - ## Specifications | Specification | diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md b/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md index 77c0a3a66..f3659ee5c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/elements/map-caption.md @@ -4,8 +4,12 @@ title: "" slug: /elements/map-caption/ --- -L'élément `` est un enfant de `` et est utilisé pour définir une simple chaîne de texte qui n'est pas rendue visuellement, -mais le contenu devrait être lu par les lecteurs d'écran lorsque le `` est focalisé, car il est utilisé pour générer la valeur de l'attribut ``. `` peut être le premier ou le dernier élément enfant de ``. +L'élément `` est un enfant de `` et est utilisé pour +définir une simple chaîne de texte qui n'est pas rendue visuellement. +Le contenu devrait être lu par les lecteurs d'écran lorsque le `` +est focalisé, car il est utilisé pour générer la valeur de l'attribut +``, si l'auteur n'en fournit pas. +`` peut être le premier ou le dernier élément enfant de ``. @@ -15,7 +19,7 @@ mais le contenu devrait être lu par les lecteurs d'écran lorsque le `Intégrer un visualiseur de cartes interactives, à l’aide du balisage HTML (5.1.1) | [complet](https://maps4html.org/MapML/spec/#the-map-element-0) | complet | [complet](https://maps4html.org/MapML/spec/#webidl-1442763376) | -|
Gérer une carte par défaut pour une région donnée (5.1.2)
| Non prévu | Non prévu | Non prévu | -|
Afficher une carte de base sans JavaScript (5.1.5)
| complet | [limité](http://maps4html.org/experiments/progressive-enhancement/) | | -|
Afficher le contenu d’une carte dans la langue préférée de l’utilisateur (5.1.6)
| [complet](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/136) | [complet](https://github.com/Maps4HTML/mapml-extension) | | -| [**Interpréter les lieux et les positions sur une carte (5.3)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-locations) | | | | -|
Sélectionner la vue d’une carte à partir d’un point de latitude et de longitude (5.3.1)
| complet | complet | [complet](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#zoomtolat-lon-zoom) | -|
Afficher les pavés de carte définis dans divers systèmes de coordonnées courants (5.3.3)
| [complet](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/14) | complet | [complet](https://maps4html.org/web-map-doc/docs/api/custom-projections) | -|
Reprojeter les données des pavés de carte dans une nouvelle projection ou dans la vue Globe (5.3.4)
| [en cours de discussion](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/3) | aucun | | -|
Sauvegarder l’emplacement ou l’exporter dans une autre application (5.3.5)
| limité | limité | | -| [**Navigation des utilisateurs (vue panoramique et zoom) (5.4)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-user-navigation) | | | | -|
Faire un zoom sur la carte indépendamment du reste de la page (5.4.1)
| complet | complet | | -|
Afficher une vue panoramique de la carte (5.4.2)
| complet | complet | | -|
Encapsuler ou dupliquer des pavés de données au moment d’afficher une vue panoramique du monde (5.4.4)
| none | partial| | | -| [**Custom styling (5.5)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-custom-styling) | | | | -|
Appliquer un style personnalisé aux commandes d’une carte (5.5.2)
| aucun | aucun | | -|
Choisir d’afficher les commandes par défaut ou non (5.5.3)
| complet | complet | | -| [**Contrôler la vue de la carte affichée et répondre aux actions de l’utilisateur (6.2)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#client-apis-map-viewport) | | | | -|
S’abonner aux avis concernant les événements liés à une carte (6.2.3)
| [en attente](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#events) | limité | [complet](https://maps4html.org/web-map-doc/docs/api/mapml-viewer-api#events) | -|
Déplacer la carte pour afficher un emplacement donné (6.2.5)
| complet | complet | | +| [**Interprétation des lieux et des positions sur la carte (5.3)**](https://maps4html.org/HTML-Map-Element-UseCases-Requirements/#map-viewers-capabilities-locations) | | | | + |
Fournir un nom accessible pour une carte
| [en cours de discussion](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/260) | [provisoire](https://maps4html.org/web-map-doc/docs/elements/map-caption/) | [en cours de discussion](https://github.com/Maps4HTML/HTML-Map-Element-UseCases-Requirements/issues/260) | --- > - [Modifier cette page sur **Github**](https://github.com/Maps4HTML/web-map-doc/edit/main/docs/elements/map-caption.md) 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 a0a155f29..8a81fadca 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 @@ -97,24 +97,6 @@ La projection par défaut est `OSMTILE`. --- -## Éléments-enfants - -### `` - -Cet élément contient le contenu de `` associé à une carte donnée. Des détails sur les éléments de couche et leur syntaxe peuvent être trouvés [ici](/docs/layers/layer). - ---- - -### `` - -`` peut être le premier ou le dernier élément enfant de ``. -Son contenu est une simple chaîne de texte qui n'est pas rendue visuellement actuellement, -mais le contenu devrait être lu par les lecteurs d'écran lorsque le `` -est focalisé, car il est utilisé pour générer la valeur de l'attribut -``. Plus de détails et sa syntaxe sont disponibles [ici](../map-caption/). - ---- - ## Spécifications | Spécification | diff --git a/static/demo/map-caption-demo/index.html b/static/demo/map-caption-demo/index.html index bc66bd24b..123dd0cf7 100644 --- a/static/demo/map-caption-demo/index.html +++ b/static/demo/map-caption-demo/index.html @@ -32,7 +32,7 @@

MapML Demo: <map-caption>