Text

The "Text" type generates a simple <input> field, possibly with additional features applied.

It corresponds with the TCA type='input' (default), however special variants are defined as own field types.

Properties

autocomplete

| Required: false | Type: boolean | Default: 'false' |

Controls the autocomplete attribute of a given input field. If set to true (default false), adds attribute autocomplete="on" to the input field allowing browser auto filling the field.

default

| Required: false | Type: string | Default: '' |

Default value set if a new record is created.

max

| Required: false | Type: integer | Default: '700' |

Value for the “maxlength” attribute of the <input> field. Javascript prevents adding more than the given number of characters.

placeholder

| Required: false | Type: string | Default: '' |

Placeholder text for the field.

required

| Required: false | Type: boolean | Default: 'false' |

If set, the field will become mandatory.

size

| Required: false | Type: integer | Default: '20' |

Abstract value for the width of the <input> field.

trim

| Required: false | Type: boolean | Default: 'false' |

If set, the PHP trim function is applied on the field's content.

valuePicker

| Required: false | Type: array | Default: '' |

Renders a select box with static values next to the input field. When a value is selected in the box, the value is transferred to the field. Keys:

items (array)

An array with selectable items. Each item is an array with the first being the value transferred to the input field, and the second being the label in the select drop-down (LLL reference possible).

Example:

valuePicker:
  items:
    'Want to join our team? Take the initiative!': Job offer general
    'We are looking for ...': Job offer specific

Example

group: common
fields:
  - identifier: text
    type: Text
    properties:
      autocomplete: false
      default: 'Default value'
      max: 15
      placeholder: 'Placeholder text'
      required: false
      size: 20
      trim: true
      valuePicker:
        items:
          'Want to join our team? Take the initiative!': Job offer general
          'We are looking for ...': Job offer specific