OOUIFileModule.php

Go to the documentation of this file.

<?php
namespace MediaWiki\ResourceLoader;
 
class OOUIFileModule extends FileModule {
    use OOUIModule;
 
    private $themeStyles = [];
 
    public function __construct( array $options = [] ) {
        if ( isset( $options['themeScripts'] ) ) {
            $skinScripts = $this->getSkinSpecific( $options['themeScripts'], 'scripts' );
            $options['skinScripts'] = $this->extendSkinSpecific( $options['skinScripts'] ?? [], $skinScripts );
        }
        if ( isset( $options['themeStyles'] ) ) {
            $this->themeStyles = $this->getSkinSpecific( $options['themeStyles'], 'styles' );
        }
 
        parent::__construct( $options );
    }
 
    public function setSkinStylesOverride( array $moduleSkinStyles ): void {
        parent::setSkinStylesOverride( $moduleSkinStyles );
 
        $this->skinStyles = $this->extendSkinSpecific( $this->skinStyles, $this->themeStyles );
    }
 
    private function getSkinSpecific( $module, $which ): array {
        $themes = self::getSkinThemeMap();
 
        return array_combine(
            array_keys( $themes ),
            array_map( function ( $theme ) use ( $module, $which ) {
                if ( $which === 'scripts' ) {
                    return $this->getThemeScriptsPath( $theme, $module );
                } else {
                    return $this->getThemeStylesPath( $theme, $module );
                }
            }, array_values( $themes ) )
        );
    }
 
    private function extendSkinSpecific( array $skinSpecific, array $themeSpecific ): array {
        // If the module or skin already set skinStyles/skinScripts, prepend ours
        foreach ( $skinSpecific as $skin => &$files ) {
            $prepend = $themeSpecific[$skin] ?? $themeSpecific['default'] ?? null;
            if ( $prepend !== null ) {
                if ( !is_array( $files ) ) {
                    $files = [ $files ];
                }
                array_unshift( $files, $prepend );
            }
        }
        // If the module has no skinStyles/skinScripts for a skin, then set ours
        foreach ( $themeSpecific as $skin => $file ) {
            $skinSpecific[$skin] ??= [ $file ];
        }
        return $skinSpecific;
    }
}