mirror of
https://gerrit.wikimedia.org/r/mediawiki/skins/Vector.git
synced 2024-12-01 10:46:54 +00:00
ca9ba6cc65
CVE-2023-PENDING The line param can contain some markup (since headings can contain markup), so make that a raw param. Bug: T340217 Change-Id: I9295a8e0f9f00b62d5206f6d7e40bb657f43651a
99 lines
2.4 KiB
PHP
99 lines
2.4 KiB
PHP
<?php
|
|
namespace MediaWiki\Skins\Vector\Components;
|
|
|
|
use Config;
|
|
use MediaWiki\Skins\Vector\Constants;
|
|
use MediaWiki\Skins\Vector\FeatureManagement\FeatureManager;
|
|
use MessageLocalizer;
|
|
|
|
/**
|
|
* VectorComponentTableOfContents component
|
|
*/
|
|
class VectorComponentTableOfContents implements VectorComponent {
|
|
|
|
/** @var array */
|
|
private $tocData;
|
|
|
|
/** @var MessageLocalizer */
|
|
private $localizer;
|
|
|
|
/** @var bool */
|
|
private $isPinned;
|
|
|
|
/** @var Config */
|
|
private $config;
|
|
|
|
/** @var VectorComponentPinnableHeader */
|
|
private $pinnableHeader;
|
|
|
|
/** @var string */
|
|
public const ID = 'vector-toc';
|
|
|
|
/**
|
|
* @param array $tocData
|
|
* @param MessageLocalizer $localizer
|
|
* @param Config $config
|
|
* @param FeatureManager $featureManager
|
|
*/
|
|
public function __construct(
|
|
array $tocData,
|
|
MessageLocalizer $localizer,
|
|
Config $config,
|
|
FeatureManager $featureManager
|
|
) {
|
|
$this->tocData = $tocData;
|
|
$this->localizer = $localizer;
|
|
$this->isPinned = $featureManager->isFeatureEnabled( Constants::FEATURE_TOC_PINNED );
|
|
$this->config = $config;
|
|
$this->pinnableHeader = new VectorComponentPinnableHeader(
|
|
$this->localizer,
|
|
$this->isPinned,
|
|
self::ID,
|
|
'toc-pinned',
|
|
false,
|
|
'h2'
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function isPinned(): bool {
|
|
return $this->isPinned;
|
|
}
|
|
|
|
/**
|
|
* In tableOfContents.js we have tableOfContents::getTableOfContentsSectionsData(),
|
|
* that yields the same result as this function, please make sure to keep them in sync.
|
|
* @inheritDoc
|
|
*/
|
|
public function getTemplateData(): array {
|
|
$sections = $this->tocData[ 'array-sections' ] ?? [];
|
|
if ( empty( $sections ) ) {
|
|
return [];
|
|
}
|
|
// Populate button labels for collapsible TOC sections
|
|
foreach ( $sections as &$section ) {
|
|
if ( $section['is-top-level-section'] && $section['is-parent-section'] ) {
|
|
$section['vector-button-label'] =
|
|
$this->localizer->msg( 'vector-toc-toggle-button-label' )
|
|
->rawParams( $section['line'] )
|
|
->escaped();
|
|
}
|
|
}
|
|
$this->tocData[ 'array-sections' ] = $sections;
|
|
|
|
$pinnableElement = new VectorComponentPinnableElement( self::ID );
|
|
|
|
return $pinnableElement->getTemplateData() +
|
|
array_merge( $this->tocData, [
|
|
'vector-is-collapse-sections-enabled' =>
|
|
count( $this->tocData['array-sections'] ) > 3 &&
|
|
$this->tocData[ 'number-section-count'] >= $this->config->get(
|
|
'VectorTableOfContentsCollapseAtCount'
|
|
),
|
|
'data-pinnable-header' => $this->pinnableHeader->getTemplateData(),
|
|
] );
|
|
}
|
|
}
|