function ThemingPageController::list

The list page callback.

An example page where the output is supplied as an array which is themed into a list and styled with css.

In this case we'll use the core-provided theme_item_list as a #theme_wrapper. Any theme need only override theme_item_list to change the behavior.

File

modules/theming_example/src/Controller/ThemingPageController.php, line 62

Class

ThemingPageController

Namespace

Code

public function list() {
  $items = [
    $this->t('First item'),
    $this->t('Second item'),
    $this->t('Third item'),
    $this->t('Fourth item'),
  ];
  // First we'll create a render array that simply uses theme_item_list.
  $title = $this->t("A list returned to be rendered using theme('item_list')");
  $build['render_version'] = [
    // We use #theme here instead of #theme_wrappers because theme_item_list()
    // is the classic type of theme function that does not just assume a
    // render array, but instead has its own properties (#type, #title, #items).
'#theme' => 'item_list',
    // '#type' => 'ul',  // The default type is 'ul'
    // We can easily make sure that a css or js file is present using #attached.
'#attached' => [
      'library' => [
        'theming_example/list',
      ],
    ],
    '#title' => $title,
    '#items' => $items,
    '#attributes' => [
      'class' => [
        'render-version-list',
      ],
    ],
  ];
  // Now we'll create a render array which uses our own list formatter,
  // theme('theming_example_list').
  $title = $this->t("The same list rendered by theme('theming_example_list')");
  $build['our_theme_function'] = [
    '#theme' => 'theming_example_list',
    '#attached' => [
      'library' => [
        'theming_example/list',
      ],
    ],
    '#title' => $title,
    '#items' => $items,
  ];
  return $build;
}