projectdoc Toolbox

A type that specifies an ordered list of elements. A list usually has no duplicates, although there is no process to enforce this.

The elements of a list are single values.

Details

The constraints for single values apply for each element of the list.

Single Value

The definition of a single value may come in different forms. Often a value is simply added as the value of a parameter or property.

A single value may be an HTML fragment such as a link, if the element type supports HTML. This is the case for space and document properties, but not for macro parameters or doctype properties. For space and document properties exist a text (encoded by a $ suffix) and a normalized (encoded by a § suffix) version for a property value. In case of an HTML link the text version is the label, the normalized version is the URI of the link.

Since single values may be specified as members of a list they typically must not contain a comma. Also single values are matched in queries and therefore must not contain any characters that are significant in searches.

The following characters are typically not allowed.

  1. comma
  2. opening an closing bracket of any kind
  3. quotes or double quotes

The current version of the projectdoc Toolbox does not provide tools to escape characters. This may change in future versions so that the characters above may be allowed.

Data Types of this Type

Content Identifiers
A list of Content Identifiers.
Content Tags
A list of Content Tags.
CSS Classes
A list of CSS class names.
Document Names
A list of Document Names.
Document Titles
A list of Document Titles.
Macro Parameter Names
A list of Macro Parameter Names.
Property Control Names
A list of Property Control Names.
Property Control Values
A list of Property Control Values.
Property Names
A list of Property Names.
Strings
A list of Strings.

References

value-separator
Allows to specify an alternative value separator.
Using Commas in Property Values
Property values are inherently considered to be a list of strings. Typically this a good thing since it makes working with list of names very easy. Sometimes it makes things more difficult.