Stores information about the state of a subform.
In the context of Drupal's Form API, a subform is a form definition array that will be nested into a "parent" form. For instance:
$subform = [ 'method' => [ '#type' => 'select', // … ], ]; $form = [ // … 'settings' => $subform, ];
All input fields nested under "settings" are then considered part of that "subform". The concept is used mostly when the subform is defined by a different class (potentially even in a different module) than the parent form. This is often the case for plugins: a plugin's buildConfigurationForm() would then be handed an instance of this interface as the second parameter.
The benefit of doing this is that the plugin can then just define the form – and use the form state – as if it would define a "proper" form, not nested in some other form structure. This means that it won't have to know the key(s) under which its form structure will be nested – for instance, when retrieving the form values during form validation or submission.
Contrary to "proper" forms, subforms don't translate to a <form> tag in the HTML response. Instead, they can only be discerned in the HTML code by the nesting of the input tags' names.
Hierarchy
- interface \Drupal\Core\Form\FormStateInterface
- interface \Drupal\Core\Form\SubformStateInterface
See also
\Drupal\Core\Plugin\PluginFormInterface::buildConfigurationForm()
File
- core/lib/Drupal/Core/Form/SubformStateInterface.php, line 42
Namespace
Drupal\Core\Form
Members
Name | Modifiers | Type | Description |
---|---|---|---|
FormStateInterface::addBuildInfo | public | function | Adds a value to the build info. |
FormStateInterface::addCleanValueKey | public | function | Adds a key to the array of form values that will be cleaned. |
FormStateInterface::addRebuildInfo | public | function | Adds a value to the rebuild info. |
FormStateInterface::cleanValues | public | function | Removes internal Form API elements and buttons from submitted form values. |
FormStateInterface::clearErrors | public | function | Clears all errors against all form elements made by self::setErrorByName(). |
FormStateInterface::disableCache | public | function | Prevents the form from being cached. |
FormStateInterface::disableRedirect | public | function | Prevents the form from redirecting. |
FormStateInterface::get | public | function | Gets any arbitrary property. |
FormStateInterface::getAlwaysProcess | public | function | Determines if this form should always be processed. |
FormStateInterface::getBuildInfo | public | function | Returns the build info for the form. |
FormStateInterface::getButtons | public | function | Returns the submit and button elements for the form. |
FormStateInterface::getCacheableArray | public | function | Returns an array representation of the cacheable portion of the form state. |
FormStateInterface::getCleanValueKeys | public | function | Gets the keys of the form values that will be cleaned. |
FormStateInterface::getCompleteForm | public | function | Returns a reference to the complete form array. |
FormStateInterface::getError | public | function | Returns the error message filed against the given form element. |
FormStateInterface::getErrors | public | function | Returns an associative array of all errors. |
FormStateInterface::getFormObject | public | function | Returns the form object that is responsible for building this form. |
FormStateInterface::getGroups | public | function | Returns references to details elements to render them within vertical tabs. |
FormStateInterface::getLimitValidationErrors | public | function | Retrieves the limited validation error sections. |
FormStateInterface::getRebuildInfo | public | function | Gets the rebuild info. |
FormStateInterface::getRedirect | public | function | Gets the value to use for redirecting after the form has been executed. |
FormStateInterface::getResponse | public | function | Gets a response for this form. |
FormStateInterface::getStorage | public | function | Returns the entire set of arbitrary data. |
FormStateInterface::getSubmitHandlers | public | function | Gets the submit handlers. |
FormStateInterface::getTemporary | public | function | Gets temporary data. |
FormStateInterface::getTemporaryValue | public | function | Gets an arbitrary value from temporary storage. |
FormStateInterface::getTriggeringElement | public | function | Gets the form element that triggered submission. |
FormStateInterface::getUserInput | public | function | Returns the form values as they were submitted by the user. |
FormStateInterface::getValidateHandlers | public | function | Gets the validate handlers. |
FormStateInterface::getValue | public | function | Returns the submitted form value for a specific key. |
FormStateInterface::getValues | public | function | Returns the submitted and sanitized form values. |
FormStateInterface::has | public | function | Determines if an arbitrary property is present. |
FormStateInterface::hasAnyErrors | public static | function | Determines if any forms have any errors. |
FormStateInterface::hasFileElement | public | function | Returns whether this form has a file element. |
FormStateInterface::hasInvalidToken | public | function | Determines if the form has an invalid token. |
FormStateInterface::hasTemporaryValue | public | function | Determines if a temporary value is present. |
FormStateInterface::hasValue | public | function | Determines if a specific key is present in the submitted form values. |
FormStateInterface::isBypassingProgrammedAccessChecks | public | function | Determines if this form submission should bypass #access. |
FormStateInterface::isCached | public | function | Determines if the form should be cached. |
FormStateInterface::isExecuted | public | function | Determines if the form was submitted and has been processed and executed. |
FormStateInterface::isMethodType | public | function | Returns the HTTP form method. |
FormStateInterface::isProcessingInput | public | function | Determines if the form input will be processed. |
FormStateInterface::isProgrammed | public | function | Returns if this form was submitted programmatically. |
FormStateInterface::isRebuilding | public | function | Determines if the form should be rebuilt after processing. |
FormStateInterface::isRedirectDisabled | public | function | Determines if redirecting has been prevented. |
FormStateInterface::isSubmitted | public | function | Determines if the form has been submitted. |
FormStateInterface::isValidationComplete | public | function | Determines if validation has been completed. |
FormStateInterface::isValidationEnforced | public | function | Checks if validation is enforced. |
FormStateInterface::isValueEmpty | public | function | Determines if a specific key has a value in the submitted form values. |
FormStateInterface::loadInclude | public | function | Ensures an include file is loaded whenever the form is processed. |
FormStateInterface::prepareCallback | public | function | Converts support notations for a form callback to a valid callable. |
FormStateInterface::set | public | function | Sets a value to an arbitrary property. |
FormStateInterface::setAlwaysProcess | public | function | Sets this form to always be processed. |
FormStateInterface::setBuildInfo | public | function | Sets the build info for the form. |
FormStateInterface::setButtons | public | function | Stores the submit and button elements for the form. |
FormStateInterface::setCached | public | function | Sets this form to be cached. |
FormStateInterface::setCleanValueKeys | public | function | Sets the keys of the form values that will be cleaned. |
FormStateInterface::setCompleteForm | public | function | Stores the complete form array. |
FormStateInterface::setError | public | function | Flags an element as having an error. |
FormStateInterface::setErrorByName | public | function | Files an error against a form element. |
FormStateInterface::setExecuted | public | function | Sets that the form was submitted and has been processed and executed. |
FormStateInterface::setFormObject | public | function | Sets the form object that is responsible for building this form. |
FormStateInterface::setFormState | public | function | Sets the value of the form state. |
FormStateInterface::setGroups | public | function | Sets references to details elements to render them within vertical tabs. |
FormStateInterface::setHasFileElement | public | function | Sets that this form has a file element. |
FormStateInterface::setInvalidToken | public | function | Flags the form state as having or not an invalid token. |
FormStateInterface::setLimitValidationErrors | public | function | Sets the limited validation error sections. |
FormStateInterface::setMethod | public | function | Sets the HTTP method to use for the form's submission. |
FormStateInterface::setProcessInput | public | function | Sets that the form should process input. |
FormStateInterface::setProgrammed | public | function | Sets that this form was submitted programmatically. |
FormStateInterface::setProgrammedBypassAccessCheck | public | function | Sets if this form submission should bypass #access. |
FormStateInterface::setRebuild | public | function | Sets the form to be rebuilt after processing. |
FormStateInterface::setRebuildInfo | public | function | Sets the rebuild info. |
FormStateInterface::setRedirect | public | function | Sets the redirect for the form. |
FormStateInterface::setRedirectUrl | public | function | Sets the redirect URL for the form. |
FormStateInterface::setRequestMethod | public | function | Sets the HTTP method used by the request that is building the form. |
FormStateInterface::setResponse | public | function | Sets a response for this form. |
FormStateInterface::setStorage | public | function | Sets the entire set of arbitrary data. |
FormStateInterface::setSubmitHandlers | public | function | Sets the submit handlers. |
FormStateInterface::setSubmitted | public | function | Sets that the form has been submitted. |
FormStateInterface::setTemporary | public | function | Sets temporary data. |
FormStateInterface::setTemporaryValue | public | function | Sets an arbitrary value in temporary storage. |
FormStateInterface::setTriggeringElement | public | function | Sets the form element that triggered submission. |
FormStateInterface::setUserInput | public | function | Sets the form values as though they were submitted by a user. |
FormStateInterface::setValidateHandlers | public | function | Sets the validate handlers. |
FormStateInterface::setValidationComplete | public | function | Sets that validation has been completed. |
FormStateInterface::setValidationEnforced | public | function | Enforces that validation is run. |
FormStateInterface::setValue | public | function | Sets the submitted form value for a specific key. |
FormStateInterface::setValueForElement | public | function | Changes submitted form values during form validation. |
FormStateInterface::setValues | public | function | Sets the submitted form values. |
FormStateInterface::unsetValue | public | function | Removes a specific key from the submitted form values. |
SubformStateInterface::getCompleteFormState | public | function | Gets the complete form state. |
Please login to continue.