theme_item_list

Versions
5 – 6
theme_item_list($items = array(), $title = NULL, $type = 'ul', $attributes = NULL)
7
theme_item_list($variables)

Return a themed list of items.

Parameters

$items An array of items to be displayed in the list. If an item is a string, then it is used as is. If an item is an array, then the "data" element of the array is used as the contents of the list item. If an item is an array with a "children" element, those children are displayed in a nested list. All other elements are treated as attributes of the list item element.

$title The title of the list.

$attributes The attributes applied to the list element.

$type The type of list to return (e.g. "ul", "ol")

Return value

A string containing the list output.

Related topics

Themeable functions
Functions that display HTML, and which can be customized by themes.

▸ 4 functions call theme_item_list()

▾ 4 functions call theme_item_list()

theme_apachesolr_currentsearch in contributions/apachesolr/apachesolr_search.module
Return current search block contents
theme_item_list in 5/includes/theme.inc
Return a themed list of items.
uc_file_files_form in contributions/ubercart/uc_file/uc_file.module
Form builder for file products admin
uc_store_ubercart_help in contributions/ubercart/uc_store/uc_store.module
Display store help page.

Code

5/includes/theme.inc, line 932

<?php
function theme_item_list($items = array(), $title = NULL, $type = 'ul', $attributes = NULL) {
  $output = '<div class="item-list">';
  if (isset($title)) {
    $output .= '<h3>'. $title .'</h3>';
  }

  if (!empty($items)) {
    $output .= "<$type" . drupal_attributes($attributes) . '>';
    foreach ($items as $item) {
      $attributes = array();
      $children = array();
      if (is_array($item)) {
        foreach ($item as $key => $value) {
          if ($key == 'data') {
            $data = $value;
          }
          elseif ($key == 'children') {
            $children = $value;
          }
          else {
            $attributes[$key] = $value;
          }
        }
      }
      else {
        $data = $item;
      }
      if (count($children) > 0) {
        $data .= theme_item_list($children, NULL, $type, $attributes); // Render nested list
      }
      $output .= '<li' . drupal_attributes($attributes) . '>'. $data .'</li>';
    }
    $output .= "</$type>";
  }
  $output .= '</div>';
  return $output;
}
?>