Tel
A phone number input field
The phone field creates a text input with the type tel
and a custom phone icon.

Example
fields:
phone:
label: Phone
type: tel
Field properties
Name | Type | Default | Description |
---|---|---|---|
$after | mixed |
null
|
Optional text that will be shown after the input |
$autocomplete | string |
'tel'
|
Sets the HTML5 autocomplete attribute |
$autofocus | bool |
null
|
Sets the focus on this field when the form loads. Only the first field with this label gets |
$before | mixed |
null
|
Optional text that will be shown before the input |
$default | mixed |
null
|
Default value for the field, which will be used when a page/file/user is created |
$disabled | bool |
null
|
If true , the field is no longer editable and will not be saved |
$font | string |
null
|
Sets the font family (sans or monospace) |
$help | mixed |
null
|
Optional help text below the field |
$icon | string |
'phone'
|
Changes the phone icon |
$label | mixed |
null
|
The field label can be set as string or associative array with translations |
$maxlength | int |
null
|
Maximum number of allowed characters |
$minlength | int |
null
|
Minimum number of required characters |
$pattern | string |
null
|
A regular expression, which will be used to validate the input |
$placeholder | mixed |
null
|
Optional placeholder value that will be shown when the field is empty |
$required | bool |
null
|
If true , the field has to be filled in correctly to be saved. |
$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 | mixed |
null
|
Conditions when the field will be shown (since 3.1.0) |
$width | string |
'1/1'
|
The width of the field in the field grid, e.g. 1/1 , 1/2 , 1/3 , 1/4 , 2/3 , 3/4
|
How to use in templates/snippets
Just printing the phone number:
<?php if ($page->phone()->isNotEmpty()): ?>
<dt>Phone</dt>
<dd><?= $page->phone() ?></dd>
<?php endif ?>
Generating an a
tag for the phone number:
<?php if ($page->phone()->isNotEmpty()): ?>
<dt>Phone</dt>
<dd><?= Html::tel($page->phone()) ?></dd>
<?php endif ?>