Skip to content

Instantly share code, notes, and snippets.

@philipsorst
Created November 9, 2026 10:57
Show Gist options
  • Select an option

  • Save philipsorst/d562dfe1eaefd3014d2db9afdc41b1fe to your computer and use it in GitHub Desktop.

Select an option

Save philipsorst/d562dfe1eaefd3014d2db9afdc41b1fe to your computer and use it in GitHub Desktop.
TecArt template schema
<?xml version="1.0" encoding="UTF-8"?>
<!--
XML Schema (XSD 1.0) for the TecArt CRM add-on template dialect "template.xml".
Derived from: https://alt.crmhandbuch.de/WIKI/Template_26314816.html
(TecArt Developer-Wiki, page "Template", Confluence export 2024-02-27)
This file is an out-of-project artefact and is not consumed by the build.
Validate with libxml2's xmllint (see the schema annotation for the command) or point an
IDE at the file via xsi:noNamespaceSchemaLocation="template.xsd".
Modelling notes:
* Templates carry no namespace, so the schema has no targetNamespace. <layout> is the
only global element, which pins it as the document root ("nur als Wurzelknoten
zulässig").
* Containment follows the reference's "Erlaubt in" lists. Where a tag is documented as
"Überall innerhalb des <layout>-Tags" (<if>, <elseif>, <else>, <for>, <assign>,
<include>) the control structures are allowed inside every container below layout.
Because their content then depends on where they sit (a loop in <row> wraps <col>,
in <tabgroup> a <tab>, in <selection> an <option>), and XSD 1.0 has no
context-dependent content models, the control structures accept the union of all
contexts (group anyContent). That is the single deliberate over-acceptance here;
concrete elements stay fully constrained.
* Element order inside a container is free (xs:choice, unbounded) except where the
reference states a fixed shape: <details> holds <summary> first, <row> holds <col>,
<tabgroup> holds <tab>, <list> holds <listbutton>, <selection> holds <option>.
* Attribute requiredness follows the reference's legend ("* Pflichtattribut"). Only
grid/@src and objectselection/@module carry that marker. A handful of attributes that
are structurally unavoidable (include/@src, assign/@var, for/@data-id, if/@condition,
label/@for, listbutton/@name) are additionally required; see each annotation.
* Conditional requiredness (the legend's *¹/*² for left/right depending on condition)
cannot be expressed in XSD 1.0 and is documented instead.
* Two attributes appear in the reference's own examples but in none of its attribute
lists (hposition on <headline> and <button>); they are accepted as open strings
rather than rejected or given an invented enumeration.
* The "¤" marker ("manipulierbar per Widget-Set-Action") is informational only and is
repeated in the affected annotations.
-->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation>
XML Schema for the TecArt CRM add-on template dialect template.xml.
Validate a document with libxml2's xmllint:
xmllint --noout --schema template.xsd path/to/template.xml
Alternatively reference this schema from the document root:
xsi:noNamespaceSchemaLocation="template.xsd"
</xs:documentation>
</xs:annotation>
<!-- ====================================================================
Simple types
==================================================================== -->
<!-- Section 1.2: the template's ID rules.
First character a Latin letter; further characters Latin letters, digits,
underscore, hyphen, square brackets and round brackets; an underscore may be
followed by any of those except another underscore. Umlauts and eszett are not
Latin letters in the reference's sense and are therefore excluded. A trailing
underscore is accepted (the reference constrains only what may follow one).
The reserved IDs self, top, parent, opener, event and root cannot be excluded in
XSD 1.0 and are documented here instead. -->
<xs:simpleType name="idType">
<xs:annotation>
<xs:documentation>Template ID: starts with a Latin letter, then Latin letters,
digits, underscore, hyphen, square brackets or round brackets; no two consecutive
underscores. Reserved (not expressible here): self, top, parent, opener, event,
root.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Za-z]([A-Za-z0-9()\[\]\-]|_[A-Za-z0-9()\[\]\-])*_?"/>
</xs:restriction>
</xs:simpleType>
<!-- The reference writes boolean values as true/false and TRUE/FALSE
(multiple, init-progress, open, hover, validate, readonly, ...). -->
<xs:simpleType name="booleanType">
<xs:annotation>
<xs:documentation>Boolean flag; the reference spells it true/false and
TRUE/FALSE.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="true"/>
<xs:enumeration value="false"/>
<xs:enumeration value="TRUE"/>
<xs:enumeration value="FALSE"/>
</xs:restriction>
</xs:simpleType>
<!-- Section 1.1.5: the three layout types. -->
<xs:simpleType name="layoutTypeName">
<xs:annotation>
<xs:documentation>Layout type: fluid (small window and column gaps), fluid-full
(no gaps), fluid-framed (since v4.7, large window gaps).</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="fluid"/>
<xs:enumeration value="fluid-full"/>
<xs:enumeration value="fluid-framed"/>
</xs:restriction>
</xs:simpleType>
<!-- Section 1.4: background colours (since v5.0). -->
<xs:simpleType name="backgroundColorType">
<xs:annotation>
<xs:documentation>Background colour (since v5.0), see reference section 1.4.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="info_1"/>
<xs:enumeration value="info_2"/>
<xs:enumeration value="info_3"/>
<xs:enumeration value="done_1"/>
<xs:enumeration value="done_2"/>
<xs:enumeration value="done_3"/>
<xs:enumeration value="warning_1"/>
<xs:enumeration value="warning_2"/>
<xs:enumeration value="warning_3"/>
<xs:enumeration value="important_1"/>
<xs:enumeration value="important_2"/>
<xs:enumeration value="important_3"/>
<xs:enumeration value="achromatic_1"/>
<xs:enumeration value="achromatic_2"/>
<xs:enumeration value="achromatic_3"/>
</xs:restriction>
</xs:simpleType>
<!-- col/@size, field/@size, selection/@size, listfield/@size, objectselection/@size -->
<xs:simpleType name="gridWidthType">
<xs:annotation>
<xs:documentation>Width in grid columns, 1 to 12.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1"/>
<xs:maxInclusive value="12"/>
</xs:restriction>
</xs:simpleType>
<!-- col/@offset -->
<xs:simpleType name="gridOffsetType">
<xs:annotation>
<xs:documentation>Left offset in grid columns, 1 to 11.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1"/>
<xs:maxInclusive value="11"/>
</xs:restriction>
</xs:simpleType>
<!-- headline/@size -->
<xs:simpleType name="headlineSizeType">
<xs:annotation>
<xs:documentation>Headline font size, 1 to 6.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:integer">
<xs:minInclusive value="1"/>
<xs:maxInclusive value="6"/>
</xs:restriction>
</xs:simpleType>
<!-- Section 1.1.1: rem values, e.g. row/@min-size and timer/@size. -->
<xs:simpleType name="remType">
<xs:annotation>
<xs:documentation>Size in rem (a rem is the root font size), e.g. 5 or 2.5.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[0-9]+(\.[0-9]+)?"/>
</xs:restriction>
</xs:simpleType>
<!-- row/@size and image/@size accept a bare number (read as rem) or a percentage. -->
<xs:simpleType name="remOrPercentType">
<xs:annotation>
<xs:documentation>Size in rem or as a percentage of the parent container, e.g. 3 or
50%.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="[0-9]+(\.[0-9]+)?%?"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="horizontalAlignType">
<xs:annotation>
<xs:documentation>Horizontal alignment of texts and headlines in a column.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="left"/>
<xs:enumeration value="right"/>
<xs:enumeration value="center"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="verticalAlignType">
<xs:annotation>
<xs:documentation>Vertical alignment of texts and headlines in a column.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="top"/>
<xs:enumeration value="middle"/>
<xs:enumeration value="bottom"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="labelPositionType">
<xs:annotation>
<xs:documentation>Position of a field's label. textarea documents "top" as its
default, the other widgets "left".</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="left"/>
<xs:enumeration value="right"/>
<xs:enumeration value="top"/>
</xs:restriction>
</xs:simpleType>
<!-- field/@type -->
<xs:simpleType name="fieldTypeName">
<xs:annotation>
<xs:documentation>Type of a &lt;field&gt; widget.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="currency"/>
<xs:enumeration value="date"/>
<xs:enumeration value="datetime"/>
<xs:enumeration value="email"/>
<xs:enumeration value="float"/>
<xs:enumeration value="integer"/>
<xs:enumeration value="password"/>
<xs:enumeration value="slider"/>
<xs:enumeration value="text"/>
<xs:enumeration value="time"/>
<xs:enumeration value="url"/>
<xs:enumeration value="search"/>
</xs:restriction>
</xs:simpleType>
<!-- button/@type -->
<xs:simpleType name="buttonTypeName">
<xs:annotation>
<xs:documentation>Button type for use in forms (since v4.10).</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="submit"/>
<xs:enumeration value="reset"/>
</xs:restriction>
</xs:simpleType>
<!-- button/@style (since v5.4) -->
<xs:simpleType name="buttonStyleName">
<xs:annotation>
<xs:documentation>Button look (since v5.4); secondary is the default.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="secondary"/>
<xs:enumeration value="primary"/>
<xs:enumeration value="flat"/>
<xs:enumeration value="link"/>
</xs:restriction>
</xs:simpleType>
<!-- toolbar/@style and footer/@style (since v4.6) -->
<xs:simpleType name="barStyleName">
<xs:annotation>
<xs:documentation>Toolbar look (since v4.6): default is the light bar, brand the dark
one.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="brand"/>
</xs:restriction>
</xs:simpleType>
<!-- selection/@type and listfield/@type -->
<xs:simpleType name="selectionDisplayType">
<xs:annotation>
<xs:documentation>Rendering of a selection: box or expandable field.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="box"/>
<xs:enumeration value="expandable"/>
</xs:restriction>
</xs:simpleType>
<!-- timer/@type -->
<xs:simpleType name="timerTypeName">
<xs:annotation>
<xs:documentation>Timer type: default shows the elapsed time as text, clock shows it
in an editable text field.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="default"/>
<xs:enumeration value="clock"/>
</xs:restriction>
</xs:simpleType>
<!-- details/@style (since v5.4) -->
<xs:simpleType name="detailsStyleName">
<xs:annotation>
<xs:documentation>The only documented value is link, which renders the summary as a
link and leaves the content unindented.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="link"/>
</xs:restriction>
</xs:simpleType>
<!-- summary/@font-size (since v5.4) -->
<xs:simpleType name="summaryFontSizeType">
<xs:annotation>
<xs:documentation>Font size of a details summary.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="xs"/>
<xs:enumeration value="sm"/>
<xs:enumeration value="md"/>
<xs:enumeration value="lg"/>
<xs:enumeration value="xl"/>
</xs:restriction>
</xs:simpleType>
<!-- objectselection/@module -->
<xs:simpleType name="objectModuleName">
<xs:annotation>
<xs:documentation>Module an objectselection searches in.</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="contacts"/>
<xs:enumeration value="projects"/>
<xs:enumeration value="contracts"/>
<xs:enumeration value="offers"/>
<xs:enumeration value="tickets"/>
<xs:enumeration value="orders"/>
<xs:enumeration value="articles"/>
</xs:restriction>
</xs:simpleType>
<!-- ====================================================================
Attribute groups
==================================================================== -->
<xs:attributeGroup name="idAttr">
<xs:attribute name="id" type="idType">
<xs:annotation><xs:documentation>ID of the element, see the ID rules in reference
section 1.2.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:attributeGroup>
<xs:attributeGroup name="hiddenAttr">
<xs:attribute name="hidden" type="booleanType">
<xs:annotation><xs:documentation>Whether the element is initially invisible. The
reference gives false as the default everywhere except &lt;timer&gt;, where it
states no default.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:attributeGroup>
<xs:attributeGroup name="backgroundAttr">
<xs:attribute name="background-color" type="backgroundColorType">
<xs:annotation><xs:documentation>Background colour (since v5.0).</xs:documentation></xs:annotation>
</xs:attribute>
</xs:attributeGroup>
<xs:attributeGroup name="tooltipAttr">
<xs:attribute name="tooltip" type="xs:string">
<xs:annotation><xs:documentation>Hover text; translated when the add-on is
multilingual. Marked "¤" where it can be changed through the widget-set
action.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:attributeGroup>
<!-- Undocumented, but used by the reference's own examples: <headline
value="lang_key" size="5" hposition="left" icon="car"/> (section 1.1.4) and
<button text="rechter Button" hposition="right"/> (section 2.2.12). Neither
attribute list mentions it, so it stays an open string instead of an invented
enumeration. -->
<xs:attributeGroup name="hPositionAttr">
<xs:attribute name="hposition" type="xs:string">
<xs:annotation><xs:documentation>Horizontal position. Not documented in the
reference's attribute lists, but used by its examples with the values left and
right, so the value is not restricted.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:attributeGroup>
<xs:attributeGroup name="labelPositionAttr">
<xs:attribute name="label-position" type="labelPositionType">
<xs:annotation><xs:documentation>Position of the label relative to the
widget.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:attributeGroup>
<!-- ====================================================================
Element groups (the containment matrix)
==================================================================== -->
<!-- Control structures: documented as allowed "anywhere inside <layout>". -->
<xs:group name="controlFlow">
<xs:choice>
<xs:element name="if" type="ifType"/>
<xs:element name="elseif" type="ifType"/>
<xs:element name="else" type="elseType"/>
<xs:element name="for" type="forType"/>
<xs:element name="assign" type="assignType"/>
<xs:element name="include" type="includeType"/>
</xs:choice>
</xs:group>
<!-- Widgets whose "Erlaubt in" lists include <col>. -->
<xs:group name="widgets">
<xs:choice>
<xs:element name="button" type="buttonType"/>
<xs:element name="checkbox" type="checkboxType"/>
<xs:element name="details" type="detailsType"/>
<xs:element name="field" type="fieldType"/>
<xs:element name="filemanager" type="filemanagerType"/>
<xs:element name="gantt" type="ganttType"/>
<xs:element name="graph" type="graphType"/>
<xs:element name="grid" type="gridType"/>
<xs:element name="headline" type="headlineType"/>
<xs:element name="image" type="imageType"/>
<xs:element name="label" type="labelType"/>
<xs:element name="list" type="listType"/>
<xs:element name="listfield" type="listfieldType"/>
<xs:element name="objectselection" type="objectSelectionType"/>
<xs:element name="selection" type="selectionType"/>
<xs:element name="text" type="textType"/>
<xs:element name="textarea" type="textareaType"/>
<xs:element name="timeline" type="timelineType"/>
<xs:element name="timer" type="timerType"/>
</xs:choice>
</xs:group>
<!-- Children of <col>. -->
<xs:group name="colContent">
<xs:choice>
<xs:element name="fieldset" type="fieldsetType"/>
<xs:element name="line" type="lineType"/>
<xs:element name="panel" type="panelType"/>
<xs:element name="row" type="rowType"/>
<xs:element name="separator" type="separatorType"/>
<xs:element name="splitter" type="splitterType"/>
<xs:element name="tabgroup" type="tabgroupType"/>
<xs:element name="toolbar" type="barType"/>
<xs:element name="footer" type="barType"/>
<xs:element name="form" type="formType"/>
<xs:element name="area" type="areaType"/>
<xs:element name="snippet" type="snippetType"/>
<xs:group ref="widgets"/>
<xs:group ref="controlFlow"/>
</xs:choice>
</xs:group>
<!-- Children of the layout-like containers: <layout>, <fieldset>, <panel>, <tab>,
<details>, <form> and <snippet>. The reference describes these as holding
"diverse andere Container"; <row> is the shape it shows. -->
<xs:group name="boxContent">
<xs:choice>
<xs:element name="row" type="rowType"/>
<xs:element name="toolbar" type="barType"/>
<xs:element name="footer" type="barType"/>
<xs:element name="panel" type="panelType"/>
<xs:element name="tabgroup" type="tabgroupType"/>
<xs:element name="fieldset" type="fieldsetType"/>
<xs:element name="line" type="lineType"/>
<xs:element name="separator" type="separatorType"/>
<xs:element name="splitter" type="splitterType"/>
<xs:element name="area" type="areaType"/>
<xs:element name="snippet" type="snippetType"/>
<xs:group ref="widgets"/>
<xs:group ref="controlFlow"/>
</xs:choice>
</xs:group>
<!-- Children of <layout>: rows plus the bars that may sit next to them since v4.6. -->
<xs:group name="layoutContent">
<xs:choice>
<xs:element name="row" type="rowType"/>
<xs:element name="toolbar" type="barType"/>
<xs:element name="footer" type="barType"/>
<xs:element name="form" type="formType"/>
<xs:element name="area" type="areaType"/>
<xs:element name="snippet" type="snippetType"/>
<xs:group ref="controlFlow"/>
</xs:choice>
</xs:group>
<!-- Content of the control structures. The reference allows <if>, <elseif>, <else>,
<for>, <assign> and <include> "anywhere inside <layout>", so their content depends
on where they sit: a loop inside <row> wraps <col>, one inside <tabgroup> wraps
<tab>, one inside <selection> wraps <option>, one inside <col> wraps anything a
column holds. XSD 1.0 cannot make a content model context-dependent, so this group
is the union of all contexts. A control structure therefore accepts a superset of
what TecArt accepts; concrete elements stay fully constrained. -->
<xs:group name="anyContent">
<xs:choice>
<xs:element name="col" type="colType"/>
<xs:element name="tab" type="tabType"/>
<xs:element name="listbutton" type="listbuttonType"/>
<xs:element name="option" type="optionType"/>
<xs:group ref="boxContent"/>
</xs:choice>
</xs:group>
<!-- Children of <toolbar> and <footer>: "sämtliche erlaubten Widgets". -->
<xs:group name="barContent">
<xs:choice>
<xs:element name="button" type="buttonType"/>
<xs:element name="checkbox" type="checkboxType"/>
<xs:element name="field" type="fieldType"/>
<xs:element name="label" type="labelType"/>
<xs:element name="listfield" type="listfieldType"/>
<xs:element name="objectselection" type="objectSelectionType"/>
<xs:element name="selection" type="selectionType"/>
<xs:element name="separator" type="separatorType"/>
<xs:element name="splitter" type="splitterType"/>
<xs:element name="timer" type="timerType"/>
<xs:element name="area" type="areaType"/>
<xs:group ref="controlFlow"/>
</xs:choice>
</xs:group>
<!-- Children of <area>: it groups widgets, it is not a layout container. -->
<xs:group name="areaContent">
<xs:choice>
<xs:group ref="widgets"/>
<xs:element name="separator" type="separatorType"/>
<xs:element name="splitter" type="splitterType"/>
<xs:group ref="controlFlow"/>
</xs:choice>
</xs:group>
<!-- Children of <summary>: the heading content. The reference shows <text> and does not
enumerate the allowed tags, so inline widgets are accepted. -->
<xs:group name="summaryContent">
<xs:choice>
<xs:element name="text" type="textType"/>
<xs:element name="headline" type="headlineType"/>
<xs:element name="image" type="imageType"/>
<xs:element name="label" type="labelType"/>
<xs:element name="button" type="buttonType"/>
<xs:group ref="controlFlow"/>
</xs:choice>
</xs:group>
<!-- Children of <row>: "grundsätzlich nur Spalten". -->
<xs:group name="rowContent">
<xs:choice>
<xs:element name="col" type="colType"/>
<xs:group ref="controlFlow"/>
</xs:choice>
</xs:group>
<xs:group name="tabgroupContent">
<xs:choice>
<xs:element name="tab" type="tabType"/>
<xs:group ref="controlFlow"/>
</xs:choice>
</xs:group>
<xs:group name="listContent">
<xs:choice>
<xs:element name="listbutton" type="listbuttonType"/>
<xs:group ref="controlFlow"/>
</xs:choice>
</xs:group>
<xs:group name="selectionContent">
<xs:choice>
<xs:element name="option" type="optionType"/>
<xs:group ref="controlFlow"/>
</xs:choice>
</xs:group>
<!-- ====================================================================
Layout containers
==================================================================== -->
<xs:complexType name="layoutType">
<xs:annotation>
<xs:documentation>The main container of every template; the only allowed root
node.</xs:documentation>
</xs:annotation>
<xs:group ref="layoutContent" minOccurs="1" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="type" type="layoutTypeName" default="fluid">
<xs:annotation><xs:documentation>Layout type, default fluid.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="backgroundAttr"/>
</xs:complexType>
<xs:complexType name="rowType">
<xs:annotation>
<xs:documentation>A row of up to 12 columns. flex rows share the remaining height of
their parent; the parent must be layout, tab or panel.</xs:documentation>
</xs:annotation>
<xs:group ref="rowContent" minOccurs="1" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="flex" type="xs:positiveInteger">
<xs:annotation><xs:documentation>Share of the parent container's height relative to
the other flex rows; only meaningful when the parent is layout, tab or panel. The
reference documents null as the default.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="min-size" type="remType">
<xs:annotation><xs:documentation>Minimum height in rem; works together with flex. A
row that cannot shrink further makes its container scrollable.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="size" type="remOrPercentType">
<xs:annotation><xs:documentation>Height as rem or as a percentage of the page; a bare
number is read as rem. Only has an effect when flex is not set.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="backgroundAttr"/>
</xs:complexType>
<xs:complexType name="colType">
<xs:annotation>
<xs:documentation>A column of the 12-column grid; nesting rows inside a column is
allowed.</xs:documentation>
</xs:annotation>
<xs:group ref="colContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="align" type="horizontalAlignType">
<xs:annotation><xs:documentation>Horizontal alignment of texts and headlines inside
this column, default left.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="offset" type="gridOffsetType">
<xs:annotation><xs:documentation>Distance from the left window edge, 1 to 11;
default 0.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="size" type="gridWidthType">
<xs:annotation><xs:documentation>Column width in grid units, 1 to 12; default
12.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="valign" type="verticalAlignType">
<xs:annotation><xs:documentation>Vertical alignment of texts and headlines inside
this column, default top.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="backgroundAttr"/>
</xs:complexType>
<xs:complexType name="fieldsetType">
<xs:annotation>
<xs:documentation>A framed area that can carry a label and an icon and holds other
containers.</xs:documentation>
</xs:annotation>
<xs:group ref="boxContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Heading of the fieldset, default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="icon" type="xs:string">
<xs:annotation><xs:documentation>Font Awesome 4 icon name, given without the leading
"fa-". Marked "¤" in the reference. Default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attributeGroup ref="tooltipAttr"/>
<xs:attributeGroup ref="backgroundAttr"/>
</xs:complexType>
<xs:complexType name="panelType">
<xs:annotation>
<xs:documentation>A container inside the page that can use a different layout
type.</xs:documentation>
</xs:annotation>
<xs:group ref="boxContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="layout-type" type="layoutTypeName">
<xs:annotation><xs:documentation>Layout type of the container, default
fluid.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="src" type="xs:string">
<xs:annotation><xs:documentation>Class name of the action to load.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="backgroundAttr"/>
</xs:complexType>
<xs:complexType name="lineType">
<xs:annotation>
<xs:documentation>A horizontal spacer.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
</xs:complexType>
<xs:complexType name="separatorType">
<xs:annotation>
<xs:documentation>A spacer between free buttons or widgets inside a toolbar, a footer
or a column.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attributeGroup ref="hiddenAttr"/>
</xs:complexType>
<xs:complexType name="splitterType">
<xs:annotation>
<xs:documentation>A spacer that pushes the following widgets to the right. It has no
attributes.</xs:documentation>
</xs:annotation>
</xs:complexType>
<xs:complexType name="tabType">
<xs:annotation>
<xs:documentation>A single register card; it acts as a layout container.</xs:documentation>
</xs:annotation>
<xs:group ref="boxContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="active" type="booleanType">
<xs:annotation><xs:documentation>Activates this tab, default false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Text on the tab, default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="layout-type" type="layoutTypeName">
<xs:annotation><xs:documentation>Layout type of the container, default
fluid.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="preload" type="booleanType">
<xs:annotation><xs:documentation>Load the tab content when the window opens; only
meaningful together with src. Default false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="src" type="xs:string">
<xs:annotation><xs:documentation>Optional source to load the tab content
from.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="tooltipAttr"/>
</xs:complexType>
<xs:complexType name="tabgroupType">
<xs:annotation>
<xs:documentation>A container for any number of register cards.</xs:documentation>
</xs:annotation>
<xs:group ref="tabgroupContent" minOccurs="1" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
</xs:complexType>
<xs:complexType name="barType">
<xs:annotation>
<xs:documentation>A toolbar, or a footer (available since v4.6). Both accept all
widgets listed as allowed in a toolbar. The reference allows only one toolbar and
one footer per page, which XSD 1.0 cannot express.</xs:documentation>
</xs:annotation>
<xs:group ref="barContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="style" type="barStyleName">
<xs:annotation><xs:documentation>Toolbar look since v4.6, default default
(light).</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<!-- ====================================================================
Widgets
==================================================================== -->
<xs:complexType name="areaType">
<xs:annotation>
<xs:documentation>Since v4.7: groups widgets so that several of them can be read or
manipulated in one call. Areas sharing a name form a group, addressed with a leading
dot. Allowed everywhere except in a tabgroup that groups tabs and in a
selection.</xs:documentation>
</xs:annotation>
<xs:group ref="areaContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="name" type="xs:string">
<xs:annotation><xs:documentation>Groups several areas under one name.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hiddenAttr"/>
</xs:complexType>
<xs:complexType name="buttonType">
<xs:annotation>
<xs:documentation>A button that runs an action. Within a form, type submit and reset
get an automatic label when none is given.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="text" type="xs:string">
<xs:annotation><xs:documentation>Button text up to v4.5, superseded by label. Default
empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Button text since v4.6; translated when the add-on
is multilingual. Default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="tooltipAttr"/>
<xs:attribute name="type" type="buttonTypeName">
<xs:annotation><xs:documentation>Button type for use in forms since v4.10, default
default.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="style" type="buttonStyleName">
<xs:annotation><xs:documentation>Button look since v5.4, default
secondary.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-press" type="xs:string">
<xs:annotation><xs:documentation>Action run when the user presses the button.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-alt-press" type="xs:string">
<xs:annotation><xs:documentation>Since v4.6: action run on a right click.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hPositionAttr"/>
</xs:complexType>
<xs:complexType name="checkboxType">
<xs:annotation>
<xs:documentation>A checkbox.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="checked" type="booleanType">
<xs:annotation><xs:documentation>Since v4.6: whether the box is checked, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Text next to the box, default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="labelPositionAttr"/>
<xs:attribute name="readonly" type="booleanType">
<xs:annotation><xs:documentation>Since v4.6: the box cannot be changed. Marked "¤".
Default false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="tooltipAttr"/>
<xs:attribute name="on-change" type="xs:string">
<xs:annotation><xs:documentation>Action run when the user toggles the box.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="detailsType">
<xs:annotation>
<xs:documentation>Since v5.4: a heading with collapsible content. Elements sharing a
name form an accordion. The widget holds one summary followed by its
content.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="summary" type="summaryType"/>
<xs:group ref="boxContent" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="name" type="xs:string">
<xs:annotation><xs:documentation>Groups several details elements into an accordion;
at most one of the group is expanded.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="style" type="detailsStyleName">
<xs:annotation><xs:documentation>The only allowed value is link.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="open" type="booleanType">
<xs:annotation><xs:documentation>Whether the element is expanded when the page loads;
in a group only the first open="true" counts.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="backgroundAttr"/>
</xs:complexType>
<xs:complexType name="fieldType">
<xs:annotation>
<xs:documentation>A field widget covering the documented input types. Date and time
values are timestamps; a time value must be given in UTC.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="mandatory" type="booleanType">
<xs:annotation><xs:documentation>Whether the field is mandatory, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="size" type="gridWidthType">
<xs:annotation><xs:documentation>Width of the input in grid units, 1 to 12; the rest
goes to the label. Without a label the input takes the full width.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Field label, default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="labelPositionAttr"/>
<xs:attribute name="max-length" type="xs:positiveInteger">
<xs:annotation><xs:documentation>Since v4.6: maximum character count for the types
email, text, password and url.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="max-value" type="xs:string">
<xs:annotation><xs:documentation>Highest value allowed; applies to number, date, time
and slider fields. Modelled as a string because the syntax depends on the field
type.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="min-value" type="xs:string">
<xs:annotation><xs:documentation>Lowest value allowed; applies to number, date, time
and slider fields.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="placeholder" type="xs:string">
<xs:annotation><xs:documentation>Placeholder shown while the value is empty, default
empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="readonly" type="booleanType">
<xs:annotation><xs:documentation>The field cannot be changed, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="step" type="xs:string">
<xs:annotation><xs:documentation>Since v4.6: interval for number fields and sliders.
A float field without step uses 0.01.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="tooltipAttr"/>
<xs:attribute name="type" type="fieldTypeName">
<xs:annotation><xs:documentation>Field type. The reference does not mark it as
mandatory, so it is modelled optional.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="value" type="xs:string">
<xs:annotation><xs:documentation>Initial value of the field.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="disabled-dates" type="xs:string">
<xs:annotation><xs:documentation>Since v4.7: disables dates for the date and datetime
types. An associative array with the keys days_of_month (1 to 31, 'last', or a
negative value counting back from the month end since v4.10) and days_of_week
(0 = Sunday to 6).</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="prefix" type="xs:string">
<xs:annotation><xs:documentation>Since v4.7: prefix for the field; not allowed for
the date, time and datetime types.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="suffix" type="xs:string">
<xs:annotation><xs:documentation>Since v4.7: suffix for the field; not allowed for
the date, time and datetime types.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-change" type="xs:string">
<xs:annotation><xs:documentation>Since v4.6: action run when the user changed the
value and the focus leaves the field.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-confirm" type="xs:string">
<xs:annotation><xs:documentation>Deprecated since v4.6: fired when Enter is pressed in
a search field. Use a form instead.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="filemanagerType">
<xs:annotation>
<xs:documentation>Since v4.7: a file manager rooted at the add-on data
directory.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="folder" type="xs:string">
<xs:annotation><xs:documentation>Subdirectory.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="preload" type="booleanType">
<xs:annotation><xs:documentation>Load the content immediately.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="selected" type="xs:string">
<xs:annotation><xs:documentation>Since v4.8: preselected subdirectory; ignored when
the directory does not exist.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="module" type="xs:string">
<xs:annotation><xs:documentation>Since v4.8: together with object-id, shows the
document directory of a module object such as a contact.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="object-id" type="xs:string">
<xs:annotation><xs:documentation>Since v4.8: ID of the object whose document
directory is shown.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="formType">
<xs:annotation>
<xs:documentation>Since v4.10: a form. Unlike HTML it is not submitted automatically;
on-submit must be attached explicitly. The reference documents no "allowed in", so
layout and column are accepted (its example places the form directly in
layout).</xs:documentation>
</xs:annotation>
<xs:group ref="boxContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="validate" type="booleanType">
<xs:annotation><xs:documentation>Since v4.10.33072: validate the contained widgets
automatically. Default false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-submit" type="xs:string">
<xs:annotation><xs:documentation>Action run when the user submits the form. The
{event} placeholder yields the values of the field, textarea, checkbox, timer,
selection and objectselection widgets keyed by their IDs.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="ganttType">
<xs:annotation>
<xs:documentation>Since v4.8: a Gantt chart, backed by an addon_gantt
instance.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="src" type="xs:string">
<xs:annotation><xs:documentation>Path of the chart class, relative to the add-on base
directory.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="query" type="xs:string">
<xs:annotation><xs:documentation>Parameters handed to the chart class, available there
in the request array.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="preload" type="booleanType">
<xs:annotation><xs:documentation>Load the data while the page loads instead of in a
follow-up AJAX request. Default false.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="graphType">
<xs:annotation>
<xs:documentation>A graph, backed by a class in the add-on.</xs:documentation>
</xs:annotation>
<xs:attribute name="src" type="xs:string">
<xs:annotation><xs:documentation>Path of the graph class, relative to the add-on base
directory.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="query" type="xs:string">
<xs:annotation><xs:documentation>Parameters handed to the graph class, available there
in the request array.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="preload" type="booleanType">
<xs:annotation><xs:documentation>Since v4.6: load the graph while the page loads
instead of on the browser client. Default false.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="gridType">
<xs:annotation>
<xs:documentation>A data table, backed by a class in the add-on.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="src" type="xs:string" use="required">
<xs:annotation><xs:documentation>Path of the data table class, relative to the add-on
base directory. The reference marks this attribute mandatory ("*").</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="query" type="xs:string">
<xs:annotation><xs:documentation>Parameters handed to the grid class, available there
in the request array.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="preload" type="booleanType">
<xs:annotation><xs:documentation>Since v4.6: load the grid while the page loads
instead of on the client. Default false.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="headlineType">
<xs:annotation>
<xs:documentation>An ordinary HTML heading.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="icon" type="xs:string">
<xs:annotation><xs:documentation>Font Awesome 4 icon shown left of the heading, given
without the leading "fa-"; its size follows the heading size. Default
empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Heading text, default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="value" type="xs:string">
<xs:annotation><xs:documentation>Since v4.7: the text to display, default
empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="size" type="headlineSizeType">
<xs:annotation><xs:documentation>Font size, 1 to 6.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="tooltipAttr"/>
<xs:attributeGroup ref="hPositionAttr"/>
</xs:complexType>
<xs:complexType name="imageType">
<xs:annotation>
<xs:documentation>Since v4.6: an image.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Label of the image; the reference describes it as
"the text of the heading". Default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="src" type="xs:string">
<xs:annotation><xs:documentation>Path of the image inside the add-on.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="size" type="remOrPercentType">
<xs:annotation><xs:documentation>Since v4.7: width in rem or as a percentage; the
height follows the original aspect ratio.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="tooltipAttr"/>
<xs:attribute name="on-press" type="xs:string">
<xs:annotation><xs:documentation>Action run when the image is clicked; it receives the
parameters self::offset_x and self::offset_y.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="labelType">
<xs:annotation>
<xs:documentation>A caption for another element, e.g. a checkbox; the element text is
the caption.</xs:documentation>
</xs:annotation>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="for" type="idType" use="required">
<xs:annotation><xs:documentation>ID of the element the label refers to. The
reference does not mark it mandatory, but the element has no other purpose.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="listType">
<xs:annotation>
<xs:documentation>Since v4.6: a list view whose entries the user can move, delete and
deactivate. Record IDs must not be 0.</xs:documentation>
</xs:annotation>
<xs:group ref="listContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="data-id" type="xs:string">
<xs:annotation><xs:documentation>Deprecated up to v4.7: the data shown in the list.
The reference's own example passes it without the leading dollar sign, so no
pattern is enforced.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="data" type="xs:string">
<xs:annotation><xs:documentation>Since v4.7: the data shown in the list.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="size" type="xs:positiveInteger">
<xs:annotation><xs:documentation>Height of one row in pixels, default 30.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="template" type="xs:string">
<xs:annotation><xs:documentation>Row template; only very primitive templates are
possible. Default {title}.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="items-moveable" type="booleanType">
<xs:annotation><xs:documentation>Whether entries may be moved, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="items-deleteable" type="booleanType">
<xs:annotation><xs:documentation>Whether entries may be deleted, default false. A
single entry opts out with deleteable=false in the data.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="items-deactivateable" type="booleanType">
<xs:annotation><xs:documentation>Whether entries may be deactivated, default false. A
single entry opts out with deactivateable=false in the data.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-change" type="xs:string">
<xs:annotation><xs:documentation>Action run when an entry was moved.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-edit" type="xs:string">
<xs:annotation><xs:documentation>Action run when the edit button of an entry is
pressed; the button is added by specifying this event.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-delete" type="xs:string">
<xs:annotation><xs:documentation>Action run when the user deletes an entry.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-press" type="xs:string">
<xs:annotation><xs:documentation>Action run when the user clicks an entry.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="listbuttonType">
<xs:annotation>
<xs:documentation>Since v4.6: extends list entries with an icon button.</xs:documentation>
</xs:annotation>
<xs:attribute name="name" type="xs:string" use="required">
<xs:annotation><xs:documentation>Internal identifier of the button, not its display
text.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="icon" type="xs:string">
<xs:annotation><xs:documentation>Icon shown as the button.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-press" type="xs:string">
<xs:annotation><xs:documentation>Action run when the user presses the
button.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="listfieldType">
<xs:annotation>
<xs:documentation>A selection backed by a predefined CRM list. The reference says
"verfügbar ab v4.5 (bis v4.5)" and recommends &lt;selection&gt; instead.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="empty-value" type="xs:string">
<xs:annotation><xs:documentation>Value when nothing is selected.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Field label, default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="labelPositionAttr"/>
<xs:attribute name="list-id" type="xs:string">
<xs:annotation><xs:documentation>ID of the CRM list, given with a leading dollar
sign.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="mandatory" type="booleanType">
<xs:annotation><xs:documentation>Marks the field as mandatory, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="multiple" type="booleanType">
<xs:annotation><xs:documentation>Whether several entries may be selected, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="readonly" type="booleanType">
<xs:annotation><xs:documentation>The field cannot be changed, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="size" type="gridWidthType">
<xs:annotation><xs:documentation>Width of the input in grid units, 1 to
12.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="tooltipAttr"/>
<xs:attribute name="type" type="selectionDisplayType">
<xs:annotation><xs:documentation>box or expandable, default box.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-change" type="xs:string">
<xs:annotation><xs:documentation>Action run when the value changed.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="objectSelectionType">
<xs:annotation>
<xs:documentation>Since v4.6: a search and token field for CRM objects.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="amount" type="xs:positiveInteger">
<xs:annotation><xs:documentation>Maximum number of entries offered for
selection.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Field label, default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="labelPositionAttr"/>
<xs:attribute name="module" type="objectModuleName" use="required">
<xs:annotation><xs:documentation>Module to search in. The reference states that this
attribute is mandatory.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="multiple" type="booleanType">
<xs:annotation><xs:documentation>Whether several entries may be selected, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="new-button" type="booleanType">
<xs:annotation><xs:documentation>Shows the button for adding a new object, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="readonly" type="booleanType">
<xs:annotation><xs:documentation>The field cannot be changed, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="size" type="gridWidthType">
<xs:annotation><xs:documentation>Width of the input in grid units, 1 to
12.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="tooltipAttr"/>
<xs:attribute name="value" type="xs:string">
<xs:annotation><xs:documentation>Semicolon-separated list of selected objects; only
in combination with multiple. Default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="mandatory" type="booleanType">
<xs:annotation><xs:documentation>Whether the field is mandatory.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="data-id" type="xs:string">
<xs:annotation><xs:documentation>Object ID to link when the new button is clicked,
default 0.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="id-param" type="xs:string">
<xs:annotation><xs:documentation>Name of the parameter that receives the object ID
from data-id, default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-change" type="xs:string">
<xs:annotation><xs:documentation>Action run when the value changed.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="optionType">
<xs:annotation>
<xs:documentation>An entry of a &lt;selection&gt;; allowed nowhere else. The ID need
not be unique across selections but should not collide with the rest of the
template.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="value" type="xs:string">
<xs:annotation><xs:documentation>Value returned when the entry is
selected.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Label shown for this entry.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="selected" type="booleanType">
<xs:annotation><xs:documentation>Whether the entry is initially selected, default
false. In a single-select field the last selected entry wins.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="disabled" type="booleanType">
<xs:annotation><xs:documentation>Since v5.2: greys the entry out so it cannot be
selected, default false.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="selectionType">
<xs:annotation>
<xs:documentation>A selection, optionally multiple, filled either from &lt;option&gt;
children or from an assignment. Inside a toolbar the type is always
expandable.</xs:documentation>
</xs:annotation>
<xs:group ref="selectionContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="data-id" type="xs:string">
<xs:annotation><xs:documentation>Deprecated up to v4.7: ID of the assignment holding
the data, with a leading dollar sign.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="data" type="xs:string">
<xs:annotation><xs:documentation>Since v4.7: alias for options.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="options" type="xs:string">
<xs:annotation><xs:documentation>Since v4.6: ID of the assignment holding the options,
with a leading dollar sign.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="list-id" type="xs:string">
<xs:annotation><xs:documentation>Since v4.6: ID of a CRM list, with a leading dollar
sign; the options then come from that list.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="empty-value" type="xs:string">
<xs:annotation><xs:documentation>Value when nothing is selected; only valid when
multiple is false. Default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Field label, default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="labelPositionAttr"/>
<xs:attribute name="mandatory" type="booleanType">
<xs:annotation><xs:documentation>Marks the field as mandatory, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="multiple" type="booleanType">
<xs:annotation><xs:documentation>Whether several entries may be selected, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="placeholder" type="xs:string">
<xs:annotation><xs:documentation>Placeholder; only available when the field is
expandable and not multiple. Default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="readonly" type="booleanType">
<xs:annotation><xs:documentation>The field cannot be changed, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="size" type="gridWidthType">
<xs:annotation><xs:documentation>Width of the input in grid units, 1 to
12.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="tooltipAttr"/>
<xs:attribute name="type" type="selectionDisplayType">
<xs:annotation><xs:documentation>box or expandable, default box.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="selected" type="xs:string">
<xs:annotation><xs:documentation>Initially selected entries: one ID or several
separated by semicolons. Alternative to marking the entries
themselves.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-change" type="xs:string">
<xs:annotation><xs:documentation>Action run when the value changed.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="summaryType">
<xs:annotation>
<xs:documentation>Since v5.4: the heading of a &lt;details&gt; widget. The reference
does not enumerate the allowed child tags; its example shows &lt;text&gt;.</xs:documentation>
</xs:annotation>
<xs:group ref="summaryContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attributeGroup ref="backgroundAttr"/>
<xs:attribute name="hover" type="booleanType">
<xs:annotation><xs:documentation>Whether a striking hover effect spans the whole row;
true or false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="font-size" type="summaryFontSizeType">
<xs:annotation><xs:documentation>Font size of the heading.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="textType">
<xs:annotation>
<xs:documentation>An ordinary text.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="text" type="xs:string">
<xs:annotation><xs:documentation>Deprecated, see value. Default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="value" type="xs:string">
<xs:annotation><xs:documentation>Since v4.7: the text to display, default
empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hiddenAttr"/>
</xs:complexType>
<xs:complexType name="textareaType">
<xs:annotation>
<xs:documentation>A multi-line text input.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Field label.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="labelPositionAttr"/>
<xs:attribute name="max-length" type="xs:positiveInteger">
<xs:annotation><xs:documentation>Maximum character count of the
input.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="placeholder" type="xs:string">
<xs:annotation><xs:documentation>Placeholder shown while the input is empty, default
empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="tooltipAttr"/>
<xs:attribute name="value" type="xs:string">
<xs:annotation><xs:documentation>The text to display, default empty.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="mandatory" type="booleanType">
<xs:annotation><xs:documentation>Marks the field as mandatory, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="readonly" type="booleanType">
<xs:annotation><xs:documentation>The field cannot be changed, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="height" type="xs:string">
<xs:annotation><xs:documentation>Height of the input. The reference names no unit, so
the value is not restricted.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="resizable" type="booleanType">
<xs:annotation><xs:documentation>Whether the user may enlarge the field, default
false.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="timelineType">
<xs:annotation>
<xs:documentation>Since v4.7: a timeline, backed by a class in the add-on. The
reference's own example renders a &lt;grid&gt; instead, a documentation
slip.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attribute name="src" type="xs:string">
<xs:annotation><xs:documentation>Path of the data table class, relative to the add-on
base directory.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="query" type="xs:string">
<xs:annotation><xs:documentation>Parameters handed to the timeline class, available
there in the request array.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="preload" type="booleanType">
<xs:annotation><xs:documentation>Load the timeline while the page loads instead of on
the browser client. Default false.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="timerType">
<xs:annotation>
<xs:documentation>Since v4.6: a timer for recording times; only one timer can be
active at a time.</xs:documentation>
</xs:annotation>
<xs:attributeGroup ref="idAttr"/>
<xs:attributeGroup ref="hiddenAttr"/>
<xs:attribute name="init-progress" type="booleanType">
<xs:annotation><xs:documentation>Whether the timer starts automatically when the
window opens; TRUE or FALSE.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="label" type="xs:string">
<xs:annotation><xs:documentation>Timer label.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attributeGroup ref="labelPositionAttr"/>
<xs:attribute name="owner-id" type="idType">
<xs:annotation><xs:documentation>ID of the field in which the timer stores the elapsed
time as decimal hours; used by on-autosave.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="size" type="remType">
<xs:annotation><xs:documentation>Width of the timer in rem.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="type" type="timerTypeName">
<xs:annotation><xs:documentation>Timer type: default or clock.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="value" type="xs:nonNegativeInteger">
<xs:annotation><xs:documentation>Start value in seconds, default 0.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="on-autosave" type="xs:string">
<xs:annotation><xs:documentation>Action run once 36 seconds (0.01 hours) have
elapsed.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<!-- ====================================================================
Control structures
==================================================================== -->
<xs:complexType name="ifType">
<xs:annotation>
<xs:documentation>A branch depending on condition. condition is either a previously
defined assignment or one of the operators not, and, or, eq, ne, lt, le, gt, ge,
which work with left and right. The reference's legend marks left mandatory for
every operator and right mandatory for all operators except not; XSD 1.0 cannot
express that dependency, so both are modelled optional. The reference documents
&lt;elseif&gt; only by name, so it reuses this type.</xs:documentation>
</xs:annotation>
<xs:group ref="anyContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attribute name="condition" type="xs:string" use="required">
<xs:annotation><xs:documentation>Assignment or operator deciding the
branch.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="left" type="xs:string">
<xs:annotation><xs:documentation>Left operand.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="right" type="xs:string">
<xs:annotation><xs:documentation>Right operand.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="elseType">
<xs:annotation>
<xs:documentation>The fallback branch of an if/elseif chain. The reference lists it in
the heading of section 2.4.1 only and documents no attributes.</xs:documentation>
</xs:annotation>
<xs:group ref="anyContent" minOccurs="0" maxOccurs="unbounded"/>
</xs:complexType>
<xs:complexType name="forType">
<xs:annotation>
<xs:documentation>A loop over an assignment array.</xs:documentation>
</xs:annotation>
<xs:group ref="anyContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:attribute name="data-id" type="xs:string" use="required">
<xs:annotation><xs:documentation>Name of the assignment holding the array to
iterate.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="item" type="xs:string">
<xs:annotation><xs:documentation>Name of the runtime variable holding the current
entry.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="key" type="xs:string">
<xs:annotation><xs:documentation>Name of the runtime variable holding the current
index; numeric or alphanumeric.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="name" type="xs:string">
<xs:annotation><xs:documentation>Name of the runtime variable holding the iteration
information as an array with the keys key, item, is_first and
is_last.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="assignType">
<xs:annotation>
<xs:documentation>Assigns a value to a runtime variable.</xs:documentation>
</xs:annotation>
<xs:attribute name="var" type="xs:string" use="required">
<xs:annotation><xs:documentation>Name of the runtime variable.</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute name="value" type="xs:string">
<xs:annotation><xs:documentation>Value assigned to the variable.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="includeType">
<xs:annotation>
<xs:documentation>Includes another template at this position. The variables the
included template needs must be defined in the view.</xs:documentation>
</xs:annotation>
<xs:attribute name="src" type="xs:string" use="required">
<xs:annotation><xs:documentation>Template to include, without the xml
extension.</xs:documentation></xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="snippetType">
<xs:annotation>
<xs:documentation>The reference names &lt;snippet&gt; only in the "allowed in" list of
&lt;row&gt; ("und (Ab v4.7) &lt;snippet&gt;") and never documents it. Its content is
modelled like a layout container and its attributes are left open on
purpose.</xs:documentation>
</xs:annotation>
<xs:group ref="boxContent" minOccurs="0" maxOccurs="unbounded"/>
<xs:anyAttribute processContents="skip"/>
</xs:complexType>
<!-- ====================================================================
Root element
==================================================================== -->
<xs:element name="layout" type="layoutType">
<xs:annotation>
<xs:documentation>Root element of a template. It is the only element allowed at the
document root.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:schema>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment