Email

The Email type creates an input field, which is validated against an email pattern. If the input does not contain a valid email address, a flash message warning will be displayed.

Settings

Name	Type	Default
default	string	''
placeholder	string	''
required	boolean	false
searchable	boolean	true
autocomplete	boolean
behaviour.allowLanguageSynchronization	boolean	false
eval	string
fieldControl	object
fieldInformation	object
fieldWizard	object
mode	string
nullable	boolean	false
readOnly	boolean	false
size	integer	30
valuePicker	object

default

Type: string
Default: ''

Default value set if a new record is created.

placeholder

Type: string
Default: ''

Placeholder text for the field. Can also be used as automatic language key in labels.xlf. See here for more information.

required

Type: boolean
Default: false

If set, the field becomes mandatory.

searchable

Type: boolean
Default: true

If set to false, the field will not be considered in backend search.

autocomplete

Type: boolean

Enables or disables browser autocomplete for the field.

behaviour.allowLanguageSynchronization

Type: boolean
Default: false

Allows to select if localization uses custom or default language value.

eval

Type: string

Configuration of field evaluation. For example trim to strip whitespace from the value before saving.

fieldControl

Type: object

See TCA fieldControl.

fieldInformation

Type: object

See TCA fieldInformation.

fieldWizard

Type: object

See TCA fieldWizard.

mode

Type: string

When set to useOrOverridePlaceholder, a checkbox appears above the field allowing the user to override the placeholder value.

nullable

Type: boolean
Default: false

Allows the database field to store a NULL value.

readOnly

Type: boolean
Default: false

Renders the field in a way that the user can see the value but cannot edit it.

size

Type: integer
Default: 30

Abstract width of the input field. Minimum 10, maximum 50.

valuePicker

Type: object

Renders a select box next to the field from which predefined values can be inserted. Requires an items array of objects with label and value keys.

Example:

valuePicker:
  items:
    - label: 'Support'
      value: 'support@example.com'
    - label: 'Sales'
      value: 'sales@example.com'

Example

Minimal

name: example/email
fields:
  - identifier: email
    type: Email

Advanced / use case

name: example/email
fields:
  - identifier: email
    type: Email
    autocomplete: true
    default: 'developer@localhost.de'
    placeholder: 'Enter your email address'
    required: true