class JsCollectionGrouper in Advanced CSS/JS Aggregation 8.2

Groups JavaScript assets.

Hierarchy

• class \Drupal\Core\Asset\JsCollectionGrouper implements AssetCollectionGrouperInterface
  • class \Drupal\advagg\Asset\JsCollectionGrouper implements AssetCollectionGrouperInterface

1 string reference to 'JsCollectionGrouper'

advagg.services.yml in ./advagg.services.yml

advagg.services.yml

1 service uses JsCollectionGrouper

asset.js.collection_grouper in ./advagg.services.yml

Drupal\advagg\Asset\JsCollectionGrouper

File

src/Asset/JsCollectionGrouper.php, line 12

Namespace

Drupal\advagg\Asset

class JsCollectionGrouper extends CoreJsCollectionGrouper implements AssetCollectionGrouperInterface {

  /**
   * Module handler service.
   *
   * @var \Drupal\Core\Extension\ModuleHandlerInterface
   */
  protected $moduleHandler;

  /**
   * Construct the AssetDumper instance.
   *
   * @param \Drupal\Core\Extension\ModuleHandlerInterface $module_handler
   *   The module handler.
   */
  public function __construct(ModuleHandlerInterface $module_handler) {
    $this->moduleHandler = $module_handler;
  }

  /**
   * {@inheritdoc}
   *
   * Puts multiple items into the same group if they are groupable and if they
   * are for the same browsers. Items of the 'file' type are groupable if their
   * 'preprocess' flag is TRUE. Items of the 'external' type are not groupable.
   *
   * Also ensures that the process of grouping items does not change their
   * relative order. This requirement may result in multiple groups for the same
   * type and browsers, if needed to accommodate other items in between.
   */
  public function group(array $js_assets) {
    $groups = [];

    // If a group can contain multiple items, we track the information that must
    // be the same for each item in the group, so that when we iterate the next
    // item, we can determine if it can be put into the current group, or if a
    // new group needs to be made for it.
    $current_group_keys = NULL;
    $index = -1;
    foreach ($js_assets as $item) {

      // The browsers for which the JavaScript item needs to be loaded is part
      // of the information that determines when a new group is needed, but the
      // order of keys in the array doesn't matter, and we don't want a new
      // group if all that's different is that order.
      ksort($item['browsers']);
      switch ($item['type']) {
        case 'file':

          // Group file items if their 'preprocess' flag is TRUE.
          // Help ensure maximum reuse of aggregate files by only grouping
          // together items that share the same 'group' value.
          if ($item['preprocess']) {
            $group_keys = [
              $item['group'],
              $item['browsers'],
            ];
            if (isset($item['inline'])) {
              $group_keys[] = $item['inline'];
            }
          }
          else {
            $group_keys = FALSE;
          }
          break;
        case 'external':

          // Do not group external items.
          $group_keys = FALSE;
          break;
      }

      // If the group keys don't match the most recent group we're working with,
      // then a new group must be made.
      if ($group_keys !== $current_group_keys) {
        $index++;

        // Initialize the new group with the same properties as the first item
        // being placed into it. The item's 'data' and 'weight' properties are
        // unique to the item and should not be carried over to the group.
        $groups[$index] = $item;
        unset($groups[$index]['data'], $groups[$index]['weight']);
        $groups[$index]['items'] = [];
        $current_group_keys = $group_keys ? $group_keys : NULL;
      }

      // Add the item to the current group.
      $groups[$index]['items'][] = $item;
    }

    // Run hook so other modules can modify the data.
    // Call hook_advagg_aggregate_grouping_alter().
    $type = 'js';
    $this->moduleHandler
      ->alter('advagg_aggregate_grouping', $groups, $type);
    return $groups;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
JsCollectionGrouper::$moduleHandler	protected	property	Module handler service.
JsCollectionGrouper::group	public	function	Puts multiple items into the same group if they are groupable and if they are for the same browsers. Items of the 'file' type are groupable if their 'preprocess' flag is TRUE. Items of the 'external' type are not groupable. Overrides JsCollectionGrouper::group
JsCollectionGrouper::__construct	public	function	Construct the AssetDumper instance.