You are here

interface WebformSubmissionConditionsValidatorInterface in Webform 8.5

Same name and namespace in other branches
  1. 6.x src/WebformSubmissionConditionsValidatorInterface.php \Drupal\webform\WebformSubmissionConditionsValidatorInterface

Provides an interface defining a webform conditions (#states) validator.

Hierarchy

Expanded class hierarchy of WebformSubmissionConditionsValidatorInterface

All classes that implement WebformSubmissionConditionsValidatorInterface

9 files declare their use of WebformSubmissionConditionsValidatorInterface
ActionWebformHandler.php in src/Plugin/WebformHandler/ActionWebformHandler.php
DebugWebformHandler.php in src/Plugin/WebformHandler/DebugWebformHandler.php
EmailWebformHandler.php in src/Plugin/WebformHandler/EmailWebformHandler.php
ExampleWebformHandler.php in modules/webform_example_handler/src/Plugin/WebformHandler/ExampleWebformHandler.php
OptionsLimitWebformHandler.php in modules/webform_options_limit/src/Plugin/WebformHandler/OptionsLimitWebformHandler.php

... See full list

File

src/WebformSubmissionConditionsValidatorInterface.php, line 10

Namespace

Drupal\webform
View source
interface WebformSubmissionConditionsValidatorInterface {

  /**
   * Apply states (aka conditional logic) to wizard pages.
   *
   * @param array $pages
   *   An associative array of webform wizard pages.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   *
   * @return array
   *   An associative array of webform wizard pages with hidden pages removed.
   */
  public function buildPages(array $pages, WebformSubmissionInterface $webform_submission);

  /**
   * Apply form #states to visible elements.
   *
   * @param array $form
   *   An associative array containing the structure of the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   *
   * @see \Drupal\webform\WebformSubmissionForm::buildForm
   */
  public function buildForm(array &$form, FormStateInterface $form_state);

  /**
   * Validate form #states for visible elements.
   *
   * @param array $form
   *   An associative array containing the structure of the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   *
   * @see \Drupal\webform\WebformSubmissionForm::validateForm
   */
  public function validateForm(array &$form, FormStateInterface $form_state);

  /**
   * Submit form #states for visible elements.
   *
   * @param array $form
   *   An associative array containing the structure of the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   *
   * @see \Drupal\webform\WebformSubmissionForm::submitForm
   */
  public function submitForm(array &$form, FormStateInterface $form_state);

  /**
   * Validate state with conditions.
   *
   * @param string $state
   *   A state.
   * @param array $conditions
   *   An associative array containing conditions.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   *
   * @return bool|null
   *   TRUE if conditions validate. NULL if conditions can't be processed.
   */
  public function validateState($state, array $conditions, WebformSubmissionInterface $webform_submission);

  /**
   * Validate #state conditions.
   *
   * @param array $conditions
   *   An associative array containing conditions.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   *
   * @return bool|null
   *   TRUE if the conditions validate. NULL if the conditions can't be
   *   processed. NULL is returned when there is an invalid selector or a
   *   missing element in the conditions.
   *
   * @see \Drupal\Core\Form\FormHelper::processStates
   */
  public function validateConditions(array $conditions, WebformSubmissionInterface $webform_submission);

  /**
   * Determine if an element is visible.
   *
   * @param array $element
   *   An element.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   *
   * @return bool
   *   TRUE if the element is visible.
   */
  public function isElementVisible(array $element, WebformSubmissionInterface $webform_submission);

  /**
   * Determine if an element is enabled.
   *
   * @param array $element
   *   An element.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   *
   * @return bool
   *   TRUE if the element is enabled.
   */
  public function isElementEnabled(array $element, WebformSubmissionInterface $webform_submission);

}

Members

Namesort descending Modifiers Type Description Overrides
WebformSubmissionConditionsValidatorInterface::buildForm public function Apply form #states to visible elements. 1
WebformSubmissionConditionsValidatorInterface::buildPages public function Apply states (aka conditional logic) to wizard pages. 1
WebformSubmissionConditionsValidatorInterface::isElementEnabled public function Determine if an element is enabled. 1
WebformSubmissionConditionsValidatorInterface::isElementVisible public function Determine if an element is visible. 1
WebformSubmissionConditionsValidatorInterface::submitForm public function Submit form #states for visible elements. 1
WebformSubmissionConditionsValidatorInterface::validateConditions public function Validate #state conditions. 1
WebformSubmissionConditionsValidatorInterface::validateForm public function Validate form #states for visible elements. 1
WebformSubmissionConditionsValidatorInterface::validateState public function Validate state with conditions. 1