function hook_field_widget_form_alter

Same name and namespace in other branches
  1. 7.x modules/field/field.api.php \hook_field_widget_form_alter()
  2. 9 core/modules/field/field.api.php \hook_field_widget_form_alter()

Alter forms for field widgets provided by other modules.

This hook can only modify individual elements within a field widget and cannot alter the top level (parent element) for multi-value fields. In most cases, you should use hook_field_widget_multivalue_form_alter() instead and loop over the elements.


$element: The field widget form element as constructed by \Drupal\Core\Field\WidgetBaseInterface::form().

$form_state: The current state of the form.

$context: An associative array containing the following key-value pairs:

  • form: The form structure to which widgets are being attached. This may be a full form structure, or a sub-element of a larger form.
  • widget: The widget plugin instance.
  • items: The field values, as a \Drupal\Core\Field\FieldItemListInterface object.
  • delta: The order of this item in the array of subelements (0, 1, 2, etc).
  • default: A boolean indicating whether the form is being shown as a dummy form to set default values.

See also





Related topics

3 functions implement hook_field_widget_form_alter()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

field_test_field_widget_form_alter in core/modules/field/tests/modules/field_test/field_test.module
Implements hook_field_widget_form_alter().
media_field_widget_form_alter in core/modules/media/media.module
Implements hook_field_widget_form_alter().
path_field_widget_form_alter in core/modules/path/path.module
Implements hook_field_widget_form_alter().


core/modules/field/field.api.php, line 192


function hook_field_widget_form_alter(&$element, \Drupal\Core\Form\FormStateInterface $form_state, $context) {
    // Add a css class to widget form elements for all fields of type mytype.
    $field_definition = $context['items']->getFieldDefinition();
    if ($field_definition->getType() == 'mytype') {
        // Be sure not to overwrite existing attributes.
        $element['#attributes']['class'][] = 'myclass';

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.