4 * Processes an entire attribute array for corrections needing multiple values.
6 * Occasionally, a certain attribute will need to be removed and popped onto
7 * another value. Instead of creating a complex return syntax for
8 * HTMLPurifier_AttrDef, we just pass the whole attribute array to a
9 * specialized object and have that do the special work. That is the
10 * family of HTMLPurifier_AttrTransform.
12 * An attribute transformation can be assigned to run before or after
13 * HTMLPurifier_AttrDef validation. See HTMLPurifier_HTMLDefinition for
17 abstract class HTMLPurifier_AttrTransform
21 * Abstract: makes changes to the attributes dependent on multiple values.
23 * @param array $attr Assoc array of attributes, usually from
24 * HTMLPurifier_Token_Tag::$attr
25 * @param HTMLPurifier_Config $config Mandatory HTMLPurifier_Config object.
26 * @param HTMLPurifier_Context $context Mandatory HTMLPurifier_Context object
27 * @return array Processed attribute array.
29 abstract public function transform($attr, $config, $context);
32 * Prepends CSS properties to the style attribute, creating the
33 * attribute if it doesn't exist.
34 * @param array &$attr Attribute array to process (passed by reference)
35 * @param string $css CSS to prepend
37 public function prependCSS(&$attr, $css)
39 $attr['style'] = isset($attr['style']) ?
$attr['style'] : '';
40 $attr['style'] = $css . $attr['style'];
44 * Retrieves and removes an attribute
45 * @param array &$attr Attribute array to process (passed by reference)
46 * @param mixed $key Key of attribute to confiscate
49 public function confiscateAttr(&$attr, $key)
51 if (!isset($attr[$key])) {