. * * @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{$title}"; if ( $externalcss ) { $output .= "\n\t"; } else { $output .= "\n" . ''; } $output .= "\n\n"; $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