Skip to content

Commit 1ab98e5

Browse files
prushforprushfor
prushfor
authored and
prushfor
committed
Create media-attribute branch for media attribute docs
1 parent 21e70ac commit 1ab98e5

File tree

11 files changed

+111
-2
lines changed

11 files changed

+111
-2
lines changed

‎docs/api/layer-api.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -124,6 +124,10 @@ To get the `<map-layer>`'s opacity value:
124124
let layer = document.querySelector('map-layer');
125125
let opacity = layer.opacity;
126126
```
127+
---
128+
### media
129+
130+
Reflects the [media](../elements/layer#media) attribute of the `<layer->` element.
127131

128132
### extent
129133

‎docs/api/map-link-api.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,21 @@ title: HTMLLinkElement
44
slug: /api/map-link-api
55
---
66

7+
# HTMLLinkElement
8+
9+
The `<map-link>` element is intended to implement an extension of the HTML `<link>`
10+
element and `HTMLLinkElement` API. This document reflects proposed changes to that
11+
API and is a work in progress.
12+
13+
14+
## Properties
15+
16+
### media
17+
18+
Reflects the [media](../elements/link#media) attribute of the `<map-link>` element.
19+
20+
---
21+
722
This document is copied from the old "Custom Rendering API" page, and is under
823
construction. It will eventually describe the API of the map-link custom element;
924
the "Custom Rendering API" is currently sourced from the map-link custom element,

‎docs/api/mapml-viewer-api.mdx‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -649,7 +649,6 @@ let output = map.geojson2mapml(json);
649649
</html>
650650
```
651651

652-
653652
---
654653

655654
## Specifications

‎docs/elements/layer.md‎

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,21 @@ and the fetched `<map-title>` element is used.
6363

6464
---
6565

