Source for file CSS.php

Documentation is available at CSS.php

  1. <?php
  2.  
  3. /**
  4.  * Validates the HTML attribute style, otherwise known as CSS.
  5.  * @note We don't implement the whole CSS specification, so it might be
  6.  *        difficult to reuse this component in the context of validating
  7.  *        actual stylesheet declarations.
  8.  * @note If we were really serious about validating the CSS, we would
  9.  *        tokenize the styles and then parse the tokens. Obviously, we
  10.  *        are not doing that. Doing that could seriously harm performance,
  11.  *        but would make these components a lot more viable for a CSS
  12.  *        filtering solution.
  13.  */
  14. class HTMLPurifier_AttrDef_CSS extends HTMLPurifier_AttrDef
  15. {
  16.     
  17.     public function validate($css, $config, $context) {
  18.         
  19.         $css = $this->parseCDATA($css);
  20.         
  21.         $definition = $config->getCSSDefinition();
  22.         
  23.         // we're going to break the spec and explode by semicolons.
  24.         // This is because semicolon rarely appears in escaped form
  25.         // Doing this is generally flaky but fast
  26.         // IT MIGHT APPEAR IN URIs, see HTMLPurifier_AttrDef_CSSURI
  27.         // for details
  28.         
  29.         $declarations = explode(';', $css);
  30.         $propvalues = array();
  31.         
  32.         /**
  33.          * Name of the current CSS property being validated.
  34.          */
  35.         $property = false;
  36.         $context->register('CurrentCSSProperty', $property);
  37.         
  38.         foreach ($declarations as $declaration) {
  39.             if (!$declaration) continue;
  40.             if (!strpos($declaration, ':')) continue;
  41.             list($property, $value) = explode(':', $declaration, 2);
  42.             $property = trim($property);
  43.             $value    = trim($value);
  44.             $ok = false;
  45.             do {
  46.                 if (isset($definition->info[$property])) {
  47.                     $ok = true;
  48.                     break;
  49.                 }
  50.                 if (ctype_lower($property)) break;
  51.                 $property = strtolower($property);
  52.                 if (isset($definition->info[$property])) {
  53.                     $ok = true;
  54.                     break;
  55.                 }
  56.             } while(0);
  57.             if (!$ok) continue;
  58.             // inefficient call, since the validator will do this again
  59.             if (strtolower(trim($value)) !== 'inherit') {
  60.                 // inherit works for everything (but only on the base property)
  61.                 $result = $definition->info[$property]->validate(
  62.                     $value, $config, $context );
  63.             } else {
  64.                 $result = 'inherit';
  65.             }
  66.             if ($result === false) continue;
  67.             $propvalues[$property] = $result;
  68.         }
  69.         
  70.         $context->destroy('CurrentCSSProperty');
  71.         
  72.         // procedure does not write the new CSS simultaneously, so it's
  73.         // slightly inefficient, but it's the only way of getting rid of
  74.         // duplicates. Perhaps config to optimize it, but not now.
  75.         
  76.         $new_declarations = '';
  77.         foreach ($propvalues as $prop => $value) {
  78.             $new_declarations .= "$prop:$value;";
  79.         }
  80.         
  81.         return $new_declarations ? $new_declarations : false;
  82.         
  83.     }
  84.     
  85. }

Documentation generated on Thu, 19 Jun 2008 18:48:58 -0400 by phpDocumentor 1.4.2