FormState::$build_info
Same name in other branches
- 8.9.x core/lib/Drupal/Core/Form/FormState.php \Drupal\Core\Form\FormState::build_info
- 10 core/lib/Drupal/Core/Form/FormState.php \Drupal\Core\Form\FormState::build_info
- 11.x core/lib/Drupal/Core/Form/FormState.php \Drupal\Core\Form\FormState::build_info
An associative array of information stored by Form API.
This associative array is necessary to build and rebuild the form from cache when the original context may no longer be available:
- callback: The actual callback to be used to retrieve the form array. Can be any callable. If none is provided $form_id is used as the name of a function to call instead.
- args: A list of arguments to pass to the form constructor.
- files: An optional array defining include files that need to be loaded for building the form. Each array entry may be the path to a file or another array containing values for the parameters 'type', 'module' and 'name' as needed by \Drupal::moduleHandler()->loadInclude(). The files listed here are automatically loaded by \Drupal::formBuilder()->getCache(). By default the current menu router item's 'file' definition is added, if any. Use self::loadInclude() to add include files from a form constructor.
- form_id: Identification of the primary form being constructed and processed.
- base_form_id: Identification for a base form, as declared in the form class's \Drupal\Core\Form\BaseFormIdInterface::getBaseFormId() method.
- immutable: If this flag is set to TRUE, a new form build id is generated when the form is loaded from the cache. If it is subsequently saved to the cache again, it will have another cache id and therefore the original form and form-state will remain unaltered. This is important when page caching is enabled in order to prevent form state from leaking between anonymous users.
Type: array
File
-
core/
lib/ Drupal/ Core/ Form/ FormState.php, line 68
Class
- FormState
- Stores information about the state of a form.
Namespace
Drupal\Core\FormCode
protected $build_info = [
'args' => [],
'files' => [],
];
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.