66+
### `media`
67+
68+
The `media` attribute is used to express media conditions under which the layer
69+
content should be used / loaded from `src`. Media conditions evaluate to `true` or `false`.
70+
A layer for which the media condition evaluates to `false` is by default hidden.
71+
A layer for which the media condition evaluates to `true` is added to the map
72+
according to its `checked` attribute, and is added to the layer control according
73+
to its `hidden` attribute.
74+
75+
Map media queries can include extended CSS map properties including:
76+
[projection](../../api/mapml-viewer-api#projection), [zoom](../../api/mapml-viewer-api#zoom),
77+
and [extent](../../api/mapml-viewer-api#extent).
78+
79+
---
80+
6681
### `opacity`
6782

6883
The `opacity` attribute is used to set the initial opacity of the `<map-layer>` element.
@@ -113,4 +128,4 @@ The following example sets the initial `opacity` for a `<map-layer>`.
113128
---
114129

115130
> - [Edit this page on **Github**](https://github.com/Maps4HTML/web-map-doc/edit/main/docs/elements/layer.md)
116-
> - [Chat with us on **Gitter**](https://gitter.im/Maps4HTML/chat)
131+
> - [Chat with us on **Gitter**](https://gitter.im/Maps4HTML/chat)

‎docs/elements/link.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -130,6 +130,20 @@ Projection values [defined by the polyfill](../mapml-viewer#projection) include:
130130
| Permitted ARIA roles | No roles permitted. |
131131
| DOM Interface | [HTMLLinkElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLinkElement) |
132132

133+
---
134+
### `media`
135+
136+
The `media` attribute is used to express media conditions under which the linked
137+
content should be loaded from its `href` attribute. Media conditions evaluate to `true` or `false`.
138+
A map-link for which the media condition evaluates to `false` is not loaded / unloaded.
139+
Content linked via a map-link for which the media condition evaluates to `true`
140+
is loaded from its `href` attribute; when the condition subsequently evaluates to
141+
`false`, the content is unloaded.
142+
143+
Map media queries can include extended CSS map properties including:
144+
[projection](../../api/mapml-viewer-api#projection), [zoom](../../api/mapml-viewer-api#zoom),
145+
and [extent](../../api/mapml-viewer-api#extent).
146+
133147
---
134148

135149
## Examples

‎docs/elements/style.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,22 @@ slug: /elements/style/
66

77
The `<map-style>` element allows map authors to embed CSS into map layers. The CSS can be used to style the geometry of the layer using [`<map-span>`](../../elements/span/), and by setting the class attribute to the [child elements](../geometry/#child-elements) of the geometry.
88

9+
## Attributes
10+
11+
### `media`
12+
13+
The `media` attribute is used to express media conditions under which the contained
14+
styles should be applied. Media conditions evaluate to `true` or `false`. A map-style
15+
for which the media condition evaluates to `false` is not loaded / removed. Styles
16+
contained in a `<map-style>` for which the media condition evaluates to `true`
17+
are applied; when the condition subsequently evaluates to `false`, the styles are removed.
18+
19+
Map media queries can include extended CSS map properties including:
20+
[projection](../../api/mapml-viewer-api#projection), [zoom](../../api/mapml-viewer-api#zoom),
21+
and [extent](../../api/mapml-viewer-api#extent).
22+
23+
---
24+
925
:::note
1026

1127
All the Demo's on the documentation pages contain a "CSS" tab which adds the CSS using the `<map-style>` element dynamically.

‎i18n/fr/docusaurus-plugin-content-docs/current/api/layer-api.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,11 @@ let layer = document.querySelector('map-layer');
107107
let opacity = layer.opacity;
108108
```
109109

110+
---
111+
### media
112+
113+
Reflète l'attribut [media](../elements/layer#media) de l'élément `<map-layer>`.
114+
110115
### extent
111116

112117
`HTMLLayerElement.extent` fournit un accès en LECTURE SEULE aux coordonnées en

‎i18n/fr/docusaurus-plugin-content-docs/current/api/map-link-api.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,20 @@ title: HTMLLinkElement
44
slug: /api/map-link-api
55
---
66

7+
# HTMLLinkElement
8+
9+
L'élément `<map-link>` est conçu pour implémenter une extension de l'élément HTML `<link>`
10+
et de l'API `HTMLLinkElement`. Ce document reflète les modifications proposées à cette
11+
API et est en cours de développement.
12+
13+
## Propriétés
14+
15+
### media
16+
17+
Reflète l'attribut [media](../elements/link#media) de l'élément `<map-link>`.
18+
19+
---
20+
721
Ce document est une copie de l'ancienne page "Custom Rendering API", et est
822
en cours de construction. Il décrira à terme l'API de l'élément personnalisé map-link ;
923
l'"API de rendu personnalisé" provient actuellement de l'élément personnalisé map-link,

‎i18n/fr/docusaurus-plugin-content-docs/current/elements/layer.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,14 @@ Le contenu en ligne utilise l’attribut `label` comme étiquette de texte affi
5151

5252
---
5353

54+
### `media`
55+
56+
L'attribut `media` est utilisé pour exprimer les conditions média dans lesquelles le contenu de la couche doit être utilisé / chargé depuis `src`. Les conditions média s'évaluent à `true` ou `false`. Une couche pour laquelle la condition média s'évalue à `false` est, par défaut, masquée. Une couche pour laquelle la condition média s'évalue à `true` est ajoutée à la carte en fonction de son attribut `checked`, et est ajoutée au contrôle des couches en fonction de son attribut `hidden`.
57+
58+
Les requêtes média pour la carte peuvent inclure des propriétés CSS de carte étendues, notamment : [projection](../../api/mapml-viewer-api#projection), [zoom](../../api/mapml-viewer-api#zoom), et [extent](../../api/mapml-viewer-api#extent).
59+
60+
---
61+
5462
### `opacity`
5563

5664
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

‎i18n/fr/docusaurus-plugin-content-docs/current/elements/link.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,14 @@ Les valeurs de projection [définies par le polyfill](../mapml-viewer#projection
109109

110110
---
111111

112+
### `media`
113+
114+
L'attribut `media` est utilisé pour exprimer les conditions média dans lesquelles le contenu lié doit être chargé depuis son attribut `href`. Les conditions média s'évaluent à `true` ou `false`. Un map-link pour lequel la condition média s'évalue à `false` n'est pas chargé / est déchargé. Le contenu lié via un map-link pour lequel la condition média s'évalue à `true` est chargé depuis son attribut `href` ; lorsque la condition s'évalue ensuite à `false`, le contenu est déchargé.
115+
116+
Les requêtes média pour la carte peuvent inclure des propriétés CSS de carte étendues, notamment : [projection](../../api/mapml-viewer-api#projection), [zoom](../../api/mapml-viewer-api#zoom), et [extent](../../api/mapml-viewer-api#extent).
117+
118+
---
119+
112120
## Exemples
113121

114122
### Tile Mapping Specification (tms)

0 commit comments

Comments
 (0)