mirror of
https://gerrit.wikimedia.org/r/mediawiki/skins/MinervaNeue
synced 2024-11-15 10:27:31 +00:00
edb4385345
A list that toggles visibility via the checkbox hack is needed in at least two spots: the page actions overflow menu and the user menu. This patch makes several refactors to turn what was previously hardcoded into page actions a reusable component: - Start a new components directory. Components are reusable and composable. The subdirectories are organized by function, not ResourceLoader module bundling which greatly improves the ability to see a component's full functionality in one directory instead of examining the entire codebase. See updates to README. - Extract pageactions.less into: - ToggleList.less: LESS for any checkbox hack list. - DropDownList.less: LESS for lists that open downwards. - MenuListItem.less: LESS for list items of menus. The division makes it easier to see concerns, dependencies, and change code. - Move pageActionMenu.mustache to a component and extract ToggleList template. - Extract ToggleList.js from Toolbar.js. Bug: T214540 Change-Id: I171831469a6733c458bc5c7ba249a5096ca975b8
112 lines
3.3 KiB
PHP
112 lines
3.3 KiB
PHP
<?php
|
|
/**
|
|
* This program 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 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program 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 this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* @file
|
|
*/
|
|
|
|
namespace MediaWiki\Minerva\Menu\PageActions;
|
|
|
|
use Hooks;
|
|
use MediaWiki\Minerva\Menu\Group;
|
|
use MediaWiki\Minerva\SkinUserPageHelper;
|
|
use MessageLocalizer;
|
|
use MinervaUI;
|
|
use MWException;
|
|
use SpecialPage;
|
|
use User;
|
|
|
|
class UserNamespaceOverflowBuilder implements IOverflowBuilder {
|
|
|
|
/**
|
|
* @var MessageLocalizer
|
|
*/
|
|
private $messageLocalizer;
|
|
|
|
/**
|
|
* @var User|null
|
|
*/
|
|
private $pageUser;
|
|
|
|
/**
|
|
* Initialize the overflow menu visible on the User namespace
|
|
* @param MessageLocalizer $msgLocalizer
|
|
* @param SkinUserPageHelper $userPageHelper
|
|
*/
|
|
public function __construct( MessageLocalizer $msgLocalizer, SkinUserPageHelper $userPageHelper ) {
|
|
$this->messageLocalizer = $msgLocalizer;
|
|
$this->pageUser = $userPageHelper->getPageUser();
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
* @throws MWException
|
|
*/
|
|
public function getGroup( array $toolbox ): Group {
|
|
$group = new Group();
|
|
$group->insertEntry( $this->build(
|
|
'uploads', 'upload', SpecialPage::getTitleFor( 'Uploads', $this->pageUser )->getLocalURL()
|
|
) );
|
|
|
|
$possibleEntries = array_filter( [
|
|
$this->buildFromToolbox( 'user-rights', 'userAvatar', 'userrights', $toolbox ),
|
|
$this->buildFromToolbox( 'logs', 'listBullet', 'log', $toolbox ),
|
|
$this->buildFromToolbox( 'info', 'info', 'info', $toolbox ),
|
|
$this->buildFromToolbox( 'permalink', 'link', 'permalink', $toolbox ),
|
|
$this->buildFromToolbox( 'backlinks', 'articleRedirect', 'whatlinkshere', $toolbox )
|
|
] );
|
|
|
|
foreach ( $possibleEntries as $menuEntry ) {
|
|
$group->insertEntry( $menuEntry );
|
|
}
|
|
Hooks::run( 'MobileMenu', [ 'pageactions.overflow', &$group ] );
|
|
return $group;
|
|
}
|
|
|
|
/**
|
|
* Build entry based on the $toolbox element
|
|
*
|
|
* @param string $name
|
|
* @param string $icon Wikimedia UI icon name.
|
|
* @param string $toolboxIdx
|
|
* @param array $toolbox An array of common toolbox items from the sidebar menu
|
|
* @return PageActionMenuEntry|null
|
|
*/
|
|
private function buildFromToolbox( $name, $icon, $toolboxIdx, array $toolbox ) {
|
|
return $this->build( $name, $icon, $toolbox[$toolboxIdx]['href'] ?? null );
|
|
}
|
|
|
|
/**
|
|
* Build single Menu entry
|
|
*
|
|
* @param string $name
|
|
* @param string $icon Wikimedia UI icon name.
|
|
* @param string|null $href
|
|
* @return PageActionMenuEntry|null
|
|
*/
|
|
private function build( $name, $icon, $href ) {
|
|
return $href ?
|
|
new PageActionMenuEntry(
|
|
'page-actions-overflow-' . $name,
|
|
$href,
|
|
MinervaUI::iconClass(
|
|
'', 'before', 'wikimedia-ui-' . $icon . '-base20 toggle-list-item__anchor--menu'
|
|
),
|
|
$this->messageLocalizer->msg( 'minerva-page-actions-' . $name )
|
|
) : null;
|
|
}
|
|
}
|