public function BaseFieldDefinition::setDisplayOptions

public BaseFieldDefinition::setDisplayOptions($display_context, array $options)

Sets the display options for the field in forms or rendered entities.

This enables generic rendering of the field with widgets / formatters, including automated support for "In place editing", and with optional configurability in the "Manage display" / "Manage form display" UI screens.

Unless this method is called, the field remains invisible (or requires ad-hoc rendering logic).

Parameters

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

array $options: An array of display options. Refer to \Drupal\Core\Field\FieldDefinitionInterface::getDisplayOptions() for a list of supported keys. The options should include at least a 'weight', or specify 'type' = 'hidden'. The 'default_widget' / 'default_formatter' for the field type will be used if no 'type' is specified.

Return value

static The object itself for chaining.

File

core/lib/Drupal/Core/Field/BaseFieldDefinition.php, line 396

Class

BaseFieldDefinition
A class for defining entity fields.

Namespace

Drupal\Core\Field

Code

public function setDisplayOptions($display_context, array $options) {
  $this->definition['display'][$display_context]['options'] = $options;
  return $this;
}

© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/core!lib!Drupal!Core!Field!BaseFieldDefinition.php/function/BaseFieldDefinition::setDisplayOptions/8.1.x