Defines a common interface for entity form controller classes.
Expanded class hierarchy of EntityFormControllerInterface
All classes that implement EntityFormControllerInterface
interface EntityFormControllerInterface extends BaseFormIdInterface {
/**
* Returns the code identifying the active form language.
*
* @param array $form_state
* An associative array containing the current state of the form.
*
* @return string
* The form language code.
*/
public function getFormLangcode(array $form_state);
/**
* Checks whether the current form language matches the entity one.
*
* @param array $form_state
* A keyed array containing the current state of the form.
*
* @return boolean
* Returns TRUE if the entity form language matches the entity one.
*/
public function isDefaultFormLangcode(array $form_state);
/**
* Returns the operation identifying the form controller.
*
* @return string
* The name of the operation.
*/
public function getOperation();
/**
* Returns the form display.
*
* @param array $form_state
* An associative array containing the current state of the form.
*
* @return \Drupal\entity\EntityFormDisplayInterface
* The current form display.
*/
public function getFormDisplay(array $form_state);
/**
* Sets the form display.
*
* Sets the form display which will be used for populating form element
* defaults.
*
* @param \Drupal\entity\EntityFormDisplayInterface $form_display
* The form display that the current form operates with.
* @param array $form_state
* An associative array containing the current state of the form.
*/
public function setFormDisplay(EntityFormDisplayInterface $form_display, array &$form_state);
/**
* Returns the form entity.
*
* The form entity which has been used for populating form element defaults.
*
* @param array $form_state
* An associative array containing the current state of the form.
*
* @return \Drupal\Core\Entity\EntityInterface
* The current form entity.
*/
public function getEntity();
/**
* Sets the form entity.
*
* Sets the form entity which will be used for populating form element
* defaults. Usually, the form entity gets updated by
* \Drupal\Core\Entity\EntityFormControllerInterface::submit(), however this may
* be used to completely exchange the form entity, e.g. when preparing the
* rebuild of a multi-step form.
*
* @param \Drupal\Core\Entity\EntityInterface $entity
* The entity the current form should operate upon.
*/
public function setEntity(EntityInterface $entity);
/**
* Builds an updated entity object based upon the submitted form values.
*
* For building the updated entity object the form's entity is cloned and
* the submitted form values are copied to entity properties. The form's
* entity remains unchanged.
*
* @see \Drupal\Core\Entity\EntityFormControllerInterface::getEntity()
*
* @param array $form
* A nested array form elements comprising the form.
* @param array $form_state
* An associative array containing the current state of the form.
*
* @return \Drupal\Core\Entity\EntityInterface
* An updated copy of the form's entity object.
*/
public function buildEntity(array $form, array &$form_state);
/**
* Validates the submitted form values of the entity form.
*
* @param array $form
* A nested array form elements comprising the form.
* @param array $form_state
* An associative array containing the current state of the form.
*/
public function validate(array $form, array &$form_state);
/**
* Updates the form's entity by processing this submission's values.
*
* Note: Before this can be safely invoked the entity form must have passed
* validation, i.e. only add this as form #submit handler if validation is
* added as well.
*
* @param array $form
* A nested array form elements comprising the form.
* @param array $form_state
* An associative array containing the current state of the form.
*/
public function submit(array $form, array &$form_state);
}
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
EntityFormControllerInterface:: |
public | function | Returns the code identifying the active form language. | 1 |
EntityFormControllerInterface:: |
public | function | Checks whether the current form language matches the entity one. | 1 |
EntityFormControllerInterface:: |
public | function | Returns the operation identifying the form controller. | 1 |
EntityFormControllerInterface:: |
public | function | Returns the form display. | 1 |
EntityFormControllerInterface:: |
public | function | Sets the form display. | 1 |
EntityFormControllerInterface:: |
public | function | Returns the form entity. | 1 |
EntityFormControllerInterface:: |
public | function | Sets the form entity. | 1 |
EntityFormControllerInterface:: |
public | function | Builds an updated entity object based upon the submitted form values. | 1 |
EntityFormControllerInterface:: |
public | function | Validates the submitted form values of the entity form. | 1 |
EntityFormControllerInterface:: |
public | function | Updates the form's entity by processing this submission's values. | 1 |
BaseFormIdInterface:: |
public | function | Returns a string identifying the base form. | 1 |
FormInterface:: |
public | function | Returns a unique string identifying the form. | 90 |
FormInterface:: |
public | function | Form constructor. | 36 |
FormInterface:: |
public | function | Form validation handler. | 27 |
FormInterface:: |
public | function | Form submission handler. | 55 |