interface SettingInterface

Defines the interface for an object oriented theme setting plugin.

Hierarchy

  • interface \Drupal\bootstrap\Plugin\Form\FormInterface
    • interface \Drupal\bootstrap\Plugin\Setting\SettingInterface extends \Drupal\Component\Plugin\PluginInspectionInterface

Expanded class hierarchy of SettingInterface

All classes that implement SettingInterface

Related topics

Namespace

Drupal\bootstrap\Plugin\Setting
Source
interface SettingInterface extends PluginInspectionInterface, FormInterface {

  /**
   * Determines whether a theme setting should added to drupalSettings.
   *
   * By default, this value will be FALSE unless the method is overridden. This
   * is to ensure that no sensitive information can be potientially leaked.
   *
   * @see \Drupal\bootstrap\Plugin\Setting\SettingBase::drupalSettings()
   *
   * @return bool
   *   TRUE or FALSE
   */
  public function drupalSettings();

  /**
   * The cache tags associated with this object.
   *
   * When this object is modified, these cache tags will be invalidated.
   *
   * @return string[]
   *   A set of cache tags.
   */
  public function getCacheTags();

  /**
   * Retrieves the setting's default value.
   *
   * @return string
   *   The setting's default value.
   */
  public function getDefaultValue();

  /**
   * Retrieves the group form element the setting belongs to.
   *
   * @param array $form
   *   Nested array of form elements that comprise the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   *
   * @return \Drupal\bootstrap\Utility\Element
   *   The group element object.
   *
   * @deprecated Will be removed in a future release. Use \Drupal\bootstrap\Plugin\Setting\SettingInterface::getGroupElement
   */
  public function getGroup(array &$form, FormStateInterface $form_state);

  /**
   * Retrieves the group form element the setting belongs to.
   *
   * @param \Drupal\bootstrap\Utility\Element $form
   *   The Element object that comprises the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   *
   * @return \Drupal\bootstrap\Utility\Element
   *   The group element object.
   */
  public function getGroupElement(Element $form, FormStateInterface $form_state);

  /**
   * Retrieves the setting's groups.
   *
   * @return array
   *   The setting's group.
   */
  public function getGroups();

  /**
   * Retrieves the form element for the setting.
   *
   * @param array $form
   *   Nested array of form elements that comprise the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   *
   * @return \Drupal\bootstrap\Utility\Element
   *   The setting element object.
   *
   * @deprecated Will be removed in a future release. Use \Drupal\bootstrap\Plugin\Setting\SettingInterface::getSettingElement
   */
  public function getElement(array &$form, FormStateInterface $form_state);

  /**
   * Retrieves the settings options, if set.
   *
   * @return array
   *   An array of options.
   */
  public function getOptions();

  /**
   * Retrieves the form element for the setting.
   *
   * @param \Drupal\bootstrap\Utility\Element $form
   *   The Element object that comprises the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   *
   * @return \Drupal\bootstrap\Utility\Element
   *   The setting element object.
   */
  public function getSettingElement(Element $form, FormStateInterface $form_state);

  /**
   * Retrieves the setting's human-readable title.
   *
   * @return string
   *   The setting's type.
   */
  public function getTitle();

}

Members

Contains filters are case sensitive
Namesort descending Modifiers Type Description
FormInterface::alterForm public function The alter method to store the code.
FormInterface::alterFormElement public function The alter method to store the code.
FormInterface::submitForm public static function Form submission handler.
FormInterface::submitFormElement public static function Form submission handler.
FormInterface::validateForm public static function Form validation handler.
FormInterface::validateFormElement public static function Form validation handler.
SettingInterface::drupalSettings public function Determines whether a theme setting should added to drupalSettings.
SettingInterface::getCacheTags public function The cache tags associated with this object.
SettingInterface::getDefaultValue public function Retrieves the setting's default value.
SettingInterface::getElement Deprecated public function Retrieves the form element for the setting.
SettingInterface::getGroup Deprecated public function Retrieves the group form element the setting belongs to.
SettingInterface::getGroupElement public function Retrieves the group form element the setting belongs to.
SettingInterface::getGroups public function Retrieves the setting's groups.
SettingInterface::getOptions public function Retrieves the settings options, if set.
SettingInterface::getSettingElement public function Retrieves the form element for the setting.
SettingInterface::getTitle public function Retrieves the setting's human-readable title.