class StaticLayout

Plugin annotation


@Plugin(
 id = "static_layout",
 derivative = "Drupal\layout\Plugin\Derivative\Layout"
)

Hierarchy

Expanded class hierarchy of StaticLayout

File

drupal/core/modules/layout/lib/Drupal/layout/Plugin/layout/layout/StaticLayout.php, line 21
Definition of Drupal\layout\Plugin\layout\layout\StaticLayout.

Namespace

Drupal\layout\Plugin\layout\layout
View source
class StaticLayout extends PluginBase implements LayoutInterface {

  /**
   * Overrides Drupal\Component\Plugin\PluginBase::__construct().
   */
  public function __construct(array $configuration, $plugin_id, DiscoveryInterface $discovery) {

    // Get definition by discovering the declarative information.
    $definition = $discovery
      ->getDefinition($plugin_id);
    foreach ($definition['regions'] as $region => $title) {
      if (!isset($configuration['regions'][$region])) {
        $configuration['regions'][$region] = array();
      }
    }
    parent::__construct($configuration, $plugin_id, $discovery);
  }

  /**
   * Implements Drupal\layout\Plugin\LayoutInterface::getRegions().
   */
  public function getRegions() {
    $definition = $this
      ->getDefinition();
    return $definition['regions'];
  }

  /**
   * Returns the list of CSS files associated with this layout.
   */
  public function getStylesheetFiles() {
    $definition = $this
      ->getDefinition();
    return isset($definition['stylesheets']) ? $definition['stylesheets'] : array();
  }

  /**
   * Returns the list of administrative CSS files associated with this layout.
   */
  public function getAdminStylesheetFiles() {
    $definition = $this
      ->getDefinition();

    // Fall back on regular CSS for the admin page if admin CSS not provided.
    return isset($definition['admin stylesheets']) ? $definition['admin stylesheets'] : $this
      ->getStylesheetFiles();
  }

  /**
   * Returns the list of JS files associated with this layout.
   */
  public function getScriptFiles() {
    $definition = $this
      ->getDefinition();
    return isset($definition['scripts']) ? $definition['scripts'] : array();
  }

  /**
   * Returns the list of administrative JS files associated with this layout.
   */
  public function getAdminScriptFiles() {
    $definition = $this
      ->getDefinition();
    return isset($definition['admin scripts']) ? $definition['admin scripts'] : $this
      ->getScriptFiles();
  }

  /**
   * Implements Drupal\layout\Plugin\LayoutInterface::renderLayout().
   */
  public function renderLayout($admin = FALSE, $regions = array()) {
    $definition = $this
      ->getDefinition();

    // Assemble a render array with the regions and attached CSS/JS.
    $build = array(
      '#theme' => $definition['theme'],
      '#content' => array(),
    );

    // Render all regions needed for this layout.
    foreach ($this
      ->getRegions() as $region => $info) {

      // Initialize regions which were not provided as empty.
      $build['#content'][$region] = empty($regions[$region]) ? '' : $regions[$region];
    }

    // Fill in attached CSS and JS files based on metadata.
    if (!$admin) {
      $build['#attached'] = array(
        'css' => $this
          ->getStylesheetFiles(),
        'js' => $this
          ->getScriptFiles(),
      );
    }
    else {
      $build['#attached'] = array(
        'css' => $this
          ->getAdminStylesheetFiles(),
        'js' => $this
          ->getAdminScriptFiles(),
      );
    }

    // Include the path of the definition in all CSS and JS files.
    foreach (array(
      'css',
      'js',
    ) as $type) {
      foreach ($build['#attached'][$type] as &$filename) {
        $filename = $definition['path'] . '/' . $filename;
      }
    }
    return drupal_render($build);
  }

}

Members

Namesort descending Modifiers Type Description Overrides
PluginBase::$configuration protected property Configuration information passed into the plugin. 1
PluginBase::$discovery protected property The discovery object.
PluginBase::$plugin_id protected property The plugin_id.
PluginBase::getDefinition public function Implements Drupal\Component\Plugin\PluginInterface::getDefinition(). Overrides PluginInspectionInterface::getDefinition
PluginBase::getPluginId public function Implements Drupal\Component\Plugin\PluginInterface::getPluginId(). Overrides PluginInspectionInterface::getPluginId
StaticLayout::getAdminScriptFiles public function Returns the list of administrative JS files associated with this layout.
StaticLayout::getAdminStylesheetFiles public function Returns the list of administrative CSS files associated with this layout.
StaticLayout::getRegions public function Implements Drupal\layout\Plugin\LayoutInterface::getRegions(). Overrides LayoutInterface::getRegions
StaticLayout::getScriptFiles public function Returns the list of JS files associated with this layout.
StaticLayout::getStylesheetFiles public function Returns the list of CSS files associated with this layout.
StaticLayout::renderLayout public function Implements Drupal\layout\Plugin\LayoutInterface::renderLayout(). Overrides LayoutInterface::renderLayout
StaticLayout::__construct public function Overrides Drupal\Component\Plugin\PluginBase::__construct(). Overrides PluginBase::__construct