Writer

Example

fields:
  text:
    label: Writer
    type: writer

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
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
inline	`bool`	`false`	Enables inline mode, which will not wrap new lines in paragraphs and creates hard breaks instead.
label		–	The field label can be set as string or associative array with translations
marks		`true`	Sets the allowed HTML formats. Available formats: `bold`, `italic`, `underline`, `strike`, `code`, `link`, `email`. Activate them all by passing `true`. Deactivate them all by passing `false`
nodes		–	Sets the allowed nodes. Available nodes: `paragraph`, `heading`, `bulletList`, `orderedList`. Activate/deactivate them all by passing `true`/`false`. Default nodes are `paragraph`, `heading`, `bulletList`, `orderedList`.
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.
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`

Inline mode

By default, the writer field will supports multiple paragraphs (<p>). In inline mode, hitting enter will create breaks instead of creating a new paragraph.

fields:
  text:
    type: writer
    inline: true

In inline mode, all nodes (see below) are disabled.

Choosing available marks

The writer field supports the following marks by default:

bold
italic
underline
strike
code
link
email (since v3.6.0)

fields:
  text:
    type: writer
    inline: true
    marks:
      - bold
      - italic
      - strike

Format/node options

Apart from paragraph nodes, the writer field supports headings and lists. You can fine-tune the writer field from your blueprint by defining the available block formats (nodes).

Unsupported formats will automatically be ignored when content is pasted and the toolbar will also not include the matching buttons.

fields:
  writer:
    type: writer
    nodes:
      - heading
      - bulletList
      - orderedList

How to use in templates/snippets

The content of the writer field is stored as plain HTML. To render the field in your template, echo the value.

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