Files
moodle/lib/classes/navigation/output/more_menu.php
T
Jun Pataleta 1f21daf8b3 MDL-72481 core: Fix more menu keyboard navigation
* Allow the more menu to be rendered as a tablist when needed.
* Let menu_navigation handle keyboard navigation only when
menu items are not rendered as dropdowns. Otherwise, leave
the keyboard navigation handling via the default handlers
(e.g. dropdown.js/aria.js/tab.js).
* When the more menu is rendered as a tablist, use aria-selected
for the selected tab. When it's rendered as a menu, use aria-current
for the selected menu item. (The menuitem role supports aria-current and
not aria-selected)
* Make sure that the active tab is tabbable by default.
* Submenu items should always have tabindex=-1
* Update behat to use css_element instead of xpath. Also, improved it
to consider that it is the active element that should be tabbable.

Co-authored-by: Shamim Rezaie <shamim@moodle.com>
2022-03-15 12:48:21 +11:00

93 lines
3.3 KiB
PHP

<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
namespace core\navigation\output;
use renderable;
use renderer_base;
use templatable;
use custom_menu;
/**
* more menu navigation renderable
*
* @package core
* @category navigation
* @copyright 2021 onwards Adrian Greeve
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class more_menu implements renderable, templatable {
protected $content;
protected $navbarstyle;
protected $haschildren;
protected $istablist;
/**
* Constructor for this class.
*
* @param object $content Navigation objects.
* @param string $navbarstyle class name.
* @param bool $haschildren The content has children.
* @param bool $istablist When true, the more menu should be rendered and behave with a tablist ARIA role.
* If false, it's rendered with a menubar ARIA role. Defaults to false.
*/
public function __construct(object $content, string $navbarstyle, bool $haschildren = true, bool $istablist = false) {
$this->content = $content;
$this->navbarstyle = $navbarstyle;
$this->haschildren = $haschildren;
$this->istablist = $istablist;
}
/**
* Return data for rendering a template.
*
* @param renderer_base $output The output
* @return array Data for rendering a template
*/
public function export_for_template(renderer_base $output): array {
$data = [
'navbarstyle' => $this->navbarstyle,
'istablist' => $this->istablist,
];
if ($this->haschildren) {
// The node collection doesn't have anything to render so exit now.
if (!isset($this->content->children) || count($this->content->children) == 0) {
return [];
}
// Find all nodes that have children and are defined to show the children in a submenu.
// For each of these nodes we would like to display a dropdown menu and in order to achieve that
// (as required by the template) we need to set the node's property 'moremenuid' to a new unique value and
// 'haschildren' to true.
foreach ($this->content->children as &$item) {
if ($item->showchildreninsubmenu && isset($this->content->children) &&
count($this->content->children) > 0) {
$item->moremenuid = uniqid();
$item->haschildren = true;
}
}
$data['nodecollection'] = $this->content;
} else {
$data['nodearray'] = (array) $this->content;
}
$data['moremenuid'] = uniqid();
return $data;
}
}