function drupal_pre_render_conditional_comments

#pre_render callback to render #browsers into #prefix and #suffix.

Parameters

$elements: A render array with a '#browsers' property. The '#browsers' property can contain any or all of the following keys:

  • 'IE': If FALSE, the element is not rendered by Internet Explorer. If TRUE, the element is rendered by Internet Explorer. Can also be a string containing an expression for Internet Explorer to evaluate as part of a conditional comment. For example, this can be set to 'lt IE 7' for the element to be rendered in Internet Explorer 6, but not in Internet Explorer 7 or higher. Defaults to TRUE.
  • '!IE': If FALSE, the element is not rendered by browsers other than Internet Explorer. If TRUE, the element is rendered by those browsers. Defaults to TRUE.

Examples:

  • To render an element in all browsers, '#browsers' can be left out or set to array('IE' => TRUE, '!IE' => TRUE).
  • To render an element in Internet Explorer only, '#browsers' can be set to array('!IE' => FALSE).
  • To render an element in Internet Explorer 6 only, '#browsers' can be set to array('IE' => 'lt IE 7', '!IE' => FALSE).
  • To render an element in Internet Explorer 8 and higher and in all other browsers, '#browsers' can be set to array('IE' => 'gte IE 8').

Return value

The passed-in element with markup for conditional comments potentially added to '#prefix' and '#suffix'.

1 string reference to 'drupal_pre_render_conditional_comments'
system_element_info in modules/system/system.module
Implements hook_element_info().

File

includes/common.inc, line 5795

Code

function drupal_pre_render_conditional_comments($elements) {
    $browsers = isset($elements['#browsers']) ? $elements['#browsers'] : array();
    $browsers += array(
        'IE' => TRUE,
        '!IE' => TRUE,
    );
    // If rendering in all browsers, no need for conditional comments.
    if ($browsers['IE'] === TRUE && $browsers['!IE']) {
        return $elements;
    }
    // Determine the conditional comment expression for Internet Explorer to
    // evaluate.
    if ($browsers['IE'] === TRUE) {
        $expression = 'IE';
    }
    elseif ($browsers['IE'] === FALSE) {
        $expression = '!IE';
    }
    else {
        $expression = $browsers['IE'];
    }
    // Wrap the element's potentially existing #prefix and #suffix properties with
    // conditional comment markup. The conditional comment expression is evaluated
    // by Internet Explorer only. To control the rendering by other browsers,
    // either the "downlevel-hidden" or "downlevel-revealed" technique must be
    // used. See http://en.wikipedia.org/wiki/Conditional_comment for details.
    $elements += array(
        '#prefix' => '',
        '#suffix' => '',
    );
    if (!$browsers['!IE']) {
        // "downlevel-hidden".
        $elements['#prefix'] = "\n<!--[if {$expression}]>\n" . $elements['#prefix'];
        $elements['#suffix'] .= "<![endif]-->\n";
    }
    else {
        // "downlevel-revealed".
        $elements['#prefix'] = "\n<!--[if {$expression}]><!-->\n" . $elements['#prefix'];
        $elements['#suffix'] .= "<!--<![endif]-->\n";
    }
    return $elements;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.