[Summary view]

   1  <?php
   2  
   3  /**

   4   * Definition that allows a set of elements, and allows no children.

   5   * @note This is a hack to reuse code from HTMLPurifier_ChildDef_Required,

   6   *       really, one shouldn't inherit from the other.  Only altered behavior

   7   *       is to overload a returned false with an array.  Thus, it will never

   8   *       return false.

   9   */
  10  class HTMLPurifier_ChildDef_Optional extends HTMLPurifier_ChildDef_Required
  11  {
  12      /**

  13       * @type bool

  14       */
  15      public $allow_empty = true;
  16  
  17      /**

  18       * @type string

  19       */
  20      public $type = 'optional';
  21  
  22      /**

  23       * @param array $children

  24       * @param HTMLPurifier_Config $config

  25       * @param HTMLPurifier_Context $context

  26       * @return array

  27       */
  28      public function validateChildren($children, $config, $context)
  29      {
  30          $result = parent::validateChildren($children, $config, $context);
  31          // we assume that $children is not modified

  32          if ($result === false) {
  33              if (empty($children)) {
  34                  return true;
  35              } elseif ($this->whitespace) {
  36                  return $children;
  37              } else {
  38                  return array();
  39              }
  40          }
  41          return $result;
  42      }
  43  }
  44  
  45  // vim: et sw=4 sts=4