10.11 主题函数建议

作者：老葛，北京亚艾元软件有限责任公司，http://www.yaiyuan.com

我们向template.php文件中添加以下代码：

function snt_menu_tree__main_menu($variables) {

  return '<ul>' . $variables['tree'] . '</ul>';

}

注意我们这里的函数名字，我们是可以使用snt_menu_tree，不过这将作用于所有的菜单，我们只想作用于主菜单，所以在后面加了__main_menu，这是主题函数建议，和模板建议是一个概念。

对于模板建议，我们知道，模板建议规则，是在模板文件的预处理函数中，通过'theme_hook_suggestions'定义的。很多人可能会问，主题函数的建议，是在什么地方定义的？在Drupal6的时候，主题函数是没有建议这么一说的，只有模板建议，在Drupal7下面改进了一下，增加了主题函数的建议，不是每个主题函数都支持建议的，需要具体情况具体分析，这取决于不断地实践。对于theme_menu_tree，我们在menu_tree_output函数里面，代码的最后部分：

    // Add the theme wrapper for outer markup.

    // Allow menu-specific theme overrides.

    $build['#theme_wrappers'][] = 'menu_tree__' . strtr($data['link']['menu_name'], '-', '_');

theme_menu_tree的建议规则，就是在这里定义的，所以我们可以使用snt_menu_tree__main_menu这个函数，它只作用于主菜单。

现在清除缓存，访问首页，通过Firebug查看源代码：

 

ul标签上面的class属性已经被我们删除了，不过主导航的样式，还没有调整过来。我们现在覆写theme_menu_link，将这个函数从menu.inc中，复制到template.php中，我们来看一下默认的样子：

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";

}

我们对它做相应的调整，这是调整后的代码：

function snt_menu_link__main_menu(array $variables) {

  $element = $variables['element'];

  $sub_menu = '';

 

  if ($element['#below']) {

    $sub_menu = drupal_render($element['#below']);

  }

  $output = l('<span>'.$element['#title'].'</span>', $element['#href'], array('html' => TRUE,));

  return '<li>' . $output . $sub_menu . "</li>\n";

}

这里面有两处修改，首先是将函数名字改为了snt_menu_link__main_menu，这里面的__main_menu，和前面我们用的，一样，都是主题函数建议；其次，就是将li里面的属性输出，给删除了。

可能还会有人问，我是怎么知道这个主题函数的建议规则的？在menu_tree_output函数里面，中间部分，有这样两行代码：

    // Allow menu-specific theme overrides.

$element['#theme'] = 'menu_link__' . strtr($data['link']['menu_name'], '-', '_');

这里定义了theme_menu_link的建议规则。

 

现在清除缓存，查看源代码，和目标输出已经完全一致了：

 

当然，此时的样式，也正常了：

 

对于下面的友情链接，我们也可以将它改造为菜单的形式，覆写的办法和这里一样，我们这里采用静态区块的形式就可以了。