< HTMLPurifier_AttrDef > Protocol Reference

Base class for all validating attribute definitions. More...

List of all members.

Public Member Functions
	validate ($string, $config, $context)
	Validates and cleans passed string according to a definition.
	parseCDATA ($string)
	Convenience method that parses a string as if it were CDATA.
	make ($string)
	Factory method for creating this class from a string.
	validate ($string, $config, $context)
	Validates and cleans passed string according to a definition.
	parseCDATA ($string)
	Convenience method that parses a string as if it were CDATA.
	make ($string)
	Factory method for creating this class from a string.
Public Attributes
	$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 Member Functions
	mungeRgb ($string)
	Removes spaces from rgb(0, 0, 0) so that shorthand CSS properties work properly.
	mungeRgb ($string)
	Removes spaces from rgb(0, 0, 0) so that shorthand CSS properties work properly.

---

Detailed Description

Base class for all validating attribute definitions.

This family of classes forms the core for not only HTML attribute validation, but also any sort of string that needs to be validated or cleaned (which means CSS properties and composite definitions are defined here too). Besides defining (through code) what precisely makes the string valid, subclasses are also responsible for cleaning the code if possible.

Definition at line 13 of file AttrDef.php.

---

Member Function Documentation

HTMLPurifier_AttrDef-p::validate	(	$	string,
		$	config,
		$	context
	)			[abstract]

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.

HTMLPurifier_AttrDef-p::parseCDATA

(

$

string

)

Convenience method that parses a string as if it were CDATA.

This method process a string in the manner specified at <http://www.w3.org/TR/html4/types.html#h-6.2> by removing leading and trailing whitespace, ignoring line feeds, and replacing carriage returns and tabs with spaces. While most useful for HTML attributes specified as CDATA, it can also be applied to most CSS values.

Note:

This method is not entirely standards compliant, as trim() removes more types of whitespace than specified in the spec. In practice, this is rarely a problem, as those extra characters usually have already been removed by HTMLPurifier_Encoder.

Warning:

This processing is inconsistent with XML's whitespace handling as specified by section 3.3.3 and referenced XHTML 1.0 section 4.7. However, note that we are NOT necessarily parsing XML, thus, this behavior may still be correct. We assume that newlines have been normalized.

Definition at line 58 of file AttrDef.php.

HTMLPurifier_AttrDef-p::make

(

$

string

)

Factory method for creating this class from a string.

Parameters:

$string

String construction info

Returns:

Created AttrDef object corresponding to $string

Definition at line 69 of file AttrDef.php.

HTMLPurifier_AttrDef-p::mungeRgb

(

$

string

)

[protected]

Removes spaces from rgb(0, 0, 0) so that shorthand CSS properties work properly.

THIS IS A HACK!

Definition at line 81 of file AttrDef.php.

HTMLPurifier_AttrDef-p::validate	(	$	string,
		$	config,
		$	context
	)			[abstract]

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.

HTMLPurifier_AttrDef-p::parseCDATA

(

$

string

)

Convenience method that parses a string as if it were CDATA.

This method process a string in the manner specified at <http://www.w3.org/TR/html4/types.html#h-6.2> by removing leading and trailing whitespace, ignoring line feeds, and replacing carriage returns and tabs with spaces. While most useful for HTML attributes specified as CDATA, it can also be applied to most CSS values.

Note:

This method is not entirely standards compliant, as trim() removes more types of whitespace than specified in the spec. In practice, this is rarely a problem, as those extra characters usually have already been removed by HTMLPurifier_Encoder.

Warning:

This processing is inconsistent with XML's whitespace handling as specified by section 3.3.3 and referenced XHTML 1.0 section 4.7. However, note that we are NOT necessarily parsing XML, thus, this behavior may still be correct. We assume that newlines have been normalized.

Definition at line 441 of file HTMLPurifier.standalone.php.

HTMLPurifier_AttrDef-p::make

(

$

string

)

Factory method for creating this class from a string.

Parameters:

$string

String construction info

Returns:

Created AttrDef object corresponding to $string

Definition at line 452 of file HTMLPurifier.standalone.php.

HTMLPurifier_AttrDef-p::mungeRgb

(

$

string

)

[protected]

Removes spaces from rgb(0, 0, 0) so that shorthand CSS properties work properly.

THIS IS A HACK!

Definition at line 464 of file HTMLPurifier.standalone.php.

---

Member Data Documentation

HTMLPurifier_AttrDef-p::$minimized = false

Tells us whether or not an HTML attribute is minimized.

Has no meaning in other contexts.

Definition at line 20 of file AttrDef.php.

HTMLPurifier_AttrDef-p::$required = false

Tells us whether or not an HTML attribute is required.

Has no meaning in other contexts

Definition at line 26 of file AttrDef.php.

---

The documentation for this protocol was generated from the following files:

• library/HTMLPurifier/AttrDef.php
• library/HTMLPurifier.standalone.php

---