Dodaj klasę do komórki tabeli Drupal zawierającej [„dane”]

W Drupal 8 renderowanie tabel jest nadal bardzo podobne do Drupala 7. Budujesz wielowymiarowe tablice wierszy i kolumn w PHP, które Drupal przekształca odpowiednio w a <tr>i <td>s. Nadal występuje ten mylący Drupalizm, 'data'który pozwala dodawać elementy tablicy renderowania jako dane komórki (nie mylić z atrybutami danych).

Otrzymałem witrynę, na której programista zdecydował się użyć „danych” do renderowania zawartości komórki, ale nie mogę wymyślić, jak dodać klasę <td>dookoła danych.

Przeczytałem kod źródłowy i dokumentację dla Table.php i jestem świadomy nowego, #wrapper_attributes ale nie mogę tego złamać.

Próbowałem co najmniej czterech sposobów, aby dodać klasę i żaden nie działa.

$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'],
  ],
];

Po ogólnym sformułowaniu pytania wróciłem do testowania i stwierdziłem, że opcja 5 w PO z '#wrapper_attributes'tym samym poziomem 'data'elementu działa. Wierzę, że Drupal 8 agresywnie buforował stół, ponieważ moje zmiany nie pojawiały się nawet po drush cr.

Zasady dodawania klas do tabel za pomocą zaplecza PHP to:

• Tabela wymaga klasy #attributes.
• Wymagana jest klasa wiersza TR wewnątrz TBODY #attributes.
• Wymagana jest klasa komórek TD wewnątrz TBODY #wrapper_attributes.
• Klasa wiersza TR wewnątrz THEAD / TFOOT wymaga 'class'i 'data'pojemników.
  Ani tu, ani #attributesnie #wrapper_attributespracuj.
• Klasa komórek TH / TD wewnątrz THEAD / TFOOT wymaga 'class'i 'data'pojemników.
  Ani tu, ani #attributesnie #wrapper_attributespracuj.
• Nie ma możliwości dodania klasy bezpośrednio do tagu <thead>lub <tfoot>bez przesłaniania szablonu gałązki.

Oto najczęstszy przykład dodawania klas do tagów <tr>& <td>wewnątrz tagu main <tbody>, a także do <table>samego tagu main :

$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'],
      ],
    ],
  ],
];

Zauważ, że 'class'kontener akceptuje ciąg lub tablicę, ale sugeruję, aby zawsze używać tablicy.

Odtąd historia staje się bardziej skomplikowana. Jeśli musisz dodać klasy do tagów TR lub TD / TH w obszarze THEAD / TFOOT, reguły całkowicie się zmieniają. Ani #attributesnie #wrapper_attributesdziała wewnątrz, #headerani na #footersekcjach, a próba ich użycia daje bardzo dziwne efekty.

Minimalna struktura tabel z kolumnami danych nagłówka / stopki w Drupal 8 jest następująca:

$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',
  ],
];

Musisz zmienić faktyczną strukturę danych i wprowadzić dwa poziomy dodatkowych tablic wielowymiarowych, aby wykorzystać 'class'indeks tablicy, który wymaga następnie wprowadzenia 'data'indeksu tablicy. Dotyczy to zarówno elementu wiersza, jak i elementów komórki danych, jak pokazano w poniższym przykładzie:

$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
        ],
      ],
    ],
  ],
];

Powyższy przykładowy #headerprzykład daje:

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