. * * @license http://opensource.org/licenses/lgpl-license.php GNU Lesser General Public License * @package CSSTidy * @author Florian Schmitz (floele at gmail dot com) 2005-2007 * @author Brett Zamir (brettz9 at yahoo dot com) 2007 * @author Cedric Morin (cedric at yterium dot com) 2010-2012 */ /** * CSS Printing class * * This class prints CSS data generated by CSSTidy. * * @package CSSTidy * @author Florian Schmitz (floele at gmail dot com) 2005-2006 * @version 1.1.0 */ class CSSTidy_print { /** * CSSTidy instance. * * @since 1.0.0 * @var CSSTidy */ public $parser; /** * The parsed CSS. * * @since 1.0.0 * @var array */ public $css = array(); /** * The output templates. * * @since 1.0.0 * @var array */ public $template = array(); /** * The raw parsed CSS. * * @since 1.0.0 * @var array */ public $tokens = array(); /** * The CSS charset. * * @since 1.0.0 * @var string */ public $charset = ''; /** * All @import URLs. * * @since 1.0.0 * @var array */ public $import = array(); /** * The namespace. * * @since 1.0.0 * @var string */ public $namespace = ''; /** * Saves the input CSS string. * * @since 1.0.0 * @var string */ public $input_css = ''; /** * Saves the formatted CSS string. * * @since 1.0.0 * @var string */ public $output_css = ''; /** * Saves the formatted CSS string (plain text). * * @since 1.0.0 * @var string */ public $output_css_plain = ''; /** * Constructor. * * @since 1.0 * * @param CSSTidy $css Instance of the CSSTidy class. */ public function __construct( $css ) { $this->parser = $css; $this->css = &$css->css; $this->template = &$css->template; $this->tokens = &$css->tokens; $this->charset = &$css->charset; $this->import = &$css->import; $this->namespace = &$css->namespace; } /** * Resets output_css and output_css_plain (new css code). * * @since 1.0 */ public function _reset() { $this->output_css = ''; $this->output_css_plain = ''; } /** * Returns the CSS code as plain text. * * @since 1.0 * * @param string $default_media Optional. Default @media to add to selectors without any @media. * @return string Plain CSS. */ public function plain( $default_media = '' ) { $this->_print( true, $default_media ); return $this->output_css_plain; } /** * Returns the formatted CSS code. * * @since 1.0 * * @param string $default_media Optional. Default @media to add to selectors without any @media. * @return string Formatted CSS. */ public function formatted( $default_media = '' ) { $this->_print( false, $default_media ); return $this->output_css; } /** * Returns the formatted CSS code to make a complete webpage. * * @since 1.4 * * @param string $doctype Optional. Shorthand for the document type. * @param bool $externalcss Optional. Indicates whether styles to be attached internally or as an external stylesheet. * @param string $title Optional. Title to be added in the head of the document. * @param string $lang Optional. Two-letter language code to be added to the output. * @return string Formatted CSS for a full page. */ public function formatted_page( $doctype = 'html5', $externalcss = true, $title = '', $lang = 'en' ) { switch ( $doctype ) { case 'html5': $doctype_output = ''; break; case 'xhtml1.0strict': $doctype_output = ''; break; case 'xhtml1.1': default: $doctype_output = ''; break; } $output = ''; $this->output_css_plain = &$output; $output .= $doctype_output . "\n" . '' : ' lang="' . $lang . '">'; $output .= "\n
\n\t";
$output .= $this->formatted();
$output .= '
' . "\n" . '';
return $this->output_css_plain;
}
/**
* Returns the formatted CSS Code and saves it into $this->output_css and $this->output_css_plain.
*
* @since 2.0
*
* @param bool $plain Optional. Plain text or not.
* @param string $default_media Optional. Default @media to add to selectors without any @media.
*/
protected function _print( $plain = false, $default_media = '' ) {
if ( $this->output_css && $this->output_css_plain ) {
return;
}
$output = '';
if ( ! $this->parser->get_cfg( 'preserve_css' ) ) {
$this->_convert_raw_css( $default_media );
}
$template = &$this->template;
if ( $plain ) {
$template = array_map( 'strip_tags', $template );
}
if ( $this->parser->get_cfg( 'timestamp' ) ) {
array_unshift( $this->tokens, array( COMMENT, ' CSSTidy ' . $this->parser->version . ': ' . date( 'r' ) . ' ' ) );
}
if ( ! empty( $this->charset ) ) {
$output .= $template[0] . '@charset ' . $template[5] . $this->charset . $template[6] . $template[13];
}
if ( ! empty( $this->import ) ) {
for ( $i = 0, $size = count( $this->import ); $i < $size; $i++ ) {
$import_components = explode( ' ', $this->import[ $i ] );
if ( 'url(' === substr( $import_components[0], 0, 4 ) && ')' === substr( $import_components[0], -1, 1 ) ) {
$import_components[0] = '\'' . trim( substr( $import_components[0], 4, -1 ), "'\"" ) . '\'';
$this->import[ $i ] = implode( ' ', $import_components );
$this->parser->log( 'Optimised @import : Removed "url("', 'Information' );
}
$output .= $template[0] . '@import ' . $template[5] . $this->import[ $i ] . $template[6] . $template[13];
}
}
if ( ! empty( $this->namespace ) ) {
if ( false !== ( $p = strpos( $this->namespace, 'url(' ) ) && ')' === substr( $this->namespace, -1, 1 ) ) {
$this->namespace = substr_replace( $this->namespace, '"', $p, 4 );
$this->namespace = substr( $this->namespace, 0, -1 ) . '"';
$this->parser->log( 'Optimised @namespace : Removed "url("', 'Information' );
}
$output .= $template[0] . '@namespace ' . $template[5] . $this->namespace . $template[6] . $template[13];
}
$in_at_out = '';
$out = &$output;
foreach ( $this->tokens as $key => $token ) {
switch ( $token[0] ) {
case AT_START:
if ( $this->parser->get_cfg( 'preserve_css' ) ) {
$token[1] = str_replace( ',', ",\n", $token[1] );
}
$out .= $template[0] . $this->_htmlsp( $token[1], $plain ) . $template[1];
$out = &$in_at_out;
break;
case SEL_START:
if ( $this->parser->get_cfg( 'lowercase_s' ) ) {
$token[1] = strtolower( $token[1] );
}
if ( $this->parser->get_cfg( 'preserve_css' ) ) {
$token[1] = str_replace( ',', ",\n", $token[1] );
}
$out .= ( '@' !== $token[1][0] ) ? $template[2] . $this->_htmlsp( $token[1], $plain ) : $template[0] . $this->_htmlsp( $token[1], $plain );
$out .= $template[3];
break;
case PROPERTY:
if ( 2 === $this->parser->get_cfg( 'case_properties' ) ) {
$token[1] = strtoupper( $token[1] );
} elseif ( 1 === $this->parser->get_cfg( 'case_properties' ) ) {
$token[1] = strtolower( $token[1] );
}
$out .= $template[4] . $this->_htmlsp( $token[1], $plain ) . ':' . $template[5];
break;
case VALUE:
$out .= $this->_htmlsp( $token[1], $plain );
if ( SEL_END === $this->_seeknocomment( $key, 1 ) && $this->parser->get_cfg( 'remove_last_;' ) ) {
$out .= str_replace( ';', '', $template[6] );
} else {
$out .= $template[6];
}
if ( $this->parser->get_cfg( 'preserve_css' ) ) {
$out .= ( COMMENT === $this->tokens[ $key + 1 ][0] ) ? ' ' : "\n";
}
break;
case SEL_END:
$out .= $template[7];
if ( AT_END !== $this->_seeknocomment( $key, 1 ) ) {
$out .= $template[8];
}
break;
case AT_END:
$out = &$output;
$in_at_out = str_replace( "\n\n", "\r\n", $in_at_out); // don't fill empty lines
$in_at_out = str_replace( "\n", "\n" . $template[10], $in_at_out );
$in_at_out = str_replace( "\r\n", "\n\n", $in_at_out );
$out .= $template[10] . $in_at_out . $template[9];
$in_at_out = '';
break;
case COMMENT:
$out .= $template[11] . '/*' . $this->_htmlsp( $token[1], $plain ) . '*/' . $template[12];
break;
}
}
if ( ! $this->parser->get_cfg( 'preserve_css' ) ) {
$output = str_replace( ' !important', '!important', $output );
}
$output = trim( $output );
if ( ! $plain ) {
$this->output_css = $output;
$this->_print( true );
} else {
// If using spaces in the template, don't want these to appear in the plain output.
$this->output_css_plain = str_replace( ' ', '', $output );
}
}
/**
* Gets the next token type which is $move away from $key, excluding comments.
*
* @since 1.0
*
* @param int $key Current position.
* @param int $move Move this far.
* @return mixed A token type.
*/
protected function _seeknocomment( $key, $move ) {
$go = ( $move > 0 ) ? 1 : -1;
for ( $i = $key + 1; abs( $key - $i ) - 1 < abs( $move ); $i += $go ) {
if ( ! isset( $this->tokens[ $i ] ) ) {
return;
}
if ( COMMENT === $this->tokens[ $i ][0] ) {
$move += 1;
continue;
}
return $this->tokens[ $i ][0];
}
}
/**
* Converts $this->css array to a raw array ($this->tokens).
*
* @since 1.0.0
*
* @param string $default_media Optional. Default @media to add to selectors without any @media.
*/
protected function _convert_raw_css( $default_media = '' ) {
$this->tokens = array();
$sort_selectors = $this->parser->get_cfg( 'sort_selectors' );
$sort_properties = $this->parser->get_cfg( 'sort_properties' );
foreach ( $this->css as $medium => $val ) {
if ( $sort_selectors ) {
ksort( $val );
}
if ( intval( $medium ) < DEFAULT_AT ) {
// un medium vide (contenant @font-face ou autre @) ne produit aucun conteneur
if ( strlen( trim( $medium ) ) ) {
$this->parser->_add_token( AT_START, $medium, true );
}
} elseif ( $default_media ) {
$this->parser->_add_token( AT_START, $default_media, true );
}
foreach ( $val as $selector => $vali ) {
if ( $sort_properties ) {
ksort( $vali );
}
$this->parser->_add_token( SEL_START, $selector, true );
$invalid = array(
'*' => array(), // IE7 hacks first
'_' => array(), // IE6 hacks
'/' => array(), // IE6 hacks
'-' => array(), // IE6 hacks
);
foreach ( $vali as $property => $valj ) {
if ( 0 !== strncmp( $property, '//', 2 ) ) {
$matches = array();
if ( $sort_properties && preg_match( '/^(\*|_|\/|-)(?!(ms|moz|o\b|xv|atsc|wap|khtml|webkit|ah|hp|ro|rim|tc)-)/', $property, $matches ) ) {
$invalid[ $matches[1] ][ $property ] = $valj;
} else {
$this->parser->_add_token( PROPERTY, $property, true );
$this->parser->_add_token( VALUE, $valj, true );
}
}
}
foreach ( $invalid as $prefix => $props ) {
foreach ( $props as $property => $valj ) {
$this->parser->_add_token( PROPERTY, $property, true );
$this->parser->_add_token( VALUE, $valj, true );
}
}
$this->parser->_add_token( SEL_END, $selector, true );
}
if ( intval( $medium ) < DEFAULT_AT ) {
// un medium vide (contenant @font-face ou autre @) ne produit aucun conteneur
if ( strlen( trim( $medium ) ) ) {
$this->parser->_add_token( AT_END, $medium, true );
}
} elseif ( $default_media ) {
$this->parser->_add_token( AT_END, $default_media, true );
}
}
}
/**
* Same as htmlspecialchars, only that chars are not replaced if $plain is true. This makes print_code() cleaner.
*
* @since 1.0
*
* @see CSSTidy_print::_print()
*
* @param string $string String.
* @param bool $plain Print plain?
* @return string [return value]
*/
protected function _htmlsp( $string, $plain ) {
if ( ! $plain ) {
return htmlspecialchars( $string, ENT_QUOTES, 'utf-8' );
}
return $string;
}
/**
* Get compression ratio.
*
* @since 1.2
*
* @return double Compression ratio.
*/
public function get_ratio() {
if ( ! $this->output_css_plain ) {
$this->formatted();
}
return round( ( strlen( $this->input_css ) - strlen( $this->output_css_plain ) ) / strlen( $this->input_css ), 3 ) * 100;
}
/**
* Get difference between the old and new code in bytes and prints the code if necessary.
*
* @since 1.1
*
* @return string Size difference.
*/
public function get_diff() {
if ( ! $this->output_css_plain ) {
$this->formatted();
}
$diff = strlen( $this->output_css_plain ) - strlen( $this->input_css );
if ( $diff > 0 ) {
return '+' . $diff;
} elseif ( 0 === $diff ) {
return '+-' . $diff;
}
return $diff;
}
/**
* Get the size of either input or output CSS in kilobytes (KB).
*
* @since 1.0
*
* @param string $loc Optional. Location of the CSS.
* @return int Size of the CSS.
*/
public function size( $loc = 'output' ) {
if ( 'output' === $loc && ! $this->output_css ) {
$this->formatted();
}
if ( 'input' === $loc ) {
return strlen( $this->input_css ) / 1000;
} else {
return strlen( $this->output_css_plain ) / 1000;
}
}
} // class CSSTidy_print