Update extent, layer, editors.

Author: prushfor

spec/index.html

@@ -22,9 +22,6 @@
           {
             name: "Peter Rushforth",
             company: "Natural Resources Canada"
-          },
-          {
-            name: "Robert Linder"
           }
         ],
         authors: [
@@ -341,7 +338,7 @@ <h3>Changes</h3>
               <li><time>2023-06-08</time>: Add initial draft WebIDL for <code>geojson2mapml</code>(). Add prose for <code>back</code>, <code>forward</code>, <code>reload</code>.
               <li><time>2023-06-12</time>: Add <code>HTMLGeometryChildElement</code> abstract interface
               <li><time>2023-06-29</time>: Update Authoring section. Include definitions of local and remote content.
-              <li><time>2023-11-05</time>: Correct error in contexts in which <code>map-extent</code> is found. Add opacity attribute to layer.  
+              <li><time>2023-11-05</time>: Correct error in contexts in which <code>map-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>.
             </ol>
           </details>
         </section>
@@ -923,6 +920,7 @@ <h4>The <code>&lt;<dfn id="the-layer-element">layer</dfn>&gt;</code> element</h4
                      attribute boolean <a href="#attr-layer-checked">checked</a>;
             readonly attribute boolean <a href="#attr-layer-disabled">disabled</a>;
                      attribute boolean <a href="#attr-layer-hidden">hidden</a>;
+                     attribute double <a href="attr-layer-opacity">opacity</a>;
                      attribute DOMString <a href="#attr-layer-referrerpolicy">referrerPolicy</a>;
                      attribute DOMString? <a href="#attr-layer-crossorigin">crossOrigin</a>;
                                undefined zoomTo();
@@ -937,7 +935,7 @@ <h4>The <code>&lt;<dfn id="the-layer-element">layer</dfn>&gt;</code> element</h4
         </dd>
         </dl>
         <p>The <a href="#the-mapml-viewer-element"><code>mapml-viewer</code></a> element displays its child <a href="#the-layer-element"><code>layer</code></a> elements similarly to (partially) transparent "acetate" layers on a (paper) map.  The layers follow the <a href="https://www.w3.org/TR/SVG/render.html#PaintersModel">painters model</a>, whereby
-        <a href="#the-layer-element"><code>layer</code></a> elements are displayed on top of earlier siblings according to their document order.  <a href="#the-layer-element"><code>layer</code></a> transparency is controlled by the CSS opacity property. [[SVG2]] [[css-color-3]]</p>
+          <a href="#the-layer-element"><code>layer</code></a> elements are displayed on top of previous siblings according to their document order.  <a href="#the-layer-element"><code>layer</code></a> transparency is controlled by the <a href="attr-layer-opacity">opacity</a> attribute.</p>
 
         <p>In contrast to the <a href="https://html.spec.whatwg.org/multipage/media.html#media-element">HTML media elements' <code>source</code></a> child element where a single 
         <a href="https://html.spec.whatwg.org/multipage/media.html#media-element"><code>source</code></a> element is selected by the user agent for play, the <a href="#the-mapml-viewer-element"><code>mapml-viewer</code></a> element's child <a href="#the-layer-element"><code>layer</code></a> elements are 
@@ -2167,7 +2165,7 @@ <h5>The <code>&lt;<dfn id="the-extent-element">extent</dfn>&gt;</code> element</
 
           <dt><a href="https://html.spec.whatwg.org/multipage/dom.html#concept-element-attributes">Content attributes</a>:</dt>
           <dd id="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 <a href="#the-input-element"><code>input</code></a> elements.</dd>
-          <dd id="attr-extent-label"><code>label</code> — A text label to be applied to the user interface for the <a href="#the-extent-element"><code>extent</code></a> in the layer control. If no label is supplied, a default value will be generated for non-hidden extents, with the intended meaning of "Sub-layer".</dd>
+          <dd id="attr-extent-label"><code>label</code> — A text label to be applied to the user interface for the <a href="#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>
           <dd id="attr-extent-opacity"><code>opacity</code> — An initial opacity value, that will be applied to the content retrieved by the <a href="#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>
           <dd id="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 <a href="#the-extent-element"><code>extent</code></a> content is rendered on the map.</dd>
           <dd id="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>
@@ -2211,18 +2209,27 @@ <h5>The <code>&lt;<dfn id="the-extent-element">extent</dfn>&gt;</code> element</
             interface HTMLExtentElement : HTMLElement {
               [HTMLConstructor] constructor();
 
-              attribute DOMString units;
-              readonly attribute long length;
-              getter Element (unsigned long index);
-              getter (RadioNodeList or Element) (DOMString name);
-            };
+                     attribute DOMString <a href="#attr-extent-units">units</a>;
+                     attribute DOMString <a href="#attr-extent-label">label</a>;
+                     attribute boolean <a href="#attr-extent-checked">checked</a>;
+            readonly attribute boolean <a href="#attr-extent-disabled">disabled</a>;
+                     attribute boolean <a href="#attr-extent-hidden">hidden</a>;
+                     attribute double <a href="attr-extent-opacity">opacity</a>;            };
             </pre>
           </dd>
         </dl>
         <p>
-          The <a href="#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. 
+          The <a href="#the-extent-element"><code>extent</code></a> element is a map-associated affordance, which contains <a href="#the-input-element"><code>input</code></a> and <a href="#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.
         </p>
         <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>
+        
+        <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>
+        
+        <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>
+        
+        <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>
+        
+        <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>
 
         </section>
         <section>