diff --git a/spec/index.html b/spec/index.html index b74740f..82c4d28 100644 --- a/spec/index.html +++ b/spec/index.html @@ -43,7 +43,10 @@ edDraftURI: "https://maps4html.org/MapML/spec/", copyrightStart: "2015", github: "https://github.com/Maps4HTML/MapML/", - xref: "web-platform", + xref: { + specs: ["cssom-1"], + profile: "web-platform", + }, pluralize: true, localBiblio: { "Web-Map-Custom-Element": { @@ -186,6 +189,9 @@ :root dl.def dd + dt { margin-top: 0.75em; } + :root .toc > li li li li { + font-size: inherit; + } :root code, :root .hljs-deletion, :root .hljs-name, @@ -363,6 +369,7 @@

Changes

  • : Remove HTMLExtentControlsCollection attribute, per #212
  • : Remove undefined and unresolved LinkStyle interface reference, per #212
  • : Remove legendLinks attribute and interface definition and reference, per #212
    • +
  • : Add/update element categories: Metadata content, Extent content, Feature content. (#230)
    • @@ -703,9 +710,14 @@

    The <layer> element

    Contexts in which this element can be used:
    As a child of the map element.
    Content model:
    -
    If the src attribute is present: Nothing. - If no src attribute is present: - Metadata content describing nested Map Markup Language content.
    +
    If the src attribute is present: Nothing.
    +
    + If no src attribute is present: + Metadata content, + optional extent element, + optional feature element, + optional tile element. +
    Content attributes:
    Global attributes.
    src — Address of the resource.
    @@ -1513,7 +1525,7 @@
    The <head> element
    Contexts in which this element can be used:
    As the first child element of the mapml element.
    Content model:
    -
    One or more elements of metadata content, of which exactly one is a title element and no more than one is a base element.
    +
    One or more elements of Metadata content, of which exactly one is a title element and no more than one is a base element.
    Content attributes:
    Global attributes.
    Accessibility considerations:
    @@ -1563,11 +1575,29 @@
    The <head> element
    and zero or more meta elements.

    +
    +

    Metadata content

    +
    +
    Elements categorized as metadata content:
    +
    + title, + base, + meta, + link, + style. +
    +
    + Elements from other namespaces whose semantics are primarily + metadata-related (e.g. RDF) are also + metadata content. +
    +
    +
    The <title> element
    Categories:
    -
    Metadata content.
    +
    Metadata content.
    Contexts in which this element can be used:
    As a child of the head element.
    Content model:
    @@ -1625,7 +1655,7 @@
    The <title> element
    The <base> element
    Categories:
    -
    Metadata content.
    +
    Metadata content.
    Contexts in which this element can be used:
    As a child element of the head element.
    Content model:
    @@ -1684,7 +1714,7 @@
    The <base> element
    The <meta> element
    Categories:
    -
    Metadata content.
    +
    Metadata content.
    Contexts in which this element can be used:
    In the head element.
    Content model:
    @@ -1744,7 +1774,7 @@
    The <meta> element
    The <link> element
    Categories:
    -
    Metadata content.
    +
    Metadata content.
    Contexts in which this element can be used:
    If the element represents a hyperlink (has a href attribute): as a child of the head or body element.
    If the element represents a link template (has a tref attribute): as a child of the extent element.
    @@ -1924,6 +1954,39 @@

    @rel values

    +
    The <style> element
    +
    +
    Categories:
    +
    Metadata content.
    +
    Contexts in which this element can be used:
    +
    Where Metadata content is expected.
    +
    Content model:
    +
    Text that gives a conformant style sheet.
    +
    Content attributes:
    +
    Global attributes.
    +
    media — Applicable media.
    +
    Also, the title attribute has special semantics on this element: CSS style sheet set name.
    +
    Accessibility considerations:
    +
    For authors.
    +
    For implementers.
    +
    DOM interface:
    +
    + 
    +            [Exposed=Window]
+            interface HTMLStyleElement : HTMLElement {
+              [HTMLConstructor] constructor();
+            
+              [CEReactions] attribute DOMString media;
+            
+              // also has obsolete members
+            };
+            HTMLStyleElement includes LinkStyle;
+
    +
    +
    +
    +
    +
    The <body> element
    Categories:
    @@ -1931,7 +1994,12 @@
    The <body> element
    Contexts in which this element can be used:
    As the second child of the mapml element.
    Content model:
    -
    Features and metadata.
    +
    + Metadata content, + optional extent element, + optional feature element, + optional tile element. +
    Content attributes:
    Global attributes.
    Accessibility considerations:
    @@ -1978,14 +2046,16 @@
    The <body> element

    The body element represents the content of the document.

    +
    The <extent> element
    Categories:
    -
    Metadata content.
    +
    None.
    Contexts in which this element can be used:
    Required to be a child of the body element.
    Content model:
    +
    Extent content.
    A set of multiple input and one or more link elements with their rel attribute in either the "tile", "image" or "features" state, and zero or one link element with its rel attribute in the "query" state. @@ -2045,13 +2115,26 @@
    The <extent> elementextent 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 units attribute indicates the parent TCRS that location events shall be generated for, and serialized as requested by the extent's contents.

    -
    + +
    +

    Extent content

    +
    +
    Elements categorized as extent content:
    +
    + input, + datalist, + label, + select, + option. +
    +
    +
    The <input> element
    Categories:
    -
    N/A.
    +
    Extent content.
    Contexts in which this element can be used:
    Required to be a child of the extent element.
    Content model:
    @@ -2388,7 +2471,7 @@

    input@axis values

    The <datalist> element
    Categories:
    -
    N/A.
    +
    Extent content.
    Contexts in which this element can be used:
    As a child of the extent element, associated to an input element via that element's list attribute. @@ -2449,7 +2532,7 @@
    The <datalist> eleme
    The <label> element
    Categories:
    -
    N/A.
    +
    Extent content.
    Contexts in which this element can be used:
    As a child of the extent element. @@ -2508,7 +2591,7 @@
    The <label> element
    The <select> element
    Categories:
    -
    N/A.
    +
    Extent content.
    Contexts in which this element can be used:
    As a child of the extent element. @@ -2571,7 +2654,7 @@
    The <select> elementThe <option> element
    Categories:
    -
    N/A.
    +
    Extent content.
    Contexts in which this element can be used:
    As a child of the select element or the datalist element. @@ -2628,152 +2711,17 @@
    The <option> element
    -
    -
    The <tile> element
    -
    -
    Categories:
    -
    Feature data.
    -
    Contexts in which this element can be used:
    -
    Child of the body element.
    -
    Content model:
    -
    Nothing.
    -
    Content attributes:
    -
    row — An integer (a Y axis value / the tile size) in the range of the tile coordinate reference system.
    -
    col — An integer (a X axis value / the tile size) in the domain of the tile coordinate reference system.
    -
    src — A URL from which the tile may be obtained.
    -
    type — A hint about the MIME type of the resource obtainable at the src URL.
    -
    Accessibility considerations:
    -
    -
    - For authors -
    - - - - - - - - - - - - - -
    Implicit ARIA semanticsARIA roles, states and properties which MAY be used
    - No corresponding role - -

    No role or aria-* attributes.

    -
    -
    -
    -
    -
    -
    - For implementers -
    -
    -
    -
    DOM interface:
    -
    -
    - 
    -            [Exposed=Window]
-            interface HTMLTileElement : HTMLElement {
-              [HTMLConstructor] constructor();
-              
-              attribute long row;
-              attribute long col;
-              attribute DOMString src;
-              attribute DOMString type;
-            };
-
    -
    -
    -

    - The tile element is a type of feature which is associated with a tiled coordinate reference system that subdivides or 'tiles' 2D space in a recursively repeating grid pattern, where the origin of both the tiled - coordinate reference system and the grid at all zoom levels is defined in coordinates of an underlying projected coordinate reference system. -

    -

    - A defining characteristic of tiled coordinate reference systems is that they rely on integer grid row/col coordinates and zoom values. The use of these values in URLs can yield highly cacheable resources, which can lead to - high-performance map services. -

    -

    - The "zoom" value is a global integer property of a MapML document whose coordinate system is defined by this specification. All MapML documents have a defined zoom value. The "zoom" value is equal to the - zoom@value child of the extent element. Hence the zoom value is not a direct attribute of the tile element. -

    -

    - The main example of such a tiled coordinate reference system is OSMTILE, although others exist. -

    -
    -
    -
    The <image> element
    -
    -
    Categories:
    -
    Feature data.
    -
    Contexts in which this element can be used:
    -
    A child of the feature element, which has a sibling bbox element.
    -
    Content model:
    -
    Nothing.
    -
    Content attributes:
    -
    src — Address of the hyperlink.
    -
    type — A hint as to the MIME type of the resource.
    -
    Accessibility considerations:
    -
    -
    - For authors -
    - - - - - - - - - - - - - -
    Implicit ARIA semanticsARIA roles, states and properties which MAY be used
    - No corresponding role - -

    No role or aria-* attributes.

    -
    -
    -
    -
    -
    -
    - For implementers -
    -
    -
    -
    DOM interface:
    -
    - 
    -            [Exposed=Window]
-            interface HTMLImageElement : HTMLElement {
-              [HTMLConstructor] constructor();
-            };
-
    -
    -
    +
    The <feature> element
    Categories:
    -
    Feature data.
    Interactive content.
    Contexts in which this element can be used:
    Child of the body element.
    Content model:
    -
    Optional featurecaption element, - optional geometry element, - optional properties element, - optional image element.
    +
    Feature content.
    Content attributes:
    Global attributes.
    zoom — the 'native' zoom level of the feature geometry.
    @@ -2828,11 +2776,25 @@
    The <feature> element A feature element represents a map feature.

    + +
    +

    Feature content

    +
    +
    Elements categorized as feature content:
    +
    + featurecaption, + properties, + geometry, + coordinates, + image. +
    +
    +
    The <featurecaption> element
    Categories:
    -
    Feature data.
    +
    Feature content.
    Contexts in which this element can be used:
    As a child of a feature element containing no other featurecaption elements.
    Content model:
    @@ -2893,7 +2855,7 @@
    The <featurecaption><
    The <properties> element
    Categories:
    -
    Feature data.
    +
    Feature content.
    Contexts in which this element can be used:
    A child of the feature element.
    Content model:
    @@ -2948,7 +2910,7 @@
    The <properties> e
    The <geometry> element
    Categories:
    -
    Feature data.
    +
    Feature content.
    Contexts in which this element can be used:
    Child of the feature element.
    Content model:
    @@ -3089,7 +3051,7 @@
    The <geometry> eleme
    The <coordinates> element
    Categories:
    -
    Feature data.
    +
    Feature content.
    Contexts in which this element can be used:
    A descendant of the geometry element, as the coordinate data which defines a feature geometry.
    Content model:
    @@ -3152,6 +3114,140 @@
    The <coordinates> multipolygon element, the descendant coordinates elements must follow additional constraints.

    +
    +
    The <image> element
    +
    +
    Categories:
    +
    Feature content.
    +
    Contexts in which this element can be used:
    +
    A child of the feature element, which has a sibling bbox element.
    +
    Content model:
    +
    Nothing.
    +
    Content attributes:
    +
    src — Address of the hyperlink.
    +
    type — A hint as to the MIME type of the resource.
    +
    Accessibility considerations:
    +
    +
    + For authors +
    + + + + + + + + + + + + + +
    Implicit ARIA semanticsARIA roles, states and properties which MAY be used
    + No corresponding role + +

    No role or aria-* attributes.

    +
    +
    +
    +
    +
    +
    + For implementers +
    +
    +
    +
    DOM interface:
    +
    + 
    +            [Exposed=Window]
+            interface HTMLImageElement : HTMLElement {
+              [HTMLConstructor] constructor();
+            };
+
    +
    +
    +
    +
    +
    +
    The <tile> element
    +
    +
    Categories:
    +
    None.
    +
    Contexts in which this element can be used:
    +
    Child of the body element.
    +
    Content model:
    +
    Nothing.
    +
    Content attributes:
    +
    row — An integer (a Y axis value / the tile size) in the range of the tile coordinate reference system.
    +
    col — An integer (a X axis value / the tile size) in the domain of the tile coordinate reference system.
    +
    src — A URL from which the tile may be obtained.
    +
    type — A hint about the MIME type of the resource obtainable at the src URL.
    +
    Accessibility considerations:
    +
    +
    + For authors +
    + + + + + + + + + + + + + +
    Implicit ARIA semanticsARIA roles, states and properties which MAY be used
    + No corresponding role + +

    No role or aria-* attributes.

    +
    +
    +
    +
    +
    +
    + For implementers +
    +
    +
    +
    DOM interface:
    +
    +
    + 
    +            [Exposed=Window]
+            interface HTMLTileElement : HTMLElement {
+              [HTMLConstructor] constructor();
+              
+              attribute long row;
+              attribute long col;
+              attribute DOMString src;
+              attribute DOMString type;
+            };
+
    +
    +
    +

    + The tile element is a type of feature which is associated with a tiled coordinate reference system that subdivides or 'tiles' 2D space in a recursively repeating grid pattern, where the origin of both the tiled + coordinate reference system and the grid at all zoom levels is defined in coordinates of an underlying projected coordinate reference system. +

    +

    + A defining characteristic of tiled coordinate reference systems is that they rely on integer grid row/col coordinates and zoom values. The use of these values in URLs can yield highly cacheable resources, which can lead to + high-performance map services. +

    +

    + The "zoom" value is a global integer property of a MapML document whose coordinate system is defined by this specification. All MapML documents have a defined zoom value. The "zoom" value is equal to the + zoom@value child of the extent element. Hence the zoom value is not a direct attribute of the tile element. +

    +

    + The main example of such a tiled coordinate reference system is OSMTILE, although others exist. +

    +

    Styling