mediawiki-skins-Vector/includes/Components/VectorComponentMainMenuAction.php
Umherirrender b962638262 Replace empty() with a string compare
empty() should only be used to suppress errors
Found by a new phan plugin (T234237)

Change-Id: I10b562aa04eb9cf974e301567e74f2f620027ba8
2023-10-21 20:26:30 +02:00

72 lines
2 KiB
PHP

<?php
namespace MediaWiki\Skins\Vector\Components;
use Skin;
/**
* VectorComponentMainMenuAction component
*/
class VectorComponentMainMenuAction implements VectorComponent {
/** @var Skin */
private $skin;
/** @var array */
private $htmlData;
/** @var array */
private $headingOptions;
/** @var string */
private $actionName;
/** @var string */
private $classes;
/**
* @param string $actionName identifier for the action. Used to add class
* @param Skin $skin
* @param array $htmlData data to make a link or raw html
* @param array $headingOptions optional heading for the html
* @param string $classes extra classes to add to this component
*/
public function __construct(
string $actionName, Skin $skin, array $htmlData,
array $headingOptions, string $classes = ''
) {
$this->skin = $skin;
$this->htmlData = $htmlData;
$this->headingOptions = $headingOptions;
$this->actionName = $actionName;
$this->classes = $classes;
}
/**
* Generate data needed to create MainMenuAction item.
* @param array $htmlData data to make a link or raw html
* @param array $headingOptions optional heading for the html
* @return array keyed data for the MainMenuAction template
*/
private function makeMainMenuActionData( array $htmlData = [], array $headingOptions = [] ): array {
$skin = $this->skin;
$htmlContent = '';
// Populates the main menu as a standalone link or custom html.
if ( array_key_exists( 'link', $htmlData ) ) {
$htmlContent = $skin->makeLink( 'link', $htmlData['link'] );
} elseif ( array_key_exists( 'html-content', $htmlData ) ) {
$htmlContent = $htmlData['html-content'];
}
if ( $this->classes !== '' ) {
$headingOptions['class'] = $this->classes;
}
return $headingOptions + [
'action' => $this->actionName,
'html-content' => $htmlContent,
];
}
/**
* @inheritDoc
*/
public function getTemplateData(): array {
return $this->makeMainMenuActionData( $this->htmlData, $this->headingOptions );
}
}