function theme_table


Error message

User warning: The following module is missing from the file system: theme/theme. For information about how to fix this, see the documentation page. in _drupal_trigger_error_with_delayed_logging() (line 1156 of /var/www/html/elmsln_community/
cis7 theme_table($variables)
cle7 theme_table($variables)
elmsmedia7 theme_table($variables)
icor7 theme_table($variables)
meedjum_blog7 theme_table($variables)
mooc7 theme_table($variables)

Returns HTML for a table.


$variables: An associative array containing:

  • header: An array containing the table headers. Each element of the array can be either a localized string or an associative array with the following keys:

    • "data": The localized title of the table column.
    • "field": The database field represented in the table column (required if user is to be able to sort on this column).
    • "sort": A default sort order for this column ("asc" or "desc"). Only one column should be given a default sort order because table sorting only applies to one column at a time.
    • Any HTML attributes, such as "colspan", to apply to the column header cell.
  • rows: An array of table rows. Every row is an array of cells, or an associative array with the following keys:

    • "data": an array of cells
    • Any HTML attributes, such as "class", to apply to the table row.
    • "no_striping": a boolean indicating that the row should receive no 'even / odd' styling. Defaults to FALSE.

    Each cell can be either a string or an associative array with the following keys:

    • "data": The string to display in the table cell.
    • "header": Indicates this cell is a header.
    • Any HTML attributes, such as "colspan", to apply to the table cell.

    Here's an example for $rows:

    $rows = array(
      // Simple row
        'Cell 1', 'Cell 2', 'Cell 3'
      // Row with attributes on the row and some of its cells.
        'data' => array('Cell 1', array('data' => 'Cell 2', 'colspan' => 2)), 'class' => array('funky')
  • attributes: An array of HTML attributes to apply to the table tag.
  • caption: A localized string to use for the <caption> tag.
  • colgroups: An array of column groups. Each element of the array can be either:

    • An array of columns, each of which is an associative array of HTML attributes applied to the COL element.
    • An array of attributes applied to the COLGROUP element, which must include a "data" attribute. To add attributes to COL elements, set the "data" attribute with an array of columns, each of which is an associative array of HTML attributes.

    Here's an example for $colgroup:

    $colgroup = array(
      // COLGROUP with one COL element.
          'class' => array('funky'), // Attribute for the COL element.
      // Colgroup with attributes and inner COL elements.
        'data' => array(
            'class' => array('funky'), // Attribute for the COL element.
        'class' => array('jazzy'), // Attribute for the COLGROUP element.

These optional tags are used to group and set properties on columns within a table. For example, one may easily group three columns and apply same background style to all.

  • sticky: Use a "sticky" table header.
  • empty: The message to display in an extra row if table does not have any rows.

Related topics

1 call to theme_table()
theme_table__field_collection_table in sites/all/modules/ulmus/field_collection_table/theme/
Derivative of theme_table() solely for the HOOK_preprocess_table__PATTERN().
131 theme calls to theme_table()
aggregator_view in modules/aggregator/
Displays the aggregator administration page.
apc_shutdown in sites/all/modules/ulmus/apc/apc.module
See apc_init() which registers this function as a shutdown function. Displays apc stats in the footer.
backup_migrate_item::get_list in sites/all/modules/ulmus/backup_migrate/includes/
Get a table of all items of this type.
backup_migrate_ui_destination_display_files in sites/all/modules/ulmus/backup_migrate/includes/
List the backup files in the given destination.
book_admin_overview in modules/book/
Returns an administrative overview of all books.

... See full list

483 string references to the theme hook from theme_table()

Note: this list is generated by looking for the string for this theme hook, so it may include some references that are not actually using this theme hook.

accessibility_admin_existing_tests in sites/all/modules/ulmus/accessibility/
List existing accessibility tests. @todo - add a filter form
accessibility_reporting_schema in sites/all/modules/ulmus/accessibility/modules/accessibility_reporting/accessibility_reporting.install
Implements hook_schema().
accessibility_reporting_views_data in sites/all/modules/ulmus/accessibility/modules/accessibility_reporting/views/
Implements hook_views_data().
accessibility_reporting_views_default_views in sites/all/modules/ulmus/accessibility/modules/accessibility_reporting/views/
accessibility_views_data in sites/all/modules/ulmus/accessibility/views/
@file Providing extra functionality for views.

... See full list


includes/, line 1895
The theme system, which controls the output of Drupal.


function theme_table($variables) {
  $header = $variables['header'];
  $rows = $variables['rows'];
  $attributes = $variables['attributes'];
  $caption = $variables['caption'];
  $colgroups = $variables['colgroups'];
  $sticky = $variables['sticky'];
  $empty = $variables['empty'];

  // Add sticky headers, if applicable.
  if (count($header) && $sticky) {
    // Add 'sticky-enabled' class to the table to identify it for JS.
    // This is needed to target tables constructed by this function.
    $attributes['class'][] = 'sticky-enabled';

  $output = '<table' . drupal_attributes($attributes) . ">\n";

  if (isset($caption)) {
    $output .= '<caption>' . $caption . "</caption>\n";

  // Format the table columns:
  if (count($colgroups)) {
    foreach ($colgroups as $number => $colgroup) {
      $attributes = array();

      // Check if we're dealing with a simple or complex column
      if (isset($colgroup['data'])) {
        foreach ($colgroup as $key => $value) {
          if ($key == 'data') {
            $cols = $value;
          else {
            $attributes[$key] = $value;
      else {
        $cols = $colgroup;

      // Build colgroup
      if (is_array($cols) && count($cols)) {
        $output .= ' <colgroup' . drupal_attributes($attributes) . '>';
        $i = 0;
        foreach ($cols as $col) {
          $output .= ' <col' . drupal_attributes($col) . ' />';
        $output .= " </colgroup>\n";
      else {
        $output .= ' <colgroup' . drupal_attributes($attributes) . " />\n";

  // Add the 'empty' row message if available.
  if (!count($rows) && $empty) {
    $header_count = 0;
    foreach ($header as $header_cell) {
      if (is_array($header_cell)) {
        $header_count += isset($header_cell['colspan']) ? $header_cell['colspan'] : 1;
      else {
    $rows[] = array(array(
      'data' => $empty,
      'colspan' => $header_count,
      'class' => array('empty', 'message'),

  // Format the table header:
  if (count($header)) {
    $ts = tablesort_init($header);
    // HTML requires that the thead tag has tr tags in it followed by tbody
    // tags. Using ternary operator to check and see if we have any rows.
    $output .= (count($rows) ? ' <thead><tr>' : ' <tr>');
    foreach ($header as $cell) {
      $cell = tablesort_header($cell, $header, $ts);
      $output .= _theme_table_cell($cell, TRUE);
    // Using ternary operator to close the tags based on whether or not there are rows
    $output .= (count($rows) ? " </tr></thead>\n" : "</tr>\n");
  else {
    $ts = array();

  // Format the table rows:
  if (count($rows)) {
    $output .= "<tbody>\n";
    $flip = array(
      'even' => 'odd',
      'odd' => 'even',
    $class = 'even';
    foreach ($rows as $number => $row) {
      // Check if we're dealing with a simple or complex row
      if (isset($row['data'])) {
        $cells = $row['data'];
        $no_striping = isset($row['no_striping']) ? $row['no_striping'] : FALSE;

        // Set the attributes array and exclude 'data' and 'no_striping'.
        $attributes = $row;
      else {
        $cells = $row;
        $attributes = array();
        $no_striping = FALSE;
      if (count($cells)) {
        // Add odd/even class
        if (!$no_striping) {
          $class = $flip[$class];
          $attributes['class'][] = $class;

        // Build row
        $output .= ' <tr' . drupal_attributes($attributes) . '>';
        $i = 0;
        foreach ($cells as $cell) {
          $cell = tablesort_cell($cell, $header, $ts, $i++);
          $output .= _theme_table_cell($cell);
        $output .= " </tr>\n";
    $output .= "</tbody>\n";

  $output .= "</table>\n";
  return $output;