HTMLPurifier_AttrDef_Enum Class Reference

Validates a keyword against a list of valid values. More...

Inheritance diagram for HTMLPurifier_AttrDef_Enum:

Collaboration diagram for HTMLPurifier_AttrDef_Enum:

Public Member Functions
	__construct ($valid_values=array(), $case_sensitive=false)
	validate ($string, $config, $context)
	Validates and cleans passed string according to a definition.
	make ($string)
Public Member Functions inherited from HTMLPurifier_AttrDef
	parseCDATA ($string)
	Convenience method that parses a string as if it were CDATA.

Data Fields
	$valid_values = array()
	Lookup table of valid values.
Data Fields inherited from HTMLPurifier_AttrDef
	$minimized = false
	Tells us whether or not an HTML attribute is minimized.
	$required = false
	Tells us whether or not an HTML attribute is required.

Protected Attributes
	$case_sensitive = false
	Bool indicating whether or not enumeration is case sensitive.

Additional Inherited Members
Protected Member Functions inherited from HTMLPurifier_AttrDef
	mungeRgb ($string)
	Removes spaces from rgb(0, 0, 0) so that shorthand CSS properties work properly.

Detailed Description

Validates a keyword against a list of valid values.

Warning

The case-insensitive compare of this function uses PHP's built-in strtolower and ctype_lower functions, which may cause problems with international comparisons

Definition at line 10 of file Enum.php.

Constructor & Destructor Documentation

HTMLPurifier_AttrDef_Enum::__construct	(		$valid_values = array(),
			$case_sensitive = false
	)

Parameters

$valid_values	List of valid values
$case_sensitive	Bool indicating whether or not case sensitive

Definition at line 29 of file Enum.php.

References $case_sensitive, and $valid_values.

      {
        $this->valid_values = array_flip($valid_values);
        $this->case_sensitive = $case_sensitive;
    }

Member Function Documentation

HTMLPurifier_AttrDef_Enum::make

(

$string

)

Parameters

$string

In form of comma-delimited list of case-insensitive valid values. Example: "foo,bar,baz". Prepend "s:" to make case sensitive

Reimplemented from HTMLPurifier_AttrDef.

Definition at line 52 of file Enum.php.

                                  {
        if (strlen($string) > 2 && $string[0] == 's' && $string[1] == ':') {
            $string = substr($string, 2);
            $sensitive = true;
        } else {
            $sensitive = false;
        }
        $values = explode(',', $string);
        return new HTMLPurifier_AttrDef_Enum($values, $sensitive);
    }

HTMLPurifier_AttrDef_Enum::validate	(		$string,
			$config,
			$context
	)

Validates and cleans passed string according to a definition.

Parameters

$string	String to be validated and cleaned.
$config	Mandatory HTMLPurifier_Config object.
$context	Mandatory HTMLPurifier_AttrContext object.

Reimplemented from HTMLPurifier_AttrDef.

Reimplemented in HTMLPurifier_AttrDef_HTML_FrameTarget.

Definition at line 36 of file Enum.php.

                                                         {
        $string = trim($string);
        if (!$this->case_sensitive) {
            // we may want to do full case-insensitive libraries
            $string = ctype_lower($string) ? $string : strtolower($string);
        }
        $result = isset($this->valid_values[$string]);

        return $result ? $string : false;
    }

Field Documentation

HTMLPurifier_AttrDef_Enum::$case_sensitive = false

protected

Bool indicating whether or not enumeration is case sensitive.

Note

In general this is always case insensitive.

Definition at line 23 of file Enum.php.

Referenced by __construct().

HTMLPurifier_AttrDef_Enum::$valid_values = array()

Lookup table of valid values.

Todo:

Make protected

Definition at line 17 of file Enum.php.

Referenced by __construct().

---

The documentation for this class was generated from the following file:

• Services/Html/HtmlPurifier/library/HTMLPurifier/AttrDef/Enum.php