interface InlineFormInterface in Inline Entity Form 8

Defines the interface for inline form handlers.

Hierarchy

• interface \Drupal\Core\Entity\EntityHandlerInterface
  • interface \Drupal\inline_entity_form\InlineFormInterface

1 file declares its use of InlineFormInterface

EntityInlineForm.php in src/Form/EntityInlineForm.php

File

src/InlineFormInterface.php, line 12

Namespace

Drupal\inline_entity_form

interface InlineFormInterface extends EntityHandlerInterface {

  /**
   * Gets the entity type managed by this handler.
   *
   * @return \Drupal\Core\Entity\EntityTypeInterface
   *   The entity type.
   */
  public function getEntityType();

  /**
   * Gets the entity type labels (singular, plural).
   *
   * @todo Remove when #1850080 lands and IEF starts requiring Drupal 8.1.x
   *
   * @return array
   *   An array with two values:
   *     - singular: The lowercase singular label.
   *     - plural: The lowercase plural label.
   */
  public function getEntityTypeLabels();

  /**
   * Gets the label of the given entity.
   *
   * @param \Drupal\Core\Entity\EntityInterface $entity
   *   The given entity.
   *
   * @return string
   *   The entity label.
   */
  public function getEntityLabel(EntityInterface $entity);

  /**
   * Gets the columns used to represent an entity in the IEF table.
   *
   * Modules can alter the output of this method through
   * hook_inline_entity_form_table_fields_alter().
   *
   * @param string[] $bundles
   *   An array of allowed bundles for this widget.
   *
   * @return array
   *   An array of data about table columns keyed by column name. Each column is
   *   represented by an associative array containing the following keys:
   *   - type: One of 'label', 'field' or 'callback', which indicates how this
   *     column should be handled:
   *      - 'label': The entity's label.
   *      - 'field': A field value from the entity. The name of the field is
   *        given by the key in this array.
   *      - 'callback': A callback, given by the 'callback' property.
   *     @see template_preprocess_inline_entity_form_entity_table() for the
   *     handling of these.
   *   - label: the title of the table field's column in the IEF table.
   *   - weight: the sort order of the column in the IEF table.
   *   - display_options: (optional) used for 'field' type table columns, an
   *     array of display settings. See EntityViewBuilderInterface::viewField().
   *   - callback: for 'callback' type table columns, a callable that returns a
   *     renderable array.
   *   - callback_arguments: (optional) an array of additional arguments to pass
   *     to the callback. The entity and the theme variables are always passed
   *     as as the first two arguments.
   */
  public function getTableFields($bundles);

  /**
   * Checks whether tabledrag should be enabled for the given table.
   *
   * @param array $element
   *   The form element representing the IEF table.
   *
   * @return bool
   *   TRUE if tabledrag should be enabled, FALSE otherwise.
   */
  public function isTableDragEnabled($element);

  /**
   * Builds the entity form.
   *
   * @param array $entity_form
   *   The entity form, containing the following basic properties:
   *   - #entity: The entity for the current entity form.
   *   - #op: The form operation. 'add' or 'edit'.
   *   - #form_mode: The form mode used to display the entity form.
   *   - #parents: Identifies the position of the entity form in the overall
   *     parent form, and identifies the location where the field values are
   *     placed within $form_state->getValues().
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The form state of the parent form.
   */
  public function entityForm(array $entity_form, FormStateInterface $form_state);

  /**
   * Validates the entity form.
   *
   * @param array $entity_form
   *   The entity form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The form state of the parent form.
   */
  public function entityFormValidate(array &$entity_form, FormStateInterface $form_state);

  /**
   * Handles the submission of an entity form.
   *
   * @param array $entity_form
   *   The entity form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The form state of the parent form.
   */
  public function entityFormSubmit(array &$entity_form, FormStateInterface $form_state);

  /**
   * Saves the given entity.
   *
   * @param \Drupal\Core\Entity\EntityInterface $entity
   *   The entity.
   *
   * @return int
   *   Either SAVED_NEW or SAVED_UPDATED, depending on the operation performed.
   */
  public function save(EntityInterface $entity);

  /**
   * Delete permanently saved entities.
   *
   * @param int[] $ids
   *   An array of entity IDs.
   * @param array $context
   *   Available keys:
   *   - parent_entity_type: The type of the parent entity.
   *   - parent_entity: The parent entity.
   */
  public function delete($ids, $context);

}

Members

Name	Modifiers	Type	Description	Overrides
EntityHandlerInterface::createInstance	public static	function	Instantiates a new instance of this entity handler.	13
InlineFormInterface::delete	public	function	Delete permanently saved entities.	1
InlineFormInterface::entityForm	public	function	Builds the entity form.	1
InlineFormInterface::entityFormSubmit	public	function	Handles the submission of an entity form.	1
InlineFormInterface::entityFormValidate	public	function	Validates the entity form.	1
InlineFormInterface::getEntityLabel	public	function	Gets the label of the given entity.	1
InlineFormInterface::getEntityType	public	function	Gets the entity type managed by this handler.	1
InlineFormInterface::getEntityTypeLabels	public	function	Gets the entity type labels (singular, plural).	1
InlineFormInterface::getTableFields	public	function	Gets the columns used to represent an entity in the IEF table.	1
InlineFormInterface::isTableDragEnabled	public	function	Checks whether tabledrag should be enabled for the given table.	1
InlineFormInterface::save	public	function	Saves the given entity.	1