Initial commit.

Author: minnur

README.md

@@ -1 +1,39 @@
-# webform_checkboxes_table
+# Webform Checkboxes Table
+
+Webform checkboxes table (grid) component for Drupal 8 Webform module.
+
+The idea is to display checkboxes field in a grid (similar to Likert field but supports multiple values).
+
+| Field title  | Option 1 | Option 2 | Option 3 | ... | Option N |
+| ------------- | ------------- | ------------- | ------------- | ------------- | ------------- |
+| Checkbox field title 1  | [ ]  | [ ]  | [x]  | ... | [ ]  |
+| Checkbox field title 2  | [x]  | [ ]  | [x]  | ...  | [x]  |
+
+Here is example YAML source of the checkboxes table grid.
+
+```YAML
+checkboxes_table:
+  '#type': checkboxes_table
+  '#header':
+    - 'Field Label'
+    - 'Option 1'
+    - 'Option 2'
+    - 'Option 3'
+    - 'Option 4'
+  my_checkboxes_field_title:
+    '#type': checkboxes
+    '#title': 'My Checkboxes field title'
+    '#options':
+      'Checkbox 1': 'Checkbox 1'
+      'Checkbox 2': 'Checkbox 2'
+      'Checkbox 3': 'Checkbox 3'
+      'Checkbox 4': 'Checkbox 4'
+  another_checkboxes_field:
+    '#type': checkboxes
+    '#title': 'Another checkboxes field'
+    '#options':
+      'Option 1': 'Option 1'
+      'Option 2': 'Option 2'
+      'Option 3': 'Option 3'
+      'Option 4': 'Option 4'
+```

src/Element/WebformCheckboxesTable.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace Drupal\webform_checkboxes_table\Element;
+
+use Drupal\Core\Render\Element\Table;
+
+/**
+ * Provides a render element for a checkboxes table.
+ *
+ * @RenderElement("webform_checkboxes_table")
+ */
+class WebformCheckboxesTable extends Table {
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function preRenderTable($element) {
+    $element = parent::preRenderTable($element, $form_state, $complete_form);
+    $row = 0;
+    foreach (self::getCheckboxesElement($element) as $el_id) {
+      $title_array = ['data' => $element[$el_id]['#title']];
+      // Add field title to the beginning of the table data array.
+      array_unshift($element['#rows'][$row]['data'], $title_array);
+      $row++;
+    }
+    return $element;
+  }
+
+  /**
+   * Get checkboxes elements from a huge array mess (not sure if this is a reliable way).
+   */
+  protected static function getCheckboxesElement($element) {
+    $ids = [];
+    foreach ($element as $key => $value) {
+      if (!strstr($key, '#')) {
+        $ids[] = $key;
+      }
+    }
+    return $ids;
+  }
+
+}

src/Plugin/WebformElement/CheckboxesTable.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Drupal\webform_checkboxes_table\Plugin\WebformElement;
+
+use Drupal\webform\Plugin\WebformElement\Table;
+
+/**
+ * Provides a 'checkbxoes table' element.
+ *
+ * @WebformElement(
+ *   id = "webform_checkboxes_table",
+ *   api = "https://api.drupal.org/api/drupal/core!lib!Drupal!Core!Render!Element!Table.php/class/Table",
+ *   label = @Translation("Checkboxes Table"),
+ *   description = @Translation("Provides an element to render checkboxes in a table."),
+ *   category = @Translation("Markup elements"),
+ * )
+ */
+class CheckboxesTable extends Table {
+
+}

webform_checkboxes_table.info.yml

@@ -0,0 +1,7 @@
+name: Webform Checkboxes Table
+type: module
+description: Display checkboxes element in a table grid
+core: 8.x
+package: 'Webform example'
+dependencies:
+  - 'webform:webform'