class Table in YAML Form 8

Provides a 'table' element.

Plugin annotation


@YamlFormElement(
  id = "table",
  api = "https://api.drupal.org/api/drupal/core!lib!Drupal!Core!Render!Element!Table.php/class/Table",
  label = @Translation("Table"),
  category = @Translation("Table"),
)

Hierarchy

class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\yamlform\YamlFormElementBase implements YamlFormElementInterface uses StringTranslationTrait
  - class \Drupal\yamlform\Plugin\YamlFormElement\Table

Expanded class hierarchy of Table

4 string references to 'Table'

yamlform.links.task.yml in ./yamlform.links.task.yml: yamlform.links.task.yml
YamlFormEntityListBuilder::getDefaultOperations in src/YamlFormEntityListBuilder.php: Gets this list's default operations.
YamlFormLikert::getFormats in src/Plugin/YamlFormElement/YamlFormLikert.php: Get an element's available formats.
yamlform_node.links.task.yml in modules/yamlform_node/yamlform_node.links.task.yml: modules/yamlform_node/yamlform_node.links.task.yml

File

src/Plugin/YamlFormElement/Table.php, line 22

Namespace

Drupal\yamlform\Plugin\YamlFormElement

View source

class Table extends YamlFormElementBase {

  /**
   * {@inheritdoc}
   */
  public function getDefaultProperties() {
    return [
      // Table settings.
      'header' => [],
      'empty' => '',
    ];
  }

  /**
   * {@inheritdoc}
   */
  public function getTranslatableProperties() {
    return array_merge(parent::getTranslatableProperties(), [
      'header',
    ]);
  }

  /**
   * {@inheritdoc}
   */
  public function isInput(array $element) {
    return FALSE;
  }

  /**
   * {@inheritdoc}
   */
  public function isContainer(array $element) {
    return TRUE;
  }

  /**
   * {@inheritdoc}
   */
  public function prepare(array &$element, YamlFormSubmissionInterface $yamlform_submission) {
    parent::prepare($element, $yamlform_submission);

    // Add .js-form.wrapper to fix #states handling.
    $element['#attributes']['class'][] = 'js-form-wrapper';

    // Disable #tree for table element. Forms do not support the #tree
    // property.
    $element['#tree'] = FALSE;
  }

  /**
   * {@inheritdoc}
   */
  protected function build($format, array &$element, $value, array $options = []) {
    return parent::build($format, $element, $value, $options);
  }

  /**
   * {@inheritdoc}
   */
  public function getDefaultFormat() {
    return 'table';
  }

  /**
   * {@inheritdoc}
   */
  public function getFormats() {
    return [
      'table',
    ];
  }

  /**
   * {@inheritdoc}
   */
  public function getTestValue(array $element, YamlFormInterface $yamlform) {

    // Containers should never have values and therefore should never have
    // a test value.
    return NULL;
  }

  /**
   * {@inheritdoc}
   */
  public function formatHtml(array &$element, $value, array $options = []) {

    // Undo form submission elements and convert rows back into a simple
    // render array.
    $rows = [];
    foreach ($value as $row_key => $row_element) {
      $element[$row_key] = [];
      foreach ($row_element['#value'] as $column_key => $column_element) {
        if (isset($column_element['#value'])) {
          if (is_string($column_element['#value']) || $column_element['#value'] instanceof TranslatableMarkup) {
            $value = [
              '#markup' => $column_element['#value'],
            ];
          }
          else {
            $value = $column_element['#value'];
          }
        }
        elseif (isset($column_element['#markup'])) {
          $value = [
            '#markup' => $column_element['#markup'],
          ];
        }
        else {
          $value = '';
        }
        $rows[$row_key][$column_key] = [
          'data' => $value,
        ];
      }
    }
    return $rows + $element;
  }

  /**
   * {@inheritdoc}
   */
  public function formatText(array &$element, $value, array $options = []) {

    // Render the HTML table.
    $build = $this
      ->formatHtml($element, $value, $options);
    $html = \Drupal::service('renderer')
      ->renderPlain($build);

    // Convert table in pipe delimited plain text.
    $html = preg_replace('#\\s*</td>\\s*<td[^>]*>\\s*#', ' | ', $html);
    $html = preg_replace('#\\s*</th>\\s*<th[^>]*>\\s*#', ' | ', $html);
    $html = preg_replace('#^\\s+#m', '', $html);
    $html = preg_replace('#\\s+$#m', '', $html);
    $html = preg_replace('#\\n+#s', "\n", $html);
    $html = strip_tags($html);

    // Remove blank links from text.
    // From: http://stackoverflow.com/questions/709669/how-do-i-remove-blank-lines-from-text-in-php
    $html = preg_replace("/(^[\r\n]*|[\r\n]+)[\\s\t]*[\r\n]+/", "\n", $html);

    // Add divider between (optional) header.
    if (!empty($element['#header'])) {
      $lines = explode("\n", trim($html));
      $lines[0] .= "\n" . str_repeat('-', Unicode::strlen($lines[0]));
      $html = implode("\n", $lines);
    }
    return $html;
  }

  /**
   * {@inheritdoc}
   */
  public function form(array $form, FormStateInterface $form_state) {
    $form = parent::form($form, $form_state);
    $form['table'] = [
      '#type' => 'fieldset',
      '#title' => $this
        ->t('Table settings'),
    ];
    $form['table']['header'] = [
      '#title' => $this
        ->t('Header (YAML)'),
      '#type' => 'yamlform_codemirror',
      '#mode' => 'yaml',
    ];
    $form['table']['empty'] = [
      '#type' => 'textfield',
      '#title' => $this
        ->t('Empty text'),
      '#description' => $this
        ->t('Text to display when no rows are present.'),
    ];
    return $form;
  }

  /**
   * {@inheritdoc}
   */
  public function getElementSelectorOptions(array $element) {
    return [];
  }

}

Members

Name	Modifiers	Type	Description	Overrides
PluginBase::$configuration	protected	property	Configuration information passed into the plugin.	1
PluginBase::$pluginDefinition	protected	property	The plugin implementation definition.	1
PluginBase::$pluginId	protected	property	The plugin_id.
PluginBase::DERIVATIVE_SEPARATOR		constant	A string which is used to separate base plugin IDs from the derivative ID.
PluginBase::getBaseId	public	function	Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface::getBaseId
PluginBase::getDerivativeId	public	function	Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface::getDerivativeId
PluginBase::getPluginDefinition	public	function	Gets the definition of the plugin implementation. Overrides PluginInspectionInterface::getPluginDefinition	3
PluginBase::getPluginId	public	function	Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface::getPluginId
PluginBase::isConfigurable	public	function	Determines if the plugin is configurable.
StringTranslationTrait::$stringTranslation	protected	property	The string translation service.	1
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.
Table::build	protected	function	Build an element as text or HTML. Overrides YamlFormElementBase::build
Table::form	public	function	Gets the actual configuration form array to be built. Overrides YamlFormElementBase::form
Table::formatHtml	public	function	Format an element's value as HTML. Overrides YamlFormElementBase::formatHtml
Table::formatText	public	function	Format an element's value as plain text. Overrides YamlFormElementBase::formatText
Table::getDefaultFormat	public	function	Get an element's default format name. Overrides YamlFormElementBase::getDefaultFormat
Table::getDefaultProperties	public	function	Only a few elements don't inherit these default properties. Overrides YamlFormElementBase::getDefaultProperties
Table::getElementSelectorOptions	public	function	Get an element's selectors as options. Overrides YamlFormElementBase::getElementSelectorOptions
Table::getFormats	public	function	Get an element's available formats. Overrides YamlFormElementBase::getFormats
Table::getTestValue	public	function	Get test value for an element. Overrides YamlFormElementBase::getTestValue
Table::getTranslatableProperties	public	function	Get translatable properties. Overrides YamlFormElementBase::getTranslatableProperties
Table::isContainer	public	function	Checks if element is a container that can contain elements. Overrides YamlFormElementBase::isContainer
Table::isInput	public	function	Checks if the element carries a value. Overrides YamlFormElementBase::isInput
Table::prepare	public	function	Prepare an element to be rendered within a form. Overrides YamlFormElementBase::prepare
YamlFormElementBase::$configFactory	protected	property	The configuration factory.
YamlFormElementBase::$currentUser	protected	property	The current user.
YamlFormElementBase::$elementInfo	protected	property	A element info manager.
YamlFormElementBase::$elementManager	protected	property	The form element manager.
YamlFormElementBase::$entityTypeManager	protected	property	The entity type manager.
YamlFormElementBase::$logger	protected	property	A logger instance.
YamlFormElementBase::$tokenManager	protected	property	The token manager.
YamlFormElementBase::buildConfigurationForm	public	function	Form constructor. Overrides PluginFormInterface::buildConfigurationForm	1
YamlFormElementBase::buildExportHeader	public	function	Build an element's export header. Overrides YamlFormElementInterface::buildExportHeader	3
YamlFormElementBase::buildExportOptionsForm	public	function	Get an element's export options form. Overrides YamlFormElementInterface::buildExportOptionsForm	4
YamlFormElementBase::buildExportRecord	public	function	Build an element's export row. Overrides YamlFormElementInterface::buildExportRecord	5
YamlFormElementBase::buildHtml	public	function	Build an element as HTML element. Overrides YamlFormElementInterface::buildHtml	1
YamlFormElementBase::buildText	public	function	Build an element as text element. Overrides YamlFormElementInterface::buildText	1
YamlFormElementBase::checkAccessRules	public	function	Check element access (rules). Overrides YamlFormElementInterface::checkAccessRules
YamlFormElementBase::create	public static	function	Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface::create
YamlFormElementBase::displayDisabledWarning	public	function	Display element disabled warning. Overrides YamlFormElementInterface::displayDisabledWarning	1
YamlFormElementBase::formatTableColumn	public	function	Format an element's table column value. Overrides YamlFormElementInterface::formatTableColumn	2
YamlFormElementBase::getAdminLabel	public	function	Get an element's admin label (#admin_title, #title or #yamlform_key). Overrides YamlFormElementInterface::getAdminLabel
YamlFormElementBase::getConfigurationFormProperties	public	function	Get an associative array of element properties from configuration form. Overrides YamlFormElementInterface::getConfigurationFormProperties	2
YamlFormElementBase::getConfigurationFormProperty	protected	function	Get configuration property value.	1
YamlFormElementBase::getDefaultBaseProperties	protected	function	Get default base properties used by all elements.
YamlFormElementBase::getElementSelectorInputsOptions	protected	function	Get an element's (sub)inputs selectors as options.	7
YamlFormElementBase::getElementStateOptions	public	function	Get an element's supported states as options. Overrides YamlFormElementInterface::getElementStateOptions
YamlFormElementBase::getExportDefaultOptions	public	function	Get an element's default export options. Overrides YamlFormElementInterface::getExportDefaultOptions	4
YamlFormElementBase::getFormat	public	function	Get element's format name by looking for '#format' property, global settings, and finally default settings. Overrides YamlFormElementInterface::getFormat	1
YamlFormElementBase::getInfo	public	function	Retrieves the default properties for the defined element type. Overrides YamlFormElementInterface::getInfo
YamlFormElementBase::getKey	public	function	Get an element's key/name. Overrides YamlFormElementInterface::getKey
YamlFormElementBase::getLabel	public	function	Get an element's label (#title or #yamlform_key). Overrides YamlFormElementInterface::getLabel
YamlFormElementBase::getPluginApiLink	public	function	Get link to element's API documentation. Overrides YamlFormElementInterface::getPluginApiLink
YamlFormElementBase::getPluginApiUrl	public	function	Get the URL for the element's API documentation. Overrides YamlFormElementInterface::getPluginApiUrl
YamlFormElementBase::getPluginLabel	public	function	Gets the label of the plugin instance. Overrides YamlFormElementInterface::getPluginLabel
YamlFormElementBase::getRelatedTypes	public	function	Get related element types. Overrides YamlFormElementInterface::getRelatedTypes	3
YamlFormElementBase::getTableColumn	public	function	Get element's table column(s) settings. Overrides YamlFormElementInterface::getTableColumn	3
YamlFormElementBase::getTypeName	public	function	Gets the type name (aka id) of the plugin instance with the 'yamlform_' prefix. Overrides YamlFormElementInterface::getTypeName
YamlFormElementBase::hasMultipleValues	public	function	Checks if element value has multiple values. Overrides YamlFormElementInterface::hasMultipleValues	3
YamlFormElementBase::hasProperty	public	function	Determine if an element supports a specified property. Overrides YamlFormElementInterface::hasProperty
YamlFormElementBase::hasWrapper	public	function	Checks if the element has a wrapper. Overrides YamlFormElementInterface::hasWrapper
YamlFormElementBase::initialize	public	function	Initialize an element to be displayed, rendered, or exported. Overrides YamlFormElementInterface::initialize	1
YamlFormElementBase::isComposite	public	function	Checks if element is a composite element. Overrides YamlFormElementInterface::isComposite
YamlFormElementBase::isDisabled	public	function	Checks if element is disabled. Overrides YamlFormElementInterface::isDisabled
YamlFormElementBase::isEnabled	public	function	Checks if element is enabled. Overrides YamlFormElementInterface::isEnabled	1
YamlFormElementBase::isHidden	public	function	Checks if element is hidden. Overrides YamlFormElementInterface::isHidden
YamlFormElementBase::isMultiline	public	function	Checks if element value could contain multiple lines. Overrides YamlFormElementInterface::isMultiline	3
YamlFormElementBase::isRoot	public	function	Checks if element is a root element. Overrides YamlFormElementInterface::isRoot	1
YamlFormElementBase::postCreate	public	function	Acts on a form submission element after it is created. Overrides YamlFormElementInterface::postCreate	1
YamlFormElementBase::postDelete	public	function	Delete any additional value associated with an element. Overrides YamlFormElementInterface::postDelete	2
YamlFormElementBase::postLoad	public	function	Acts on loaded form submission. Overrides YamlFormElementInterface::postLoad	1
YamlFormElementBase::postSave	public	function	Acts on a saved form submission element before the insert or update hook is invoked. Overrides YamlFormElementInterface::postSave	2
YamlFormElementBase::preCreate	public	function	Changes the values of an entity before it is created. Overrides YamlFormElementInterface::preCreate	1
YamlFormElementBase::preDelete	public	function		1
YamlFormElementBase::prefixExportHeader	protected	function	Prefix an element's export header.
YamlFormElementBase::prepareWrapper	protected	function	Set an elements Flexbox and #states wrapper.	1
YamlFormElementBase::preSave	public	function	Acts on a form submission element before the presave hook is invoked. Overrides YamlFormElementInterface::preSave	2
YamlFormElementBase::setConfigurationFormDefaultValue	protected	function	Set an element's configuration form element default value.	2
YamlFormElementBase::setConfigurationFormDefaultValueRecursive	protected	function	Set configuration form default values recursively.
YamlFormElementBase::setDefaultValue	public	function	Set an element's default value using saved data. Overrides YamlFormElementInterface::setDefaultValue	8
YamlFormElementBase::submitConfigurationForm	public	function	Form submission handler. Overrides PluginFormInterface::submitConfigurationForm
YamlFormElementBase::validateConfigurationForm	public	function	Form validation handler. Overrides PluginFormInterface::validateConfigurationForm	3
YamlFormElementBase::validateUnique	public static	function	Form API callback. Validate #unique value.
YamlFormElementBase::__construct	public	function	Constructs a Drupal\Component\Plugin\PluginBase object. Overrides PluginBase::__construct

You are here

class Table in YAML Form 8

Plugin annotation

Hierarchy

File

Namespace

Members

API Navigation