@vertigis/viewer-spec 42.10.0

package/docs/presentation.md

@@ -0,0 +1,98 @@
+# Presentation
+
+This document describes the syntax and semantics for presentation attributes:
+* Margin
+* Padding
+* Width
+* Height
+* Grow
+* Horizontal alignment
+* Vertical alignment
+
+## Applicability
+
+All attributes apply to all components unless otherwise stated.
+
+## Units
+
+All dimensional units are expressed in 'em's, unless specified otherwise, where 1 em is equal to the current font size. 
+
+## Margin
+
+**Attribute name**: "margin".  
+**Expected value**: Either 0 or a positive number (integer or floating point).  
+**Description**: Sets the size of the white space outside of the component.  
+
+**Example**:
+```
+<map margin="1.5"/> <!-- Sets the margin on a map to be equal to 1.5x the current font size -->
+```
+
+## Padding
+
+**Attribute name**: "padding".  
+**Expected value**: Either 0 or a positive number (integer or floating point).  
+**Description**: Sets the size of the white space between a component and its content.  
+**Applies to**: In the Geocortex Mobile Viewer, this attribute will only apply to components with children, due to technical restrictions.  
+
+**Example**:
+```
+<stack padding="0.5"/> <!-- Sets the padding on a stack to be equal to 0.5x the current font size -->
+```
+
+## Width and Height
+
+**Attribute name**: "width".  
+**Expected value**: Em units: Either 0 or a positive number (integer or floating point). Example: 12.  
+
+**Default value**: If a width is not set, then the width shall be the natural width of the component (however much space it needs).  
+**Description**: Sets the width of a component. If em units, then the width is a literal value.  
+
+**Attribute name**: "height".  
+**Expected value**: Em units: Either 0 or a positive number (integer or floating point). Example: 12.  
+
+**Description**: Sets the height of a component. If em units, then the height is a literal value.  
+
+**Example**:
+```
+<!-- Sets the width of a map to 30em, and the height to 20em. -->
+<map width="30em" height="20"/> 
+```
+
+## Grow
+
+**Attribute name**: "grow".  
+**Expected value**: Either 0 or a positive number (integer or floating point).  
+**Description**: Sets whether or not a component's width or height will grow over its parents primary axis. Components with a grow of 0 will fill to their natural or requested height. Components with a specified grow will fill up a  percentage of the remaining space equal to their grow value divided by the total grow of all sibling components  (including the component in question).  
+The default value for a component varies by component. For most components, if no grow value is specified, they will default to a grow value of "0". The following components however will have a default grow value of "1":
+* Map 
+* Stack
+* Split
+
+**Applies to**: All components may specify this value, but it will only take effect if the component is a child of a split or a stack. For stacks, grow indicates how the child grows along the vertical axis. For splits, grow indicates how the child grows along the horizontal axis.
+
+**Example**:
+```
+<stack>
+    <!-- Heading will take up whatever vertical space it requires, and will occupy its natural width. -->
+    <text content="Heading"/>
+    <!-- The first map will occupy 1/3 of the remaining vertical space, and will occupy the full width available. -->
+    <map grow="1"/>
+    <!-- The first map will occupy 2/3 of the remaining vertical space, and will occupy the full width available. -->
+    <map grow="2"/>
+</stack>
+```
+
+## Alignment 
+
+**Attribute name**: "halign".  
+**Expected value**: One of: "start", "center", or "end"  
+**Description**: Describes how the content of a component is aligned. For stacks and splits, the content is the child components. For a component like text, the content is the text itself.    
+
+**Attribute name**: "valign".  
+**Expected value**: One of: "start", "center", or "end"  
+**Description**: Describes how the content of a component is aligned. For stacks and splits, the content is the child components. For a component like text, the content is the text itself.  
+
+### Effect on cross-axis stretching
+All components will stretch across the cross-axis if the corresponding alignment attribute (halign for stacks, valign for splits) is not set on the parent of that componet. But if a cross-axis alignment is set, then they will no longer stretch across the cross axis (otherwise the effect of alignment would not be observed).  
+Some components will stretch across the cross-axis even if the cross-axis alignment is set on the parent: map, stack, split.  

package/layout/schema/layout-common.xsd

@@ -0,0 +1,849 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<schema xmlns="http://www.w3.org/2001/XMLSchema"
+  xmlns:tns="https://geocortex.com/layout/v1" targetNamespace="https://geocortex.com/layout/v1" elementFormDefault="qualified"
+  xmlns:xs="http://www.w3.org/2001/XMLSchema">
+  <element name="layout">
+    <complexType>
+      <sequence>
+        <element ref="tns:component" minOccurs="0" maxOccurs="unbounded"/>
+        <element ref="tns:rootComponent" minOccurs="0" maxOccurs="unbounded"/>
+      </sequence>
+      <attribute name="orientations">
+        <annotation>
+          <documentation xml:lang="en">
+            Indicates the allowable orientations - landscape or portrait, or both. When set to "landscape" or "portrait", the orientation of
+            the device will be locked to the specified value. Defaults to both if value not specified. Applies to iOS and Android Mobile only.
+          </documentation>
+        </annotation>
+        <simpleType>
+          <restriction base="string">
+            <enumeration value="landscape"/>
+            <enumeration value="portrait"/>
+            <enumeration value="portrait,landscape"/>
+          </restriction>
+        </simpleType>
+      </attribute>
+    </complexType>
+  </element>
+
+  <complexType name="ComponentWithChildren" abstract="true">
+    <complexContent mixed="true">
+      <extension base="tns:Component">
+        <choice>
+          <element ref="tns:component" minOccurs="0" maxOccurs="unbounded"/>
+        </choice>
+      </extension>
+    </complexContent>
+  </complexType>
+
+  <element name="rootComponent" type="tns:RootComponent" abstract="true"/>
+
+  <complexType name="RootComponent" abstract="true"> 
+    <complexContent mixed="true">
+       <extension base="tns:Component">
+        <choice>
+          <element ref="tns:component" minOccurs="1" maxOccurs="unbounded"/>
+        </choice>
+      </extension>
+    </complexContent>
+  </complexType>
+
+  <element name="component" type="tns:Component" abstract="true"/>
+
+  <complexType name="Component" abstract="true">
+    <annotation>
+      <documentation xml:lang="en">
+        A visual element of an application's UI, e.g. a button, a map, a
+        a dialog box, a panel, etc.
+      </documentation>
+    </annotation>
+    <sequence/>
+    <attribute name="id" type="ID">
+      <annotation>
+        <documentation xml:lang="en">
+          A unique ID for the component.
+        </documentation>
+      </annotation>
+    </attribute>
+    <attribute name="title" type="string">
+      <annotation>
+        <documentation xml:lang="en">
+          A human-readable title for the component. Where the title
+          appears (or whether it appears at all) varies with each type
+          of component.
+        </documentation>
+      </annotation>
+    </attribute>
+    <attribute name="icon" type="string">
+      <annotation>
+        <documentation xml:lang="en">
+          A resource key that can be mapped to an image for the icon.
+          Where the icon appears (or whether it appears at all) varies
+          with each type of component.
+        </documentation>
+      </annotation>
+    </attribute>
+    <attribute name="config" type="string">
+      <annotation>
+        <documentation xml:lang="en">
+          The ID of a corresponding item in a Geocortex App that
+          contains this component's configuration and state.
+        </documentation>
+      </annotation>
+    </attribute>
+    <attribute name="width">
+      <annotation>
+        <documentation xml:lang="en">
+          The width of the component, in em units.
+        </documentation>
+      </annotation>
+      <simpleType>
+        <restriction base="double">
+          <minInclusive value="0" />
+        </restriction>
+      </simpleType>
+    </attribute>
+    <attribute name="height">
+      <annotation>
+        <documentation xml:lang="en">
+          The height of the component, in em units.
+        </documentation>
+      </annotation>
+      <simpleType>
+        <restriction base="double">
+          <minInclusive value="0" />
+        </restriction>
+      </simpleType>
+    </attribute>
+    <attribute name="margin" type="double">
+      <annotation>
+        <documentation xml:lang="en">
+          The margin around the component, in em units.
+        </documentation>
+      </annotation>
+    </attribute>
+    <attribute name="padding" type="double">
+      <annotation>
+        <documentation xml:lang="en">
+          The padding within the component, in em units.
+        </documentation>
+      </annotation>
+    </attribute>
+    <attribute name="halign" default="start">
+      <annotation>
+        <documentation xml:lang="en">
+          Describes how the content of a component is horizontally
+          aligned. For stacks and splits, the content is the child
+          components. For a component like text, the content is the
+          text itself.
+        </documentation>
+      </annotation>
+      <simpleType>
+        <restriction base="string">
+          <enumeration value="start"/>
+          <enumeration value="center"/>
+          <enumeration value="end"/>
+        </restriction>
+      </simpleType>
+    </attribute>
+    <attribute name="valign" default="start">
+      <annotation>
+        <documentation xml:lang="en">
+          Describes how the content of a component is vertically
+          aligned. For stacks and splits, the content is the child
+          components. For a component like text, the content is the
+          text itself.
+        </documentation>
+      </annotation>
+      <simpleType>
+        <restriction base="string">
+          <enumeration value="start"/>
+          <enumeration value="center"/>
+          <enumeration value="end"/>
+        </restriction>
+      </simpleType>
+    </attribute>
+    <attribute name="grow" default="0">
+      <annotation>
+        <documentation xml:lang="en">
+          Sets whether or not a component's width or height will grow
+          over its parents primary axis. Components with a grow of 0
+          will fill to their natural or requested width/height.
+          Components with a specified grow will fill up a percentage
+          of the remaining space equal to their grow value divided by
+          the total grow of all sibling components (including the
+          component in question).
+        </documentation>
+      </annotation>
+      <simpleType>
+        <restriction base="double">
+          <minInclusive value="0" />
+        </restriction>
+      </simpleType>
+    </attribute>
+    <attribute name="slot" type="string">
+      <annotation>
+        <documentation xml:lang="en">
+          When a component is nested inside of another component, it
+          may explicitly reference a named "slot" in the parent
+          component to indicate where the child should appear.
+        </documentation>
+      </annotation>
+    </attribute>
+    <attribute name="active" type="boolean">
+      <annotation>
+        <documentation xml:lang="en">
+          Specifies whether a component is active by default or not. When this
+          attribute is not defined, the parent component decides the child's
+          behavior. In Web, an inactive component means that the component is
+          initially not visible. An active component means the component is
+          initially visible. In Mobile, inactive and active components are up to
+          the interpretation of the parent to decide on how to render.
+        </documentation>
+      </annotation>
+    </attribute>
+    <attribute name="models" type="string">
+      <annotation>
+        <documentation xml:lang="en">
+          Some components import the models of other components (for
+          example, a scalebar component might need access to a map
+          component's model). When these relationships cannot be
+          determined implicitly from the layout, then the layout
+          author can explicitly specify these dependencies via this
+          attribute. The value is a comma-separated list of CSS-style
+          selectors indiciating which components to import models
+          from. For example, "map,#primary-scene" would specify all
+          map components and a component with ID "primary-scene".
+        </documentation>
+      </annotation>
+    </attribute>
+  </complexType>
+
+  <!-- Basic Components -->
+
+  <element name="button" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A button that executes a command when clicked. The caption will be
+        the contained text, e.g. "Click Me!" in the case of
+        <![CDATA[<button>Click Me!</button>]]>.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent mixed="true">
+        <extension base="tns:Component">
+          <attribute name="command" type="string">
+            <annotation>
+              <documentation xml:lang="en">
+                The name of the command to execute.
+              </documentation>
+            </annotation>
+          </attribute>
+          <attribute name="arguments" type="string">
+            <annotation>
+              <documentation xml:lang="en">
+                The arguments for the command (optional).
+              </documentation>
+            </annotation>
+          </attribute>
+          <attribute name="style">
+            <annotation>
+              <documentation xml:lang="en">
+                The desired visual style for the button.
+              </documentation>
+            </annotation>
+            <simpleType>
+              <restriction base="string">
+                <enumeration value="round"/>
+                <enumeration value="square"/>
+              </restriction>
+            </simpleType>
+          </attribute>
+          <attribute name="show-title" type="boolean" default="true">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether to show the button's title.
+              </documentation>
+            </annotation>
+          </attribute>
+        </extension>
+      </complexContent>
+    </complexType>
+  </element>
+
+    <element name="bookmarks" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A component that shows the bookmarks associated with a map,
+        and allows users to create their own bookmarks.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component">
+          <attribute name="style">
+            <annotation>
+              <documentation xml:lang="en">
+                The desired visual style for the button.
+              </documentation>
+            </annotation>
+            <simpleType>
+              <restriction base="string">
+                <enumeration value="round"/>
+                <enumeration value="square"/>
+              </restriction>
+            </simpleType>
+          </attribute>
+        </extension>
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="dialog" substitutionGroup="tns:rootComponent">
+    <annotation>
+      <documentation xml:lang="en">
+        Displays a single child component in a dialog. Initially hidden. Displayed when
+        the dialog component is activated. Not supported in Web.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:RootComponent" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="expand" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A container whose content is hidden by default and only becomes visible
+        when the small "expand" button is clicked. When the button is clicked,
+        the container "pops up" and appears beside the expand button. Clicking
+        the expand button while the container is open closes the container. This
+        component is useful for hiding widget-like components that become
+        visible at the click of a button.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent mixed="true">
+        <extension base="tns:ComponentWithChildren">
+          <attribute name="visual-state">
+            <annotation>
+              <documentation xml:lang="en">
+                The initial state of the Expand. Not supported in Mobile.
+              </documentation>
+            </annotation>
+            <simpleType>
+              <restriction base="string">
+                <enumeration value="open"/>
+                <enumeration value="closed"/>
+              </restriction>
+            </simpleType>
+          </attribute>
+          <attribute name="modal" type="boolean" default="true">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether or not the expand container behaves as a modal window.
+              </documentation>
+            </annotation>
+          </attribute>
+          <attribute name="showIcon" type="boolean" default="true">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether or not the icon should be displayed.
+              </documentation>
+            </annotation>
+          </attribute>
+          <attribute name="showTitle" type="boolean" default="false">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether or not the title should be displayed.
+              </documentation>
+            </annotation>
+          </attribute>
+                    <attribute name="style">
+            <annotation>
+              <documentation xml:lang="en">
+                The desired visual style for the button.
+              </documentation>
+            </annotation>
+            <simpleType>
+              <restriction base="string">
+                <enumeration value="round"/>
+                <enumeration value="square"/>
+              </restriction>
+            </simpleType>
+          </attribute>
+        </extension>
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="image" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        An image. Not supported in Mobile.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="iwtm" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        An "I Want To..." menu (the actual title can be specified via the
+        "title" attribute). Has a single slot in Web, at the top. Supports
+        both "top" and "bottom" named slots in Mobile.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:ComponentWithChildren" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="panel" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A container that enables hierarchical navigation between its
+        child components. The user can navigate backwards to
+        components that were activated prior to the currently active
+        component and are ordered above the current component in
+        configuration. The last component that is marked as active
+        will be initially displayed, with all other components
+        configured above that last component as active being
+        accessible via navigating backwards.
+        For example, if a panel has child components A, B, and C
+        (configured in that order), and initially A is active, then
+        activating C would display the C component but allow the user
+        to navigate back to A. If the user then activated B while C
+        is active, then C would be popped, and B would be shown,
+        again with a back button to navigate to A but with no way of
+        navigating to C because the configured order is maintained.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent mixed="true">
+        <extension base="tns:ComponentWithChildren">
+          <attribute name="show-close-button" type="boolean" default="true">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether to show a button that closes the Panel. Not supported in
+                Mobile.
+              </documentation>
+            </annotation>
+          </attribute>
+          <attribute name="show-back-button" type="boolean" default="true">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether to show a button that allows the user to go "back". If a
+                Panel has child components A, B, and C, and C is currently
+                active, clicking the back button will hide C and B will be
+                shown. Not supported in Mobile.
+              </documentation>
+            </annotation>
+          </attribute>
+          <attribute name="show-maximize-button" type="boolean" default="true">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether to show a button that allows the user to maximize the
+                panel. A maximized panel will grow and fill the size of its
+                parent container. Not supported in Mobile.
+              </documentation>
+            </annotation>
+          </attribute>
+          <attribute name="show-minimize-button" type="boolean" default="true">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether to show a button that allows the user to minimize the
+                panel. A minimized panel will shrink to a small bar that only
+                contains a "restore size" button. In a split, this is a vertical
+                bar; in a stack (and other containers the arrange children
+                vertically), this is a horizontal bar. Not supported in Mobile.
+              </documentation>
+            </annotation>
+          </attribute>
+          <attribute name="visual-state">
+            <annotation>
+              <documentation xml:lang="en">
+                The initial state of the panel. Not supported in Mobile.
+              </documentation>
+            </annotation>
+            <simpleType>
+              <restriction base="string">
+                <enumeration value="normal"/>
+                <enumeration value="minimized"/>
+                <enumeration value="maximized"/>
+              </restriction>
+            </simpleType>
+          </attribute>
+        </extension>
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="split" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A container for other components that organizes its children
+        horizontally.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent mixed="true">
+        <extension base="tns:Component">
+          <choice>
+            <element ref="tns:component" minOccurs="0" maxOccurs="unbounded"/>
+          </choice>
+          <attribute name="resizable" type="boolean" default="false">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether the user can interactively resize the
+                contained components. Not supported on all
+                platforms.
+              </documentation>
+            </annotation>
+          </attribute>
+        </extension>
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="stack" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A container for other components that organizes its children
+        vertically.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent mixed="true">
+        <extension base="tns:Component">
+          <choice>
+            <element ref="tns:component" minOccurs="0" maxOccurs="unbounded"/>
+          </choice>
+          <attribute name="resizable" type="boolean" default="false">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether the user can interactively resize the
+                contained components. Not supported on all
+                platforms.
+              </documentation>
+            </annotation>
+          </attribute>
+        </extension>
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="text" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A component that displays text.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent mixed="true">
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <!-- NOTE: GXW-only, despite being in the common namespace. -->
+  <element name="toolbar" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A toolbar menu. The toolbar supports up to one level of nesting (a set of
+        tools can be grouped together in one 'parent' that is displayed on the
+        root toolbar menu.). Not supported in Mobile.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component">
+          <attribute name="orientation">
+            <annotation>
+              <documentation xml:lang="en">
+                Determines the orientation of the toolbar menu items.
+              </documentation>
+            </annotation>
+            <simpleType>
+              <restriction base="string">
+                <enumeration value="vertical"/>
+                <enumeration value="horizontal"/>
+              </restriction>
+            </simpleType>
+          </attribute>
+          <attribute name="showTitles" type="boolean" default="true">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether to display the titles on buttons. You may wish to hide
+                the titles in order to show just icons.
+              </documentation>
+            </annotation>
+          </attribute>
+           <attribute name="showDescriptions" type="boolean" default="true">
+            <annotation>
+              <documentation xml:lang="en">
+                Whether to display the descriptions inline in buttons. If turned
+                off, the description will be in the tooltip instead for desktop
+                users. No effect unless the orientation is "vertical" and titles
+                are also shown.
+              </documentation>
+            </annotation>
+          </attribute>
+        </extension>
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="user" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        Shows information about the current user (if there is one), and allows
+        the user to sign in or out as appropriate. The user component does not
+        support child components in Mobile.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:ComponentWithChildren" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="workflow" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A component that hosts workflow forms. When a workflow item config is
+        specified, the workflow will be run when the component is activated. Any
+        command to run a workflow can use the component by adding
+        '#{componentId}' to its target. If the component is activated outside
+        the context of running a workflow, and does not have a workflow item
+        config, it will appear empty. Only one workflow can use the component at
+        a time. If a second workflow attempts to use the component, the user
+        will be asked to cancel one of the workflows in Mobile. In Web, the
+        first workflow is canceled automatically.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent mixed="true">
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <!-- GIS Components -->
+
+  <element name="basemap-picker" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        Allows users to choose between available basemaps for the webmap or
+        webscene. Requiers an associated map component (see the "models"
+        attribute).
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="compass" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        Displays a North-pointing compass that rotates with the rotation of the map to which it is associated.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="feature-details" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A component that allows the user to view feature details.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="geolocate" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        Displays a clickable/tappable indicator that toggles GPS geolocation behavior. In Mobile,
+        the accuracy is also shown, and can be displayed in either metric or imperial units.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="layer-list" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        Allows users to see the structure of layers on the map and change their
+        visibility. Requires an associated map component (see the "models"
+        attribute).
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+    <element name="layer-presets" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A component that shows a list of layer presets and allows users 
+        to apply them.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="legend" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        Allows the user to see the symbology of the layers on the map. Requires
+        an associated map component (see the "models" attribute").
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="map" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A 2D map (and/or a 3D scene in Web). A map can host child components and
+        has the following slots in Mobile: "top-left", "top-right",
+        "bottom-left", "bottom-right", "top", "top-center-visible", "bottom" and
+        "bottom-center-visible". A child component in the "center-visible" slot
+        will be centered in the visible area of the map, factoring in other
+        components that are overlapping the map. 
+        
+        A map in Web has the following slots: "top-start", "top-center",
+        "top-end", "bottom-start", "bottom-center", "bottom-end",
+        "context-menu", and "popup". In left-to-right locales, "start" will be
+        on the left, and "end" will be on the right. In right-to-left locales,
+        these will be reversed.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent mixed="true">
+        <extension base="tns:ComponentWithChildren" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <!-- NOTE: GXW-only, despite being in the common namespace. -->
+  <element name="map-coordinates" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        Allows the user to see the coordinates under the current mouse position.
+        Requires an associated map component (see the "models" attribute"). Not
+        supported in Mobile.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="results-list" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A component that allows the user to view results from a search,
+        identify, query, or any other activity that produces features in a list
+        view.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="scalebar" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A component that shows the scale of a map.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="search" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A component that allows the user to search one ore more sources
+        (maps, scenes, tables, geocoders, etc.).
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="search-new-extent" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        A component that provides a single button that allows the user to "search this area"
+        when the extent of the map changes to be different than the extent that was originally searched.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+
+  <element name="zoom" substitutionGroup="tns:component">
+    <annotation>
+      <documentation xml:lang="en">
+        Displays a pair of buttons that allow the user to zoom the map in or out.
+      </documentation>
+    </annotation>
+    <complexType>
+      <complexContent>
+        <extension base="tns:Component" />
+      </complexContent>
+    </complexType>
+  </element>
+</schema>