theme_links
Definition
theme_links($links, $attributes = array('class' => 'links'))
drupal/includes/theme.inc, line 1146
Description
Return a themed set of links.
Parameters
$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.
$attributes A keyed array of attributes.
Return value
A string containing an unordered list of links.
Related topics
Name | Description |
|---|---|
| Default theme implementations | Functions and templates that present output to the user, and can be implemented by themes. |
Code
function theme_links($links, $attributes = array('class' => 'links')) {
$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()))) {
$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;
}