You are here

public function FieldConfig::getDisplayOptions in Drupal 8

Same name and namespace in other branches
  1. 9 core/modules/field/src/Entity/FieldConfig.php \Drupal\field\Entity\FieldConfig::getDisplayOptions()

Returns the default display options for the field.

If the field's display is configurable, the returned display options act as default values and may be overridden via the respective entity display. Otherwise, the display options will be applied to entity displays as is.

Parameters

string $display_context: The display context. Either 'view' or 'form'.

Return value

array|null The array of display options for the field, or NULL if the field is not displayed. The following key/value pairs may be present:

  • label: (string) Position of the field label. The default 'field' theme implementation supports the values 'inline', 'above' and 'hidden'. Defaults to 'above'. Only applies to 'view' context.
  • region: (string) The region the field is in, or 'hidden'. If not specified, the default region will be used.
  • type: (string) The plugin (widget or formatter depending on $display_context) to use. If not specified or if the requested plugin is unknown, the 'default_widget' / 'default_formatter' for the field type will be used. Previously 'hidden' was a valid value, it is now deprecated in favor of specifying 'region' => 'hidden'.
  • settings: (array) Settings for the plugin specified above. The default settings for the plugin will be used for settings left unspecified.
  • third_party_settings: (array) Settings provided by other extensions through hook_field_formatter_third_party_settings_form().
  • weight: (float) The weight of the element. Not needed if 'type' is 'hidden'.

The defaults of the various display options above get applied by the used entity display.

Overrides FieldDefinitionInterface::getDisplayOptions

See also

\Drupal\Core\Entity\Display\EntityDisplayInterface

File

core/modules/field/src/Entity/FieldConfig.php, line 333

Class

FieldConfig
Defines the Field entity.

Namespace

Drupal\field\Entity

Code

public function getDisplayOptions($display_context) {

  // Hide configurable fields by default.
  return [
    'region' => 'hidden',
  ];
}