. /** * Outputs the navigation tree. * * @since Moodle 2.0 * @package block_navigation * @copyright 2009 Sam Hemelryk * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ /** * Renderer for block navigation * * @package block_navigation * @category navigation * @copyright 2009 Sam Hemelryk * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class block_navigation_renderer extends plugin_renderer_base { /** * Returns the content of the navigation tree. * * @param global_navigation $navigation * @param int $expansionlimit * @param array $options * @return string $content */ public function navigation_tree(global_navigation $navigation, $expansionlimit, array $options = array()) { $navigation->add_class('navigation_node'); $content = $this->navigation_node(array($navigation), array('class'=>'block_tree list'), $expansionlimit, $options); if (isset($navigation->id) && !is_numeric($navigation->id) && !empty($content)) { $content = $this->output->box($content, 'block_tree_box', $navigation->id); } return $content; } /** * Produces a navigation node for the navigation tree * * @param array $items * @param array $attrs * @param int $expansionlimit * @param array $options * @param int $depth * @return string */ protected function navigation_node($items, $attrs=array(), $expansionlimit=null, array $options = array(), $depth=1) { // exit if empty, we don't want an empty ul element if (count($items)==0) { return ''; } // array of nested li elements $lis = array(); foreach ($items as $item) { if (!$item->display && !$item->contains_active_node()) { continue; } $content = $item->get_content(); $title = $item->get_title(); $isexpandable = (empty($expansionlimit) || ($item->type > navigation_node::TYPE_ACTIVITY || $item->type < $expansionlimit) || ($item->contains_active_node() && $item->children->count() > 0)); $isbranch = $isexpandable && ($item->children->count() > 0 || ($item->has_children() && (isloggedin() || $item->type <= navigation_node::TYPE_CATEGORY))); // Skip elements which have no content and no action - no point in showing them if (!$isexpandable && empty($item->action)) { continue; } $hasicon = ((!$isbranch || $item->type == navigation_node::TYPE_ACTIVITY || $item->type == navigation_node::TYPE_RESOURCE) && $item->icon instanceof renderable); if ($hasicon) { $icon = $this->output->render($item->icon); } else { $icon = ''; } $content = $icon.$content; // use CSS for spacing of icons if ($item->helpbutton !== null) { $content = trim($item->helpbutton).html_writer::tag('span', $content, array('class'=>'clearhelpbutton')); } if ($content === '') { continue; } $attributes = array(); if ($title !== '') { $attributes['title'] = $title; } if ($item->hidden) { $attributes['class'] = 'dimmed_text'; } if (is_string($item->action) || empty($item->action) || (($item->type === navigation_node::TYPE_CATEGORY || $item->type === navigation_node::TYPE_MY_CATEGORY) && empty($options['linkcategories']))) { $attributes['tabindex'] = '0'; //add tab support to span but still maintain character stream sequence. $content = html_writer::tag('span', $content, $attributes); } else if ($item->action instanceof action_link) { //TODO: to be replaced with something else $link = $item->action; $link->text = $icon.$link->text; $link->attributes = array_merge($link->attributes, $attributes); $content = $this->output->render($link); $linkrendered = true; } else if ($item->action instanceof moodle_url) { $content = html_writer::link($item->action, $content, $attributes); } // this applies to the li item which contains all child lists too $liclasses = array($item->get_css_type(), 'depth_'.$depth); $liexpandable = array(); if ($item->has_children() && (!$item->forceopen || $item->collapse)) { $liclasses[] = 'collapsed'; } if ($isbranch) { $liclasses[] = 'contains_branch'; $liexpandable = array('aria-expanded' => in_array('collapsed', $liclasses) ? "false" : "true"); } else if ($hasicon) { $liclasses[] = 'item_with_icon'; } if ($item->isactive === true) { $liclasses[] = 'current_branch'; } $liattr = array('class' => join(' ',$liclasses)) + $liexpandable; // class attribute on the div item which only contains the item content $divclasses = array('tree_item'); if ($isbranch) { $divclasses[] = 'branch'; } else { $divclasses[] = 'leaf'; } if ($hasicon) { $divclasses[] = 'hasicon'; } if (!empty($item->classes) && count($item->classes)>0) { $divclasses[] = join(' ', $item->classes); } $divattr = array('class'=>join(' ', $divclasses)); if (!empty($item->id)) { $divattr['id'] = $item->id; } $content = html_writer::tag('p', $content, $divattr); if ($isexpandable) { $content .= $this->navigation_node($item->children, array(), $expansionlimit, $options, $depth+1); } if (!empty($item->preceedwithhr) && $item->preceedwithhr===true) { $content = html_writer::empty_tag('hr') . $content; } $content = html_writer::tag('li', $content, $liattr); $lis[] = $content; } if (count($lis)) { return html_writer::tag('ul', implode("\n", $lis), $attrs); } else { return ''; } } }