Добавить класс в ячейку таблицы 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 в OP с '#wrapper_attributes'тем же уровнем 'data'элемента работает. Я считаю, что Drupal 8 активно кэшировал таблицу, потому что мои изменения не появлялись даже после a 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>