Field Formatter API

Define Field API formatter types.

Field API formatters specify how fields are displayed when the entity to which the field is attached is displayed. Fields of a given field type may be displayed using more than one formatter. In this case, the Field UI module allows the site builder to choose which formatter to use.

Formatters are Plugins managed by the \Drupal\Core\Field\FormatterPluginManager class. A formatter is a plugin attributed with class \Drupal\Core\Field\Attribute\FieldFormatter that implements \Drupal\Core\Field\FormatterInterface (in most cases, by subclassing \Drupal\Core\Field\FormatterBase). Formatter plugins need to be in the namespace \Drupal\{your_module}\Plugin\Field\FieldFormatter.

See also

field

Field Types API

Field Widget API

Plugin API

Parent topics

Hooks
Define functions that alter the behavior of Drupal core.

File

core/modules/field/field.api.php, line 332

Functions

Title File name Summary
hook_field_formatter_info_alter core/modules/field/field.api.php Perform alterations on Field API formatter types.

Classes

Title File name Summary
FieldFormatter core/lib/Drupal/Core/Field/Annotation/FieldFormatter.php Defines a FieldFormatter annotation object.
FieldFormatter core/lib/Drupal/Core/Field/Attribute/FieldFormatter.php Defines a FieldFormatter attribute for plugin discovery.
FormatterBase core/lib/Drupal/Core/Field/FormatterBase.php Base class for 'Field formatter' plugin implementations.
FormatterPluginManager core/lib/Drupal/Core/Field/FormatterPluginManager.php Plugin type manager for field formatters.

Interfaces

Title File name Summary
FormatterInterface core/lib/Drupal/Core/Field/FormatterInterface.php Interface definition for field formatter plugins.