You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Add Contributors section, remove authors.
Add `checked` to examples of local and
remote content. Update extent content model
to allow `map-meta` description of zoom and
spatial bounds.
<li><time>2023-06-29</time>: Update Authoring section. Include definitions of local and remote content.
329
+
<li><time>2023-11-05</time>: Correct error in contexts in which <code>extent</code> is found. Add opacity attribute to layer. Update editors. Add WebIDL for <code>layer</code><code>opacity</code>; Add or update <code>extent</code> attributes for <code>label</code>, <code>checked</code>, <code>hidden</code>, <code>opacity</code> and <code>disabled</code>. Update <code>extent</code> content model to add allowed metadata content for <code>zoom</code> and <code>extent</code>.
if the layer is not not <ahref="#attr-layer-hidden"><code>hidden</code></a>. The map author's <ahref="#the-title-element"><code>title</code></a> element takes precedence over <code>label</code>, if available.</dd>
874
860
<ddid="attr-layer-checked"><code>checked</code> — Turn the layer on/off dynamically on the map. </dd>
875
861
<ddid="attr-layer-hidden"><code>hidden</code> — Visibility status of the layer in the layer control. Does not affect visibility of the layer on the map.</dd>
862
+
<ddid="attr-layer-opacity"><code>opacity</code> — An initial opacity value which is reflected to the exposed user interface in the layer control for opacity. Opacity values have a decimal range from 0 (transparent) to 1.0 (opaque)</dd>
876
863
<ddid="attr-layer-referrerpolicy"><code>referrerpolicy</code> — <ahref="https://w3c.github.io/webappsec-referrer-policy/#referrer-policy">Referrer policy</a> for <ahref="https://fetch.spec.whatwg.org/#concept-fetch">fetches</a> initiated by the element.</dd>
877
864
<ddid="attr-layer-crossorigin"><code>crossorigin</code> — A <ahref="https://html.spec.whatwg.org/multipage/urls-and-fetching.html#cors-settings-attribute">CORS settings attribute</a>, specifies how the element handles crossorigin requests.</dd>
878
865
<dt><ahref="https://html.spec.whatwg.org/multipage/dom.html#concept-element-tag-omission">Tag omission in text/html</a>:</dt>
<p>The <ahref="#the-mapml-viewer-element"><code>mapml-viewer</code></a> element displays its child <ahref="#the-layer-element"><code>layer</code></a> elements similarly to (partially) transparent "acetate" layers on a (paper) map. The layers follow the <ahref="https://www.w3.org/TR/SVG/render.html#PaintersModel">painters model</a>, whereby
938
-
<ahref="#the-layer-element"><code>layer</code></a> elements are displayed on top of earlier siblings according to their document order. <ahref="#the-layer-element"><code>layer</code></a> transparency is controlled by the CSS opacity property. [[SVG2]] [[css-color-3]]</p>
926
+
<ahref="#the-layer-element"><code>layer</code></a> elements are displayed on top of previous siblings according to their document order. <ahref="#the-layer-element"><code>layer</code></a> transparency is controlled by the <ahref="attr-layer-opacity">opacity</a> attribute.</p>
939
927
940
928
<p>In contrast to the <ahref="https://html.spec.whatwg.org/multipage/media.html#media-element">HTML media elements' <code>source</code></a> child element where a single
941
929
<ahref="https://html.spec.whatwg.org/multipage/media.html#media-element"><code>source</code></a> element is selected by the user agent for play, the <ahref="#the-mapml-viewer-element"><code>mapml-viewer</code></a> element's child <ahref="#the-layer-element"><code>layer</code></a> elements are
@@ -1120,7 +1108,7 @@ <h4>Local content</h4>
1120
1108
<map-caption>Paris, the City of Lights</map-caption>
A set of multiple <ahref="#the-input-element"><code>input</code></a> and one or more <ahref="#the-link-element"><code>link</code></a> elements with their <code>rel</code> attribute in either the "<ahref="#link-rel-tile"><code>tile</code></a>", "<ahref="#link-rel-image"><code>image</code></a>" or "<ahref="#link-rel-features"><code>features</code></a>" state, and zero or one
2163
-
<ahref="#the-link-element"><code>link</code></a> element with its <code>rel</code> attribute in the "<ahref="#link-rel-query"><code>query</code></a>" state.
2151
+
<ahref="#the-link-element"><code>link</code></a> element with its <code>rel</code> attribute in the "<ahref="#link-rel-query"><code>query</code></a>" state. Optional metadata content describing server-side <code>extent</code> content, in the form of zero or more <ahref="#the-meta-element"><code>meta</code></a> elements with <ahref="#attr-meta-name"><code>name</code></a> attribute in the <code>zoom</code> or <code>extent</code> state.
<dd><code>units</code> — The name of the coordinate reference system whose measurement units are to be used by values supplied by child <ahref="#the-input-element"><code>input</code></a> elements.</dd>
2168
-
<dd><code>label</code> — A text label to be applied to the user interface for the <ahref="#the-extent-element"><code>extent</code></a> in the layer control. If no label is supplied, the <ahref="#the-extent-element"><code>extent</code></a> will not expose a user interface in the layer control, but will still be displayed on the map.</dd>
2169
-
<dd><code>opacity</code> — An initial opacity value, that will be applied to the content retrieved by the <ahref="#the-extent-element"><code>extent</code></a>, and which is reflected to the exposed user interface for opacity. Opacity values have a decimal range from 0 (transparent) to 1.0 (opaque).</dd>
2170
-
<dd><code>checked</code> — A boolean attribute that sets the initial state of the exposed user interface in the layer control. If checked, the <ahref="#the-extent-element"><code>extent</code></a> content is displayed on the map.</dd>
2155
+
<ddid="attr-extent-units"><code>units</code> — The name of the coordinate reference system whose measurement units are to be used by values supplied by child <ahref="#the-input-element"><code>input</code></a> elements.</dd>
2156
+
<ddid="attr-extent-label"><code>label</code> — A text label to be applied to the user interface for the <ahref="#the-extent-element"><code>extent</code></a> in the layer control. If no <code>label</code> content attribute is supplied, a default internationalized string value will be generated and rendered for non-hidden extents.</dd>
2157
+
<ddid="attr-extent-opacity"><code>opacity</code> — An initial opacity value, that will be applied to the content retrieved by the <ahref="#the-extent-element"><code>extent</code></a>, and which is reflected to the exposed layer control user interface for opacity. Opacity values have a decimal range from 0 (transparent) to 1.0 (opaque).</dd>
2158
+
<ddid="attr-extent-checked"><code>checked</code> — A boolean attribute that sets the initial state of the exposed user interface in the layer control. If checked, the <ahref="#the-extent-element"><code>extent</code></a> content is rendered on the map.</dd>
2159
+
<ddid="attr-extent-hidden"><code>hidden</code> — Visibility status of the extent in the layer control. Does not affect visibility of the extent on the map.</dd>
The <ahref="#the-extent-element"><code>extent</code></a> element is a map-associated affordance, which contains input and link elements, whose job it is to serialize location event properties that can be submitted to a server for processing.
2210
+
The <ahref="#the-extent-element"><code>extent</code></a> element is a map-associated affordance, which contains <ahref="#the-input-element"><code>input</code></a> and <ahref="#the-link-element"><code>link</code></a> elements, whose job it is to serialize location event properties that can be submitted to a server for processing. Returned content is rendered on the map in the DOM sequence order of the <code>extent</code> child element among its siblings in the parent element. The <code>extent</code>'s content rendered transparency is controlled by the <code>opacity</code> attribute.
2221
2211
</p>
2222
2212
<p>The <code>units</code> attribute indicates the parent TCRS that location events shall be generated for, and serialized as requested by the <code>extent</code>'s contents.</p>
2213
+
2214
+
<p>The <code>label</code> IDL attribute reflects the content attribute, if present. If no content attribute is present, the IDL attribute returns an internationalized string for 'Sub-layer'.</p>
2215
+
2216
+
<p>The display state (on / off) of the content represented by the <code>extent</code> element is controlled by the <code>checked</code> boolean attribute. If <code>checked</code> is true, the <code>extent</code> is rendered on the map; if not <code>checked</code> the <code>extent</code> is not rendered but should remain visible in the <code>mapml-viewer</code> element's representation of controls, in an un-checked state.</p>
2217
+
2218
+
<p>The <code>hidden</code> boolean attribute can be set to remove the <code>extent</code> from the map layer control, but it will remain displayed on the map. In order to remove the <code>extent</code> content from the map, it can have its <code>checked</code> property toggled, or the element can be removed from the DOM.</p>
2219
+
2220
+
<p>The <code>disabled</code> IDL attribute is a read-only boolean representation of the visibility of the <code>extent</code> contents on the map. If the <code>extent</code> is not visible due to errors, including projection, zoom or bounds mismatch, the <code>disabled</code> IDL attribute will return true. If the <code>extent</code> is present in the layer control (i.e. <code>hidden</code> is false), its <code>checked</code> state will be disabled until the error condition is corrected, for example by zooming to the <code>extent</code>'s bounds.</p>
0 commit comments