DrupalAPI.de

1. drupal
   1. drupal6
   2. drupal7

Return a themed set of links.

Übergabeparameter

$links A keyed array of links to be themed. The key for each link is used as its css class. Each link should be itself an array, with the following keys:

• title: the link text
• href: the link URL. If omitted, the 'title' is shown as a plain text item in the links list.
• html: (optional) set this to TRUE if 'title' is HTML so it will be escaped.

Array items are passed on to the l() function's $options parameter when creating the link.

$attributes A keyed array of attributes.

Rückgabewert

A string containing an unordered list of links.

Verwandte Themen

Default theme implementations

Functions and templates that present output to the user, and can be implemented by themes.

Code

includes/theme.inc, line 1206

<?php
function theme_links($links, $attributes = array('class' => 'links')) {
  global $language;
  $output = '';

  if (count($links) > 0) {
    $output = '<ul' . drupal_attributes($attributes) . '>';

    $num_links = count($links);
    $i = 1;

    foreach ($links as $key => $link) {
      $class = $key;

      // Add first, last and active classes to the list of links to help out themers.
      if ($i == 1) {
        $class .= ' first';
      }
      if ($i == $num_links) {
        $class .= ' last';
      }
      if (isset($link['href']) && ($link['href'] == $_GET['q'] || ($link['href'] == '<front>' && drupal_is_front_page()))
           && (empty($link['language']) || $link['language']->language == $language->language)) {
        $class .= ' active';
      }
      $output .= '<li' . drupal_attributes(array('class' => $class)) . '>';

      if (isset($link['href'])) {
        // Pass in $link as $options, they share the same keys.
        $output .= l($link['title'], $link['href'], $link);
      }
      elseif (!empty($link['title'])) {
        // Some links are actually not links, but we wrap these in <span> for adding title and class attributes.
        if (empty($link['html'])) {
          $link['title'] = check_plain($link['title']);
        }
        $span_attributes = '';
        if (isset($link['attributes'])) {
          $span_attributes = drupal_attributes($link['attributes']);
        }
        $output .= '<span' . $span_attributes . '>' . $link['title'] . '</span>';
      }

      $i++;
      $output .= "</li>\n";
    }

    $output .= '</ul>';
  }

  return $output;
}
?>