friendica/vendor/ezyang/htmlpurifier/library/HTMLPurifier/AttrTransform.php

61 lines
1.9 KiB
PHP
Raw Normal View History

2010-09-09 03:14:17 +00:00
<?php
/**
* Processes an entire attribute array for corrections needing multiple values.
*
* Occasionally, a certain attribute will need to be removed and popped onto
* another value. Instead of creating a complex return syntax for
* HTMLPurifier_AttrDef, we just pass the whole attribute array to a
* specialized object and have that do the special work. That is the
* family of HTMLPurifier_AttrTransform.
*
* An attribute transformation can be assigned to run before or after
* HTMLPurifier_AttrDef validation. See HTMLPurifier_HTMLDefinition for
* more details.
*/
abstract class HTMLPurifier_AttrTransform
{
/**
* Abstract: makes changes to the attributes dependent on multiple values.
*
2016-02-09 10:06:17 +00:00
* @param array $attr Assoc array of attributes, usually from
2010-09-09 03:14:17 +00:00
* HTMLPurifier_Token_Tag::$attr
2016-02-09 10:06:17 +00:00
* @param HTMLPurifier_Config $config Mandatory HTMLPurifier_Config object.
* @param HTMLPurifier_Context $context Mandatory HTMLPurifier_Context object
* @return array Processed attribute array.
2010-09-09 03:14:17 +00:00
*/
abstract public function transform($attr, $config, $context);
/**
* Prepends CSS properties to the style attribute, creating the
* attribute if it doesn't exist.
2016-02-09 10:06:17 +00:00
* @param array &$attr Attribute array to process (passed by reference)
* @param string $css CSS to prepend
2010-09-09 03:14:17 +00:00
*/
2016-02-09 10:06:17 +00:00
public function prependCSS(&$attr, $css)
{
2010-09-09 03:14:17 +00:00
$attr['style'] = isset($attr['style']) ? $attr['style'] : '';
$attr['style'] = $css . $attr['style'];
}
/**
* Retrieves and removes an attribute
2016-02-09 10:06:17 +00:00
* @param array &$attr Attribute array to process (passed by reference)
* @param mixed $key Key of attribute to confiscate
* @return mixed
2010-09-09 03:14:17 +00:00
*/
2016-02-09 10:06:17 +00:00
public function confiscateAttr(&$attr, $key)
{
if (!isset($attr[$key])) {
return null;
}
2010-09-09 03:14:17 +00:00
$value = $attr[$key];
unset($attr[$key]);
return $value;
}
}
// vim: et sw=4 sts=4