appearance

Type
array
Path
$GLOBALS['TCA'][$table]['columns'][$field]['config']
Scope
Display

Has information about the appearance, namely:

allowedOptions (array)

New in version 12.0

Formerly known as blindLinkFields of linkPopup.options, which was a deny-list. Now this is an include-list.

Display certain options in the link browser. To allow all options in the Link Browser, skip this configuration or set it to ['*']. To deny all options in the Link Browser, set this configuration to [] (empty array).

class
Custom CSS classes for the link
params
Additional link parameters
target
Either empty, _top or _blank
title
The title attribute of the link
rel
The link relationship. Only available for RTE enabled fields and if buttons.link.relAttribute.enabled is enabled in the RTE YAML configuration.
// Display only 'class' and 'params'
'appearance' => [
    'allowedOptions' => ['class', 'params'],
],
Copied! 
// Allow all options (or skip this option).
'appearance' => [
    'allowedOptions' => ['*'],
],
Copied! 
// Deny all options
'appearance' => [
    'allowedOptions' => [],
],
Copied!

New in version 12.3

For custom email links, the options can be restricted:

body
The body of an email can be pre-filled.
cc
The "cc" field can be pre-filled.
bcc:
The "bcc" field can be pre-filled.
subject:
The subject of an email can be pre-filled.
'appearance' => [
    'allowedOptions' => ['body', 'cc'],
],
Copied!
allowedExtensions (array)

New in version 12.0

Formerly known as allowedExtensions of linkPopup.options.

An array of allowed file extensions. To allow all extensions, skip this configuration or set it to ['*']. It's not possible to deny all extensions.

// Allow only jpg and png file extensions
'appearance' => [
    'allowedExtensions' => ['jpg', 'png'],
],
Copied! 
// Allow all file extensions (or skip this option).
'appearance' => [
    'allowedExtensions' => ['*'],
],
Copied!
browserTitle (string, LLL)

New in version 12.0

Formerly known as title of linkPopup.options.

Allows to set a different title attribute for the Link Browser icon, defaults to Link.

// Either provide a LLL-reference (recommended)
'appearance' => [
    'browserTitle' => 'LLL:EXT:Resources/Private/Language/locallang.xlf:my_custom_title',
],
Copied! 
// Or a simple string value
'appearance' => [
    'browserTitle' => 'My custom title',
],
Copied!
enableBrowser (boolean)

New in version 12.0

Formerly known as disabled of linkPopup.

The Link Browser is enabled by default. To disable the Link Browser altogether, set this option to false.

// Disable the link browser
'appearance' => [
    'enableBrowser' => false,
],
Copied!