Text areas & RTE

New in version 13.0

The according database fields for all render types are generated automatically.

Introduction

The text type is for multi-line text input, in the database ext_tables.sql files it is typically set to a TEXT column type. In the backend, it is rendered in various shapes: It can be rendered as a simple <textarea>, as a rich text editor (RTE), as a code block with syntax highlighting, and others.

The following renderTypes are available:

  • default: A simple text area or a rich text field is rendered, if no renderType is specified.
  • belayoutwizard: The backend layout wizard is displayed in order to edit records of table backend_layout in the backend.
  • codeEditor: This render type triggers a code highlighter.

    Changed in version 13.0

    In previous TYPO3 versions, the code editor was available via the system extension "t3editor". The functionality was moved into the system extension "backend". The render type t3editor was renamed to codeEditor. A TCA migration from the old value to the new one is in place.

  • textTable: The renderType = 'textTable' triggers a view to manage frontend table display in the backend. It is used for the "table" tt_content content element.

Simple text area

A simple text area or a rich text field is rendered, if no renderType is specified.

See render type "default" on how to configure such an editor.

EXT:styleguide/Configuration/TCA/tx_styleguide_elements_basic.php
[
    'columns' => [
        'text_4' => [
            'label' => 'text_4',
            'description' => 'cols=20, rows=2',
            'config' => [
                'type' => 'text',
                'cols' => 20,
                'rows' => 2,
            ],
        ],
    ],
]
Copied!

Rich text editor field

See property "enableRichtext" on how to configure such an editor.

EXT:styleguide/Configuration/TCA/tx_styleguide_elements_rte.php
[
    'columns' => [
        'rte_1' => [
            'label' => 'rte_1 description',
            'description' => 'field description',
            'config' => [
                'type' => 'text',
                'enableRichtext' => true,
            ],
        ],
    ],
]
Copied!

Code highlight editor

Code editor with highlighting HTML

Code editor with highlighting HTML

See codeEditor on how to configure such an editor.

[
    // ...
    'type' => 'text',
    'renderType' => 'codeEditor',
    // ...
]
Copied!

Backend layout editor

The backend layout wizard is displayed in order to edit records of table backend_layout in the backend.

See render type belayoutwizard on how to configure such an editor.

EXT:styleguide/Configuration/TCA/tx_styleguide_elements_basic.php
[
    'columns' => [
        'text_20' => [
            'label' => 'text_20',
            'description' => 'renderType=belayoutwizard',
            'config' => [
                'type' => 'text',
                'renderType' => 'belayoutwizard',
                'default' => '
backend_layout {
  colCount = 2
  rowCount = 2
  rows {
    1 {
      columns {
        1 {
          name = Left
          rowspan = 2
          colPos = 1
        }
        2 {
          name = Main
          colPos = 0
        }
      }
    }
    2 {
      columns {
        1 {
          name = Footer
          colPos = 24
        }
      }
    }
  }
}',
            ],
        ],
    ],
]
Copied!

Text field with renderType textTable

The table wizard allows to edit the code-like configuration of the tables with a visual editor.

See render type textTable on how to configure such an editor.

EXT:styleguide/Configuration/TCA/tx_styleguide_elements_basic.php
[
    'columns' => [
        'text_17' => [
            'label' => 'text_17',
            'description' => 'renderType=textTable',
            'config' => [
                'type' => 'text',
                'renderType' => 'textTable',
            ],
        ],
    ],
]
Copied!