Text

A standard, single-line input field

• Read the guide

The text field creates a standard text input

Example

fields:
  name:
    label: Name
    type: text

Field properties

Name	Type	Default	Description
after		–	Optional text that will be shown after the input
autofocus	bool	–	Sets the focus on this field when the form loads. Only the first field with this label gets
before		–	Optional text that will be shown before the input
converter		–	The field value will be converted with the selected converter before the value gets saved. Available converters: lower, upper, ucfirst, slug
counter	bool	true	Shows or hides the character counter in the top right corner
default		–	Default value for the field, which will be used when a page/file/user is created
disabled	bool	–	If true, the field is no longer editable and will not be saved
help		–	Optional help text below the field
icon	string	–	Optional icon that will be shown at the end of the field
label		–	The field label can be set as string or associative array with translations
maxlength	int	–	Maximum number of allowed characters
minlength	int	–	Minimum number of required characters
pattern	string	–	A regular expression, which will be used to validate the input
placeholder		–	Optional placeholder value that will be shown when the field is empty
required	bool	–	If true, the field has to be filled in correctly to be saved.
spellcheck	bool	false	If false, spellcheck will be switched off
translate	bool	true	If false, the field will be disabled in non-default languages and cannot be translated. This is only relevant in multi-language setups.
when		–	Conditions when the field will be shown (since 3.1.0)
width	string	1/1	The width of the field in the field grid. Available widths: 1/1, 1/2, 1/3, 1/4, 2/3, 3/4

Length restrictions

You can control the maximal and/or minimal length of the entered text by using the maxlength and/or minlength option. A handy indicator of the current text length will be displayed in the upper right corner.

fields:
  name:
    label: Name
    type: text
    minlength: 10
    maxlength: 1000

How to use in templates/snippets

Simple usage:

<?= $page->text() ?>

As with other fields, you can use Kirby's field methods to manipulate the output. Here are a few examples:

Escape the field value:

<?= $page->text()->escape() ?>

Convert to valid HTML:

<?= $page->text()->html() ?>

With fallback text if field is empty:

<?= $page->text()->or('Some fallback text') ?>

For more field manipulations, check out Kirby's field methods.