Додайте клас до комірки таблиці Drupal, що містить ['data']

У Drupal 8 подання таблиць все ще дуже схоже на Drupal 7. Ви створюєте багатовимірні масиви рядків і стовпців у PHP, які Drupal перетворює відповідно в a <tr>і <td>s. Досі існує цей заплутаний Drupalism, відомий як 'data'той, який дозволяє додавати елементи масиву візуалізації як дані комірок (не плутати з атрибутами даних).

Мені дали сайт, де розробник вирішив використовувати "дані" для візуалізації вмісту комірки, але я не можу зрозуміти, як додати клас до даних <td>навколо.

Я прочитав вихідний код та документацію для Table.php, і знаю про нове, #wrapper_attributes але не можу цього зламати.

Я спробував принаймні чотири способи додати клас, і жодна робота.

$table['row-' . $row_id] = [

  // Option 1: Class appears on <tr> tag
  '#attributes' => [
    'class' => ['option-1-row-attributes'],
    'id' => 'row-' . $row_id,
    'no_striping' => TRUE,
  ],

  // Option 2: Class appears on <td> tag of first column. 
  'item' => [
    '#markup' => $row['my_item']->label(),
    '#wrapper_attributes' => [   
      'class' => ['option-2-markup-wrapper-attributes'],
    ],
  ],

  // In the following section, the only item that works is
  // the class on the <a> tag.
  'edit_operation' => [
    'data' => [
      '#type' => 'link',
      '#url' => Url::fromRoute('my_module.my_route', ['item' => $row_id]),
      '#title' => $this->t('Edit'),
      '#attributes' => [
        // Option 3: Class appears on the anchor tag
        'class' => ['use-ajax', 'option-3-link-attributes'],
        'data-dialog-type' => 'modal',
        'data-dialog-options' => Json::encode([
          'width' => 700,
        ]),
      ],
      // Option 4: Has no effect.
      '#wrapper_attributes' => [
        'class' => ['option-4-data-wrapper-attributes'],
      ],
    ],
    // Option 5: Update: This appears to be the correct solution! 
    // Class appears on the <td>.
    '#wrapper_attributes' => [
      'class' => ['option-5-wrapper-attributes'],
    ],
    // Option 6: Has no effect.
    '#attributes' => [
      'class' => ['option-6-attributes'],
    ],
    // Option 7: Has no effect.
    'class' => ['option-7-attributes'],
  ],
];

Після написання запитання в загальних рисах я знову повернувся до тестування і визначив, що варіант 5 в ОП з '#wrapper_attributes'таким же рівнем 'data'елемента працює. Я вважаю, що Drupal 8 агресивно кешував стіл, тому що мої зміни не з'являлися навіть після drush cr.

Правила додавання класів до таблиць через PHP:

• Клас таблиці вимагає #attributes.
• Клас рядків TR всередині TBODY вимагає #attributes.
• Клас клітин TD всередині TBODY вимагає #wrapper_attributes.
• Клас рядків TR всередині THEAD / TFOOT вимагає 'class'та 'data'контейнери.
  Ні тут, #attributesні #wrapper_attributesробота.
• Клас комірок TH / TD всередині THEAD / TFOOT вимагає 'class'і 'data'контейнерів.
  Ні тут, #attributesні #wrapper_attributesробота.
• Немає способу додати клас безпосередньо до тегу <thead>або, <tfoot>не змінюючи шаблон гілочки.

Ось найпоширеніший приклад додавання класів до <tr>& <td>тегів всередині основного <tbody>, а також до самого основного <table>тегу:

$table = [
  '#type' => 'table',
  '#attributes' => [
    'class' => ['table-class'],
  ],
  'row1' => [
    '#attributes' => [
      'class' => ['tr-class'],
    ],
    // Table data cell using 'data' for renderable elements.
    'column1' => [
      'data' => [
        '#type' => 'link', // Or any other renderable thing.
        '#attributes' => [
          'class' => ['link-class'],
        ],
        // Other elements required to render the link go here...
      ],
      '#wrapper_attributes' => [ // Watch out!
        'class' => ['td-class'],
      ],
    ],
    // Table data cell using '#markup'.
    'column2' => [
      '#markup' => '<span>' . $this->t('text') . '</span>',
      '#wrapper_attributes' => [   
        'class' => ['td-class'],
      ],
    ],
  ],
];

Зауважте, що 'class'контейнер прийме або рядок, або масив, але я пропоную завжди використовувати масив.

Звідси історія ускладнюється. Якщо вам потрібно додати класи до тегів TR або TD / TH всередині області THEAD / TFOOT, правила повністю змінюються. Ні , #attributesні #wrapper_attributesробота всередині #headerі #footerсекція і намагаюся використовувати їх виробляють дуже дивні ефекти.

Найменша мінімальна структура для таблиць із колонками даних заголовка / колонтитулу в Drupal 8 така:

$table = [
  '#type' => 'table',
  // Produces <thead> <tr> <th>
  '#header' => [
    'Header 1',
    'Header 2',
    'Header 3',
  ],
  // Produces <tbody> <tr> <td>
  'row1' => [
    'Body 1',
    'Body 2',
    'Body 3',
  ],
  // Produces <tfoot> <tr> <td>
  '#footer' => [
    'Footer 1',
    'Footer 2',
    'Footer 3',
  ],
];

Ви повинні змінити фактичну структуру даних та ввести два рівні додаткових багатовимірних масивів, щоб використовувати 'class'індекс масиву, який потребує також введення 'data'індексу масиву. Це стосується як елемента рядка, так і елементів комірки даних, як видно з наступного прикладу:

$table = [
  '#type' => 'table',
  // This example works the same way for '#footer'.
  '#header' => [
    // First, introduce an extra level to the array to provide a
    // place to store the class attribute on the <tr> element inside
    // the <thead>.
    [
      'class' => 'thead-tr-class',
      // Next place the columns inside a 'data' container, so that
      // the 'class' can be used.  '#wrapper_attributes' will not
      // work here.
      'data' => [
        // The following line produces data inside a <th>
        // without any class.
        'Header 1',

        // The following lines produce data inside a <th>
        // with a class: th-class.
        [
           'class' => 'th-class',
           'data' => 'Header 2',
           'colspan' => 2
        ],
      ],
    ],
  ],
];

Наведений вище #headerприклад дає:

<table>
  <thead>
    <tr class="thead-tr-class">
      <th>Header 1</th>
      <th class="th-class" colspan="2">Header 2</th>
    </tr>
  </thead>
</table>