interface DisplayInterface in Entity Browser 8

Defines the interface for entity browser displays.

Display plugins determine how a complete entity browser is delivered to the user. They wrap around and encapsulate the entity browser. Examples include:

• Displaying the entity browser on its own standalone page.
• Displaying the entity browser in an iframe.
• Displaying the entity browser in a modal dialog box.

Hierarchy

• interface \Drupal\Component\Plugin\PluginInspectionInterface; interface \Drupal\Component\Plugin\ConfigurableInterface; interface \Drupal\Core\Plugin\PluginFormInterface; interface \Drupal\Component\Plugin\DependentPluginInterface
  • interface \Drupal\entity_browser\DisplayInterface

1 file declares its use of DisplayInterface

EntityBrowserTest.php in tests/src/Kernel/Extension/EntityBrowserTest.php

File

src/DisplayInterface.php, line 21

Namespace

Drupal\entity_browser

interface DisplayInterface extends PluginInspectionInterface, ConfigurableInterface, PluginFormInterface, DependentPluginInterface {

  /**
   * Returns the display label.
   *
   * @return string
   *   The display label.
   */
  public function label();

  /**
   * Displays entity browser.
   *
   * This is the "entry point" for every non-entity browser code to interact
   * with it. It will take care about displaying entity browser in one way or
   * another.
   *
   * @param array $element
   *   A form element array containing basic properties for the entity browser
   *   element:
   *   - #eb_parents: The 'parents' space for the field in the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The form state object.
   * @param array $complete_form
   *   The form structure where entity browser is being attached to.
   * @param array $persistent_data
   *   (optional) Extra information to send to the Entity Browser Widget. This
   *   is needed as the widget may display after a new bootstrap, which would
   *   discard the current form state. Arbitrary values can be added and used
   *   by widgets, if needed.
   *   The expected array keys are "selected_entities" and "validators".
   *     - Drupal\Core\Entity\EntityInterface[] selected_entities
   *        An array of currently selected entities.
   *     - array validators
   *        An associative array mapping EntityBrowserWidgetValidation IDs to
   *        an array of options to pass to the plugin's validate method.
   *
   * @return array
   *   A render array.
   */
  public function displayEntityBrowser(array $element, FormStateInterface $form_state, array &$complete_form, array $persistent_data = []);

  /**
   * Indicates completed selection.
   *
   * Entity browser will call this function when selection is done. Display
   * plugin is responsible for fetching selected entities and sending them to
   * the initiating code.
   *
   * @param \Drupal\Core\Entity\EntityInterface[] $entities
   *   Array of selected entities.
   */
  public function selectionCompleted(array $entities);

  /**
   * Gets the uuid for this display.
   *
   * @return string
   *   The uuid string.
   */
  public function getUuid();

  /**
   * Sets the uuid for this display.
   *
   * @param string $uuid
   *   The uuid string.
   */
  public function setUuid($uuid);

}

Members

Name	Modifiers	Type	Description	Overrides
ConfigurableInterface::defaultConfiguration	public	function	Gets default configuration for this plugin.	11
ConfigurableInterface::getConfiguration	public	function	Gets this plugin's configuration.	12
ConfigurableInterface::setConfiguration	public	function	Sets the configuration for this plugin instance.	12
DependentPluginInterface::calculateDependencies	public	function	Calculates dependencies for the configured plugin.	19
DisplayInterface::displayEntityBrowser	public	function	Displays entity browser.	1
DisplayInterface::getUuid	public	function	Gets the uuid for this display.	1
DisplayInterface::label	public	function	Returns the display label.	1
DisplayInterface::selectionCompleted	public	function	Indicates completed selection.	1
DisplayInterface::setUuid	public	function	Sets the uuid for this display.	1
PluginFormInterface::buildConfigurationForm	public	function	Form constructor.	36
PluginFormInterface::submitConfigurationForm	public	function	Form submission handler.	32
PluginFormInterface::validateConfigurationForm	public	function	Form validation handler.	18
PluginInspectionInterface::getPluginDefinition	public	function	Gets the definition of the plugin implementation.	4
PluginInspectionInterface::getPluginId	public	function	Gets the plugin_id of the plugin instance.	2