theme_menu_link

7 menu.inc	`theme_menu_link(array $variables)`
8 menu.inc	`theme_menu_link(array $variables)`

Returns HTML for a menu link and submenu.

Parameters

$variables: An associative array containing:

element: Structured array data for a menu link.

File

includes/menu.inc, line 1621: API for the Drupal menu system.

Code

function theme_menu_link(array $variables) {
  $element = $variables['element'];
  $sub_menu = '';

  if ($element['#below']) {
    $sub_menu = drupal_render($element['#below']);
  }
  $output = l($element['#title'], $element['#href'], $element['#localized_options']);
  return '<li' . drupal_attributes($element['#attributes']) . '>' . $output . $sub_menu . "</li>\n";
}

Comments

Add unique class (mlid) to all menu items.

Posted by betarobot on January 20, 2011 at 4:22pm

I needed to style a few random menu links. Main and secondary menus has a great class .menu-123 (.menu-mlid) to do that. So here how you can port the same behavior to any/all menu items:

<?php
/**
* Add unique class (mlid) to all menu items.
*/
function superseven_menu_link(array $variables) {
  $element = $variables['element'];
  $sub_menu = '';

  $element['#attributes']['class'][] = 'menu-' . $element['#original_link']['mlid'];

  if ($element['#below']) {
    $sub_menu = drupal_render($element['#below']);
  }
  $output = l($element['#title'], $element['#href'], $element['#localized_options']);
  return '<li' . drupal_attributes($element['#attributes']) . '>' . $output . $sub_menu . "</li>\n";
}
?>

Wouldn't this be more concise and flexible?

Posted by wgsimon on February 29, 2012 at 10:09pm

Or is this the wrong way to do it?

<?php
function superseven_menu_link(array $variables) {
  $variables['element']['#attributes']['class'][] = 'menu-' . $variables['element']['#original_link']['mlid'];

  return theme_menu_link($variables);
}
?>

Analog from Drupal 6

Posted by soyarma on March 23, 2011 at 3:56pm

http://api.drupal.org/api/drupal/includes--menu.inc/function/theme_menu_...

Also with menu title as class

Posted by bullz on June 21, 2011 at 12:28pm

<?php
/**
* Add unique class (mlid) to all menu items.
* with Menu title as class
*/

function yourtheme_menu_link(array $variables) {
  $element = $variables['element'];
  $sub_menu = '';
  $name_id = strtolower(strip_tags($element['#title']));
// remove colons and anything past colons
  if (strpos($name_id, ':')) $name_id = substr ($name_id, 0, strpos($name_id, ':'));
//Preserve alphanumerics, everything else goes away
  $pattern = '/[^a-z]+/ ';
  $name_id = preg_replace($pattern, '', $name_id);
  $element['#attributes']['class'][] = 'menu-' . $element['#original_link']['mlid'] . ' '.$name_id;
  if ($element['#below']) {
    $sub_menu = drupal_render($element['#below']);
  }
  $output = l($element['#title'], $element['#href'], $element['#localized_options']);
  return '<li' . drupal_attributes($element['#attributes']) . '>' . $output . $sub_menu . "</li>\n";
}
?>

Thank you

Posted by Taiger on September 15, 2011 at 4:50pm

Hey thanks it works great!

Definition of $element

Posted by ReneD on December 11, 2011 at 5:59am

Do you know where I can get the $element array definition?

Thanks!

adding level deph as class

Posted by loominade on September 23, 2011 at 1:17pm

<?php
function [your_theme]_menu_link(array $variables) {
  $element = $variables['element'];
  $sub_menu = '';
  
  $element['#attributes']['class'][] = 'level-' . $element['#original_link']['depth'];

  if ($element['#below']) {
    $sub_menu = drupal_render($element['#below']);
  }
  $output = l($element['#title'], $element['#href'], $element['#localized_options']);
  return '<li' . drupal_attributes($element['#attributes']) . '>' . $output . $sub_menu . "</li>\n";
}
?>

so that's how!

Posted by scorchio on February 7, 2012 at 3:53pm

I've spent half a day trying to get the depth when I've stumbled across your example with $element['#original_link']['depth']. Thanks, that solved a huge problem on my part!

How to add class to the menu himself

Posted by tazir1 on October 25, 2011 at 8:34am

I wanna add class to the whole menu: not to the "il", but to "ul".
How to do its?

theme_menu_tree

Posted by mynameispj on March 25, 2012 at 11:20pm

Check out theme_menu_tree

My Name is PJ

Use theme_links() to add class to <ul>

Posted by olragon on November 6, 2011 at 6:28am

tazir1: @see attributes at theme_links()

Theme only a specific menu block.

Posted by Kara Todd on January 18, 2012 at 5:43pm

This gave me some trouble so I thought I'd share.

We needed to style only a specific menu block (top nav) but not the sidebar nav that was generated off of the same menu.

So theme_menu_link__main_menu() did not work for us.

However, I was able to target only the block I needed using the menu block module and theme_menu_link__menu_block__[block-number]()
described under "Theme Menu functions".

Hopefully this helps some one else as well.

Print out variables

Posted by vector_ray on February 17, 2012 at 6:08pm

I found this helpful when customizing the link info.

<?php
//print out variables for the link array
function theme_menu_link(array $variables) {
  return print_r($variables['element']);
}
?>

Targeted Override

Posted by wgsimon on March 10, 2012 at 2:23pm

I don't see it documented elsewhere that you can implement a THEMENAME_menu_link__MENU_NAME() function as an override for a specific menu.

See http://drupal.org/node/254940#theme-suggestions-for-menus.

Just add the menu name and your theme name

Posted by ahimsauzi on April 11, 2012 at 1:34pm

wgsimon, to target specific menu, use the name of the menu from admin/structure/menu page (replace any hyphens with underscores) and append your theme name to the beginning of the function.

Make any menu specific changes to the body of the function and you are done!