Text Field

A text field collects a single line of free text, the usual choice for a short, unconstrained value such as a name or an identifier. Optional keys bound and validate what the author enters. minLength and maxLength limit its length, and regex requires it to match a regular expression. In YAML its type is text-field.

Key	Value	Presence	Meaning
minLength	integer	optional	Minimum length.
maxLength	integer	optional	Maximum length.
regex	string	optional	A pattern the value must match.
default	string	optional	Default value.
values	sequence	optional	A list of permitted literal values.

These keys are specific to a text field. Inside a template or element, the field also carries a configuration block for its parent-relative settings, such as required and propertyIri; see Fields: Core Structure.

- key: study-id
  type: text-field
  name: Study ID
  minLength: 2
  maxLength: 10
  configuration:
    required: true
    propertyIri: https://schema.org/identifier

A text field may also restrict its value to a fixed list of literals, turning it into a chooser among preset strings. Each entry has a label, and one may be marked selected as the default.

- key: phase
  type: text-field
  name: Phase
  values:
  - label: Phase I
    selected: true
  - label: Phase II