Skip navigation
Help

drupal_get_css

6 common.inc drupal_get_css($css = NULL)
7 common.inc drupal_get_css($css = NULL, $skip_alter = FALSE)

Returns a themed representation of all stylesheets that should be attached to the page.

It loads the CSS in order, with 'module' first, then 'theme' afterwards. This ensures proper cascading of styles so themes can easily override module styles through CSS selectors.

Themes may replace module-defined CSS files by adding a stylesheet with the same filename. For example, themes/bartik/system-menus.css would replace modules/system/system-menus.css. This allows themes to override complete CSS files, rather than specific selectors, when necessary.

If the original CSS file is being overridden by a theme, the theme is responsible for supplying an accompanying RTL CSS file to replace the module's.

Parameters

$css: (optional) An array of CSS files. If no array is provided, the default stylesheets array is used instead.

$skip_alter: (optional) If set to TRUE, this function skips calling drupal_alter() on $css, useful when the calling function passes a $css array that has already been altered.

Return value

A string of XHTML CSS tags.

See also

drupal_add_css()

13 calls to drupal_get_css()

File

drupal/includes/common.inc, line 2919
Common functions that many Drupal modules will need to reference.

Code

function drupal_get_css($css = NULL, $skip_alter = FALSE) {
  if (!isset($css)) {
    $css = drupal_add_css();
  }

  // Allow modules and themes to alter the CSS items.
  if (!$skip_alter) {
    drupal_alter('css', $css);
  }

  // Sort CSS items, so that they appear in the correct order.
  uasort($css, 'drupal_sort_css_js');

  // Remove the overridden CSS files. Later CSS files override former ones.
  $previous_item = array();
  foreach ($css as $key => $item) {
    if ($item['type'] == 'file') {
      // If defined, force a unique basename for this file.
      $basename = isset($item['basename']) ? $item['basename'] : basename($item['data']);
      if (isset($previous_item[$basename])) {
        // Remove the previous item that shared the same base name.
        unset($css[$previous_item[$basename]]);
      }
      $previous_item[$basename] = $key;
    }
  }

  // Render the HTML needed to load the CSS.
  $styles = array(
    '#type' => 'styles', 
    '#items' => $css,
  );

  // Provide the page with information about the individual CSS files used,
  // information not otherwise available when CSS aggregation is enabled.
  $setting['ajaxPageState']['css'] = array_fill_keys(array_keys($css), 1);
  $styles['#attached']['js'][] = array(
    'type' => 'setting',
    'data' => $setting,
  );

  return drupal_render($styles);
}