class FormTestClickedButtonForm

Same name in other branches
  1. 9 core/modules/system/tests/modules/form_test/src/Form/FormTestClickedButtonForm.php \Drupal\form_test\Form\FormTestClickedButtonForm
  2. 8.9.x core/modules/system/tests/modules/form_test/src/Form/FormTestClickedButtonForm.php \Drupal\form_test\Form\FormTestClickedButtonForm
  3. 11.x core/modules/system/tests/modules/form_test/src/Form/FormTestClickedButtonForm.php \Drupal\form_test\Form\FormTestClickedButtonForm

Form builder to test button click detection.

@internal

Hierarchy

Expanded class hierarchy of FormTestClickedButtonForm

1 string reference to 'FormTestClickedButtonForm'
form_test.routing.yml in core/modules/system/tests/modules/form_test/form_test.routing.yml
core/modules/system/tests/modules/form_test/form_test.routing.yml

File

core/modules/system/tests/modules/form_test/src/Form/FormTestClickedButtonForm.php, line 13

Namespace

Drupal\form_test\Form
View source
class FormTestClickedButtonForm extends FormBase {
    
    /**
     * {@inheritdoc}
     */
    public function getFormId() {
        return 'form_test_clicked_button';
    }
    
    /**
     * {@inheritdoc}
     */
    public function buildForm(array $form, FormStateInterface $form_state, $first = NULL, $second = NULL, $third = NULL) {
        // A single text field. In IE, when a form has only one non-button input field
        // and the ENTER key is pressed while that field has focus, the form is
        // submitted without any information identifying the button responsible for
        // the submission. In other browsers, the form is submitted as though the
        // first button were clicked.
        $form['text'] = [
            '#title' => 'Text',
            '#type' => 'textfield',
        ];
        // Loop through each path argument, adding buttons based on the information
        // in the argument. For example, if the path is
        // form-test/clicked-button/s/i/rb, then 3 buttons are added: a 'submit', an
        // 'image_button', and a 'button' with #access=FALSE. This enables form.test
        // to test a variety of combinations.
        $i = 0;
        $args = [
            $first,
            $second,
            $third,
        ];
        foreach ($args as $arg) {
            $name = 'button' . ++$i;
            // 's', 'b', or 'i' in the argument define the button type wanted.
            if (!is_string($arg)) {
                $type = NULL;
            }
            elseif (str_contains($arg, 's')) {
                $type = 'submit';
            }
            elseif (str_contains($arg, 'b')) {
                $type = 'button';
            }
            elseif (str_contains($arg, 'i')) {
                $type = 'image_button';
            }
            else {
                $type = NULL;
            }
            if (isset($type)) {
                $form[$name] = [
                    '#type' => $type,
                    '#name' => $name,
                ];
                // Image buttons need a #src; the others need a #value.
                if ($type == 'image_button') {
                    $form[$name]['#src'] = 'core/misc/druplicon.png';
                }
                else {
                    $form[$name]['#value'] = $name;
                }
                // 'r' for restricted, so we can test that button click detection code
                // correctly takes #access security into account.
                if (str_contains($arg, 'r')) {
                    $form[$name]['#access'] = FALSE;
                }
            }
        }
        return $form;
    }
    
    /**
     * {@inheritdoc}
     */
    public function validateForm(array &$form, FormStateInterface $form_state) {
        if ($triggering_element = $form_state->getTriggeringElement()) {
            $this->messenger()
                ->addStatus(t('The clicked button is %name.', [
                '%name' => $triggering_element['#name'],
            ]));
        }
        else {
            $this->messenger()
                ->addStatus('There is no clicked button.');
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function submitForm(array &$form, FormStateInterface $form_state) {
        $this->messenger()
            ->addStatus('Submit handler for form_test_clicked_button executed.');
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
DependencySerializationTrait::$_entityStorages protected property
DependencySerializationTrait::$_serviceIds protected property
DependencySerializationTrait::__sleep public function 1
DependencySerializationTrait::__wakeup public function 2
FormBase::$configFactory protected property The config factory. 3
FormBase::$requestStack protected property The request stack. 1
FormBase::$routeMatch protected property The route match.
FormBase::config protected function Retrieves a configuration object.
FormBase::configFactory protected function Gets the config factory for this form. 3
FormBase::container private function Returns the service container.
FormBase::create public static function Instantiates a new instance of this class. Overrides ContainerInjectionInterface::create 111
FormBase::currentUser protected function Gets the current user. 2
FormBase::getRequest protected function Gets the request object.
FormBase::getRouteMatch protected function Gets the route match.
FormBase::logger protected function Gets the logger for a specific channel.
FormBase::redirect protected function Returns a redirect response object for the specified route.
FormBase::resetConfigFactory public function Resets the configuration factory.
FormBase::setConfigFactory public function Sets the config factory for this form.
FormBase::setRequestStack public function Sets the request stack object to use.
FormTestClickedButtonForm::buildForm public function Form constructor. Overrides FormInterface::buildForm
FormTestClickedButtonForm::getFormId public function Returns a unique string identifying the form. Overrides FormInterface::getFormId
FormTestClickedButtonForm::submitForm public function Form submission handler. Overrides FormInterface::submitForm
FormTestClickedButtonForm::validateForm public function Form validation handler. Overrides FormBase::validateForm
LoggerChannelTrait::$loggerFactory protected property The logger channel factory service.
LoggerChannelTrait::getLogger protected function Gets the logger for a specific channel.
LoggerChannelTrait::setLoggerFactory public function Injects the logger channel factory.
MessengerTrait::$messenger protected property The messenger. 16
MessengerTrait::messenger public function Gets the messenger. 16
MessengerTrait::setMessenger public function Sets the messenger.
RedirectDestinationTrait::$redirectDestination protected property The redirect destination service. 2
RedirectDestinationTrait::getDestinationArray protected function Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url.
RedirectDestinationTrait::getRedirectDestination protected function Returns the redirect destination service.
RedirectDestinationTrait::setRedirectDestination public function Sets the redirect destination service.
StringTranslationTrait::$stringTranslation protected property The string translation service. 3
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.

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