protected function LibraryDiscoveryParser::applyLibrariesOverride

protected LibraryDiscoveryParser::applyLibrariesOverride($libraries, $extension)

Apply libraries overrides specified for the current active theme.

Parameters

array $libraries: The libraries definitions.

string $extension: The extension in which these libraries are defined.

Return value

array The modified libraries definitions.

File

core/lib/Drupal/Core/Asset/LibraryDiscoveryParser.php, line 333

Class

LibraryDiscoveryParser

Parses library files to get extension data.

Namespace

Drupal\Core\Asset

Code

protected function applyLibrariesOverride($libraries, $extension) {
  $active_theme = $this->themeManager->getActiveTheme();
  // ActiveTheme::getLibrariesOverride() returns libraries-overrides for the
  // current theme as well as all its base themes.
  $all_libraries_overrides = $active_theme->getLibrariesOverride();
  foreach ($all_libraries_overrides as $theme_path => $libraries_overrides) {
    foreach ($libraries as $library_name => $library) {
      // Process libraries overrides.
      if (isset($libraries_overrides["$extension/$library_name"])) {
        // Active theme defines an override for this library.
        $override_definition = $libraries_overrides["$extension/$library_name"];
        if (is_string($override_definition) || $override_definition === FALSE) {
          // A string or boolean definition implies an override (or removal)
          // for the whole library. Use the override key to specify that this
          // library will be overridden when it is called.
          // @see \Drupal\Core\Asset\LibraryDiscovery::getLibraryByName()
          if ($override_definition) {
            $libraries[$library_name]['override'] = $override_definition;
          }
          else {
            $libraries[$library_name]['override'] = FALSE;
          }
        }
        elseif (is_array($override_definition)) {
          // An array definition implies an override for an asset within this
          // library.
          foreach ($override_definition as $sub_key => $value) {
            // Throw an exception if the asset is not properly specified.
            if (!is_array($value)) {
              throw new InvalidLibrariesOverrideSpecificationException(sprintf('Library asset %s is not correctly specified. It should be in the form "extension/library_name/sub_key/path/to/asset.js".', "$extension/$library_name/$sub_key"));
            }
            if ($sub_key === 'drupalSettings') {
              // drupalSettings may not be overridden.
              throw new InvalidLibrariesOverrideSpecificationException(sprintf('drupalSettings may not be overridden in libraries-override. Trying to override %s. Use hook_library_info_alter() instead.', "$extension/$library_name/$sub_key"));
            }
            elseif ($sub_key === 'css') {
              // SMACSS category should be incorporated into the asset name.
              foreach ($value as $category => $overrides) {
                $this->setOverrideValue($libraries[$library_name], [$sub_key, $category], $overrides, $theme_path);
              }
            }
            else {
              $this->setOverrideValue($libraries[$library_name], [$sub_key], $value, $theme_path);
            }
          }
        }
      }
    }
  }

  return $libraries;
}