Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 2 additions & 34 deletions docs/elements/input.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ using the `{name}` variable reference notation.
| location | A location input captures **one** `axis` value of a two-dimensional point ( represented by a coordinate pair) from the map extent, e.g. `top-right`, or, for server queries, the location in the map where the user clicks or touches. |
| width | A width input captures the width of the map viewport's extent in standardized pixels |
| height | A height input captures the height of the map viewport's extent in standardized pixels |
| hidden | Establishes a variable that may be used to pass a fixed or [fixed domain of values](#shard) to the server when requesting map resources. |
| hidden | Establishes a variable that may be used to pass a fixed value to the server when requesting map resources. |
---

### `value`
Expand Down Expand Up @@ -159,32 +159,6 @@ to zoom values of 1, 2 and 3 as the map is rendered at those levels. Use of thi
attribute can conserve user bandwidth while having little visual effect, depending
on the nature of the content.

---
### `shard`

The boolean `shard` attribute is used with a `hidden` variable.

A `<map-input shard list="datalist-id>` indicates that a set of values specified
by an associated `map-datalist` element will be used in a round-robin fashion for
template variable substitution and submission in map requests. This is useful for
[domain sharding](https://developer.mozilla.org/en-US/docs/Glossary/Domain_sharding),
implemented by OpenStreetMap (for example), to increase parallelism of tile requests
and thereby to improve performance.

When specifying a boolean attribute such as `shard` in MapML,
care must be taken to encode the attribute according to the document / media type in
which the element is being used. In XML documents, boolean attributes must be
encoded as `shard="anything"`, so as to respect XML parsing rules. In the
HTML document, i.e. as inline layer content, the attribute should be encoded per
HTML's [boolean attribute rules](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes#boolean_attributes).

---
### `list`

The `<map-input list="...">` attribute associates a `<map-datalist>` element that
provides the values to be used (via the `<map-datalist>`'s child `<map-option>`
elements). See [shard](#shard) for more details.

---
## Examples

Expand All @@ -195,15 +169,9 @@ elements). See [shard](#shard) for more details.
<layer- label="OpenStreetMap" checked>
<map-extent units="OSMTILE" >
<map-input name="z" type="zoom" value="18" min="0" max="18" step="3"></map-input>
<map-input name="s" type="hidden" shard="true" list="servers"></map-input>
<map-datalist id="servers">
<map-option value="a"></map-option>
<map-option value="b"></map-option>
<map-option value="c"></map-option>
</map-datalist>
<map-input name="x" type="location" units="tilematrix" axis="column" min="0" max="262144" ></map-input>
<map-input name="y" type="location" units="tilematrix" axis="row" min="0" max="262144" ></map-input>
<map-link rel="tile" tref="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png" />
<map-link rel="tile" tref="https://tile.openstreetmap.org/{z}/{x}/{y}.png" />
</map-extent>
</layer->
</mapml-viewer>
Expand Down
8 changes: 1 addition & 7 deletions docs/elements/mapml.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,15 +29,9 @@ must contain one `<map-head>` element, followed by one `<map-body>` element.
<map-body>
<map-extent units="OSMTILE" >
<map-input name="z" type="zoom" value="18" min="0" max="18"></map-input>
<map-input name="s" type="hidden" shard="true" list="servers"></map-input>
<map-datalist id="servers">
<map-option value="a"></map-option>
<map-option value="b"></map-option>
<map-option value="c"></map-option>
</map-datalist>
<map-input name="x" type="location" units="tilematrix" axis="column" min="0" max="262144" ></map-input>
<map-input name="y" type="location" units="tilematrix" axis="row" min="0" max="262144" ></map-input>
<map-link rel="tile" tref="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png" />
<map-link rel="tile" tref="https://tile.openstreetmap.org/{z}/{x}/{y}.png" />
</map-extent>
</map-body>
</mapml->
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 2 additions & 22 deletions i18n/fr/docusaurus-plugin-content-docs/current/elements/input.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Définit le **type** de l’entrée.
| location | L’entrée d’un emplacement capture **une** valeur d’`axis` d’un point à deux dimensions (représenté par une paire de coordonnées) dans l’étendue de la carte – p. exe., l’emplacement `top-right`, ou, lorsqu’il interroge un serveur, celui où l’utilisateur clique ou qu’il touche sur la carte. |
| width | L’entrée de la largeur capture la largeur de l’étendue de la fenêtre d’affichage de la carte en pixels normalisés |
| height | L’entrée de la hauteur capture la hauteur de l’étendue de la fenêtre d’affichage de la carte en pixels normalisés |
| hidden | Cet attribut établit une variable pouvant servir à transmettre un (#shard) fixe ou [un domaine fixe de valeurs] au serveur lorsque l’utilisateur demande des ressources cartographiques. |
| hidden | Cet attribut établit une variable pouvant servir à transmettre un valeur fixe au serveur lorsque l’utilisateur demande des ressources cartographiques. |
---

### `value`
Expand Down Expand Up @@ -107,20 +107,6 @@ Précise l’entité à laquelle s’applique la `position`. Les valeurs possibl
### `step`
Définit la plage de zoom en fonction des ressources qui sont demandées à l’intérieur de cette plage. `step` est toujours calculé à partir d’une valeur de base de 0. Lorsque la valeur du niveau de zoom se situe à l’intérieur de l’intervalle `step`, les ressources sont demandées lorsque nécessaire et mises à l’échelle au niveau de zoom utilisé. Par exemple, si min=0 et que max=7 pour le niveau de zoom entré avec step=4, les pavés ne sont demandés que qu’au niveau de zoom=0 et mis à l’échelle avec les niveaux de zoom 1, 2 et 3 alors que la carte est rendue à ces niveaux. Utiliser cet attribut permet d’économiser la largeur de bande dont profite l’utilisateur et n’introduit qu’un léger effet visuel qui varie avec la nature du contenu.

---
### `shard`

L’attribut booléen `shard` est utilisé avec une variable `hidden`.

`<map-input shard list="datalist-id>` indique que chacune des valeurs précisées dans un élément `map-datalist` connexe sera utilisée à tout de rôle (round robin) pour substituer et soumettre les variables d’un modèle dans les demandes pour obtenir une carte. Cela s’avère utile avec la [fragmentation de domaine](https://developer.mozilla.org/fr/docs/Glossary/Domain_sharding), mise en œuvre (notemment) par OpenStreetMap, pour accroître le parallélisme des demandes de pavés et donc améliorer le rendement.

Lorsque l’utilisateur précise un attribut booléen, comme `shard`, dans MapML, il doit faire attention de le coder en fonction du type de document ou de média dans lequel sert l’élément. Dans le cas d’un document XML, il faut coder l’attribut booléen `shard="anything"` en appliquant les règles d’analyse syntaxique de ce format. S’il s’agit d’un document HTML, c.-à-d. que le contenu de la couche est en ligne, l’utilisateur doit encoder l’attribut en suivant les [règles concernant les attributs booléens](https://developer.mozilla.org/fr/docs/Web/HTML/Attributes#boolean_attributes) du langage HTML.

---
### `list`

L’attribut `<map-input list="...">` associe un élément `<map-datalist>` qui fournit les valeurs à utiliser par l’intermédiaire des éléments `<map-option>` de l’élément-enfant `<map-datalist>`. Voir la section [shard](#shard) pour plus de détails.

---
## Exemples

Expand All @@ -131,15 +117,9 @@ L’attribut `<map-input list="...">` associe un élément `<map-datalist>` qui
<layer- label="OpenStreetMap" checked>
<map-extent units="OSMTILE" >
<map-input name="z" type="zoom" value="18" min="0" max="18" step="3"></map-input>
<map-input name="s" type="hidden" shard="true" list="servers"></map-input>
<map-datalist id="servers">
<map-option value="a"></map-option>
<map-option value="b"></map-option>
<map-option value="c"></map-option>
</map-datalist>
<map-input name="x" type="location" units="tilematrix" axis="column" min="0" max="262144" ></map-input>
<map-input name="y" type="location" units="tilematrix" axis="row" min="0" max="262144" ></map-input>
<map-link rel="tile" tref="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png" />
<map-link rel="tile" tref="https://tile.openstreetmap.org/{z}/{x}/{y}.png" />
</map-extent>
</layer->
</mapml-viewer>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,15 +29,9 @@ il doit contenir un élément `<map-head>`, suivi d’un élément `<map-body>`.
<map-body>
<map-extent units="OSMTILE" >
<map-input name="z" type="zoom" value="18" min="0" max="18"></map-input>
<map-input name="s" type="hidden" shard="true" list="servers"></map-input>
<map-datalist id="servers">
<map-option value="a"></map-option>
<map-option value="b"></map-option>
<map-option value="c"></map-option>
</map-datalist>
<map-input name="x" type="location" units="tilematrix" axis="column" min="0" max="262144" ></map-input>
<map-input name="y" type="location" units="tilematrix" axis="row" min="0" max="262144" ></map-input>
<map-link rel="tile" tref="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png" />
<map-link rel="tile" tref="https://tile.openstreetmap.org/{z}/{x}/{y}.png" />
</map-extent>
</map-body>
</mapml->
Expand Down
1 change: 0 additions & 1 deletion sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@ module.exports = {
'elements/mapml',
'elements/extent',
'elements/input',
'elements/datalist',
'elements/select',
'elements/link',
'elements/meta',
Expand Down
8 changes: 1 addition & 7 deletions static/demo/data/osm.mapml
Original file line number Diff line number Diff line change
Expand Up @@ -8,15 +8,9 @@
<map-body>
<map-extent units="OSMTILE" >
<map-input name="z" type="zoom" value="18" min="0" max="18"></map-input>
<map-input name="s" type="hidden" shard="true" list="servers"></map-input>
<map-datalist id="servers">
<map-option value="a"></map-option>
<map-option value="b"></map-option>
<map-option value="c"></map-option>
</map-datalist>
<map-input name="x" type="location" units="tilematrix" axis="column" min="0" max="262144" ></map-input>
<map-input name="y" type="location" units="tilematrix" axis="row" min="0" max="262144" ></map-input>
<map-link rel="tile" tref="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png" />
<map-link rel="tile" tref="https://tile.openstreetmap.org/{z}/{x}/{y}.png" />
</map-extent>
</map-body>
</mapml->
8 changes: 1 addition & 7 deletions static/demo/map-datalist-demo/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -35,15 +35,9 @@ <h2>MapML Demo: &lt;map-datalist&gt;</h2>
<layer- label="OpenStreetMap" checked>
<map-extent units="OSMTILE" >
<map-input name="z" type="zoom" value="18" min="0" max="18" step="1"></map-input>
<map-input name="s" type="hidden" shard="true" list="servers"></map-input>
<map-datalist id="servers">
<map-option value="a"></map-option>
<map-option value="b"></map-option>
<map-option value="c"></map-option>
</map-datalist>
<map-input name="x" type="location" units="tilematrix" axis="column" min="0" max="262144" ></map-input>
<map-input name="y" type="location" units="tilematrix" axis="row" min="0" max="262144" ></map-input>
<map-link rel="tile" tref="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png" />
<map-link rel="tile" tref="https://tile.openstreetmap.org/{z}/{x}/{y}.png" />
</map-extent>
</layer->
</mapml-viewer>
Expand Down