Create media-attribute branch for media attribute docs

Author: prushfor

docs/api/layer-api.md

@@ -124,6 +124,10 @@ To get the `<map-layer>`'s opacity value:
 let layer = document.querySelector('map-layer');
 let opacity = layer.opacity;
 ```
+---
+### media
+
+Reflects the [media](../elements/layer#media) attribute of the `<layer->` element.
 
 ### extent
 

docs/api/map-link-api.md

@@ -4,6 +4,21 @@ title: HTMLLinkElement
 slug: /api/map-link-api
 ---
 
+# HTMLLinkElement
+
+The `<map-link>` element is intended to implement an extension of the HTML `<link>` 
+element and `HTMLLinkElement` API. This document reflects proposed changes to that
+API and is a work in progress.
+
+
+## Properties
+
+### media
+
+Reflects the [media](../elements/link#media) attribute of the `<map-link>` element.
+
+---
+
 This document is copied from the old "Custom Rendering API" page, and is under
 construction.  It will eventually describe the API of the map-link custom element;
 the "Custom Rendering API" is currently sourced from the map-link custom element,

docs/api/mapml-viewer-api.mdx

@@ -649,7 +649,6 @@ let output = map.geojson2mapml(json);
 </html>
 ```
 
-
 ---
 
 ## Specifications

docs/elements/layer.md

@@ -63,6 +63,21 @@ and the fetched `<map-title>` element is used.
 
 ---
 
+### `media`
+
+The `media` attribute is used to express media conditions under which the layer 
+content should be used / loaded from `src`.  Media conditions evaluate to `true` or `false`.  
+A layer for which the media condition evaluates to `false` is by default hidden.  
+A layer for which the media condition evaluates to `true` is added to the map 
+according to its `checked` attribute, and is added to the layer control according
+to its `hidden` attribute.
+
+Map media queries can include extended CSS map properties including:    
+[projection](../../api/mapml-viewer-api#projection), [zoom](../../api/mapml-viewer-api#zoom), 
+and [extent](../../api/mapml-viewer-api#extent).
+
+---
+
 ### `opacity`
 
 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>`.
 ---
 
 > - [Edit this page on **Github**](https://github.com/Maps4HTML/web-map-doc/edit/main/docs/elements/layer.md)
-> - [Chat with us on **Gitter**](https://gitter.im/Maps4HTML/chat)
+> - [Chat with us on **Gitter**](https://gitter.im/Maps4HTML/chat)

docs/elements/link.md

@@ -130,6 +130,20 @@ Projection values [defined by the polyfill](../mapml-viewer#projection) include:
 | Permitted ARIA roles | No roles permitted. |
 | DOM Interface    | [HTMLLinkElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLLinkElement) |
 
+---
+### `media`
+
+The `media` attribute is used to express media conditions under which the linked 
+content should be loaded from its `href` attribute.  Media conditions evaluate to `true` or `false`.  
+A map-link for which the media condition evaluates to `false` is not loaded / unloaded.  
+Content linked via a map-link for which the media condition evaluates to `true` 
+is loaded from its `href` attribute; when the condition subsequently evaluates to
+`false`, the content is unloaded.
+
+Map media queries can include extended CSS map properties including:    
+[projection](../../api/mapml-viewer-api#projection), [zoom](../../api/mapml-viewer-api#zoom), 
+and [extent](../../api/mapml-viewer-api#extent).
+
 ---
 
 ## Examples

docs/elements/style.md

@@ -6,6 +6,22 @@ slug: /elements/style/
 
 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.
 
+## Attributes
+
+### `media`
+
+The `media` attribute is used to express media conditions under which the contained 
+styles should be applied.  Media conditions evaluate to `true` or `false`.  A map-style 
+for which the media condition evaluates to `false` is not loaded / removed.  Styles 
+contained in a `<map-style>` for which the media condition evaluates to `true` 
+are applied; when the condition subsequently evaluates to `false`, the styles are removed.
+
+Map media queries can include extended CSS map properties including:    
+[projection](../../api/mapml-viewer-api#projection), [zoom](../../api/mapml-viewer-api#zoom), 
+and [extent](../../api/mapml-viewer-api#extent).
+
+---
+
 :::note
 
 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

@@ -107,6 +107,11 @@ let layer = document.querySelector('map-layer');
 let opacity = layer.opacity;
 ```
 
+---
+### media
+
+Reflète l'attribut [media](../elements/layer#media) de l'élément `<map-layer>`.
+
 ### extent
 
 `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

@@ -4,6 +4,20 @@ title: HTMLLinkElement
 slug: /api/map-link-api
 ---
 
+# HTMLLinkElement
+
+L'élément `<map-link>` est conçu pour implémenter une extension de l'élément HTML `<link>` 
+et de l'API `HTMLLinkElement`. Ce document reflète les modifications proposées à cette
+API et est en cours de développement.
+
+## Propriétés
+
+### media
+
+Reflète l'attribut [media](../elements/link#media) de l'élément `<map-link>`.
+
+---
+
 Ce document est une copie de l'ancienne page "Custom Rendering API", et est 
 en cours de construction.  Il décrira à terme l'API de l'élément personnalisé map-link ;
 l'"API de rendu personnalisé" provient actuellement de l'élément personnalisé map-link,

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

@@ -51,6 +51,14 @@ Le contenu en ligne utilise l’attribut  `label` comme étiquette de texte affi
 
 ---
 
+### `media`
+
+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`.
+
+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).
+
+---
+
 ### `opacity`
 
 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

@@ -109,6 +109,14 @@ Les valeurs de projection [définies par le polyfill](../mapml-viewer#projection
 
 ---
 
+### `media`
+
+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é.
+
+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).
+
+---
+
 ## Exemples
 
 ### Tile Mapping Specification (tms)

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

@@ -6,6 +6,17 @@ slug: /elements/style/
 
 L’élément `<map-style>` permet aux auteurs de cartes d’intégrer une feuille de style en cascade (CSS) dans les couches de carte. La CSS peut être utilisée pour styliser la géométrie de la couche à l’aide de [`<map-span>`](../../elements/span/), ainsi qu’en réglant l’attribut « class » d’après les [éléments enfants](../geometry/#éléments-enfants) de la géométrie.
 
+## Attributs
+
+### `media`
+
+L'attribut `media` est utilisé pour exprimer les conditions média dans lesquelles les styles contenus doivent être appliqués.  
+Les conditions média s'évaluent à `true` ou `false`.  Un map-style pour lequel la condition média s'évalue à `false` n'est pas chargé / est supprimé.  Les styles contenus dans un `<map-style>` pour lequel la condition média s'évalue à `true` sont appliqués ; lorsque la condition s'évalue ensuite à `false`, les styles sont supprimés.
+
+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).
+
+---
+
 :::note
 
 Toutes les démonstrations comprises dans les pages de documentation contiennent un onglet « CSS », qui permet d’ajouter une CSS en utilisant l’élément `<map-style>` de manière dynamique.