appearance¶
- appearance ('type' => 'link')¶
- Path
$GLOBALS['TCA'][$table]['columns'][$field]['config']
- Type
array
- Scope
Display
Has information about the appearance, namely:
- allowedOptions (array)
New in version 12.0: Formerly known as
blindLinkFields
oflinkPopup.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[]
(emptyarray
).- 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'], ],
// Allow all options (or skip this option). 'appearance' => [ 'allowedOptions' => ['*'], ],
// Deny all options 'appearance' => [ 'allowedOptions' => [], ],
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'], ],
- allowedExtensions (array)
New in version 12.0: Formerly known as
allowedExtensions
oflinkPopup.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'], ],
// Allow all file extensions (or skip this option). 'appearance' => [ 'allowedExtensions' => ['*'], ],
- browserTitle (string, LLL)
New in version 12.0: Formerly known as
title
oflinkPopup.options
.Allows to set a different
title
attribute for the Link Browser icon, defaults toLink
.// Either provide a LLL-reference (recommended) 'appearance' => [ 'browserTitle' => 'LLL:EXT:Resources/Private/Language/locallang.xlf:my_custom_title', ],
// Or a simple string value 'appearance' => [ 'browserTitle' => 'My custom title', ],
- enableBrowser (boolean)
New in version 12.0: Formerly known as
disabled
oflinkPopup
.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, ],