remove autoload section in composer.json

[github/wallabag/wallabag.git] / inc / 3rdparty / htmlpurifier / HTMLPurifier / ElementDef.php

<?php\r
\r
/**\r
 * Structure that stores an HTML element definition. Used by\r
 * HTMLPurifier_HTMLDefinition and HTMLPurifier_HTMLModule.\r
 * @note This class is inspected by HTMLPurifier_Printer_HTMLDefinition.\r
 *       Please update that class too.\r
 * @warning If you add new properties to this class, you MUST update\r
 *          the mergeIn() method.\r
 */\r
class HTMLPurifier_ElementDef\r
{\r
    /**\r
     * Does the definition work by itself, or is it created solely\r
     * for the purpose of merging into another definition?\r
     * @type bool\r
     */\r
    public $standalone = true;\r
\r
    /**\r
     * Associative array of attribute name to HTMLPurifier_AttrDef.\r
     * @type array\r
     * @note Before being processed by HTMLPurifier_AttrCollections\r
     *       when modules are finalized during\r
     *       HTMLPurifier_HTMLDefinition->setup(), this array may also\r
     *       contain an array at index 0 that indicates which attribute\r
     *       collections to load into the full array. It may also\r
     *       contain string indentifiers in lieu of HTMLPurifier_AttrDef,\r
     *       see HTMLPurifier_AttrTypes on how they are expanded during\r
     *       HTMLPurifier_HTMLDefinition->setup() processing.\r
     */\r
    public $attr = array();\r
\r
    // XXX: Design note: currently, it's not possible to override\r
    // previously defined AttrTransforms without messing around with\r
    // the final generated config. This is by design; a previous version\r
    // used an associated list of attr_transform, but it was extremely\r
    // easy to accidentally override other attribute transforms by\r
    // forgetting to specify an index (and just using 0.)  While we\r
    // could check this by checking the index number and complaining,\r
    // there is a second problem which is that it is not at all easy to\r
    // tell when something is getting overridden. Combine this with a\r
    // codebase where this isn't really being used, and it's perfect for\r
    // nuking.\r
\r
    /**\r
     * List of tags HTMLPurifier_AttrTransform to be done before validation.\r
     * @type array\r
     */\r
    public $attr_transform_pre = array();\r
\r
    /**\r
     * List of tags HTMLPurifier_AttrTransform to be done after validation.\r
     * @type array\r
     */\r
    public $attr_transform_post = array();\r
\r
    /**\r
     * HTMLPurifier_ChildDef of this tag.\r
     * @type HTMLPurifier_ChildDef\r
     */\r
    public $child;\r
\r
    /**\r
     * Abstract string representation of internal ChildDef rules.\r
     * @see HTMLPurifier_ContentSets for how this is parsed and then transformed\r
     * into an HTMLPurifier_ChildDef.\r
     * @warning This is a temporary variable that is not available after\r
     *      being processed by HTMLDefinition\r
     * @type string\r
     */\r
    public $content_model;\r
\r
    /**\r
     * Value of $child->type, used to determine which ChildDef to use,\r
     * used in combination with $content_model.\r
     * @warning This must be lowercase\r
     * @warning This is a temporary variable that is not available after\r
     *      being processed by HTMLDefinition\r
     * @type string\r
     */\r
    public $content_model_type;\r
\r
    /**\r
     * Does the element have a content model (#PCDATA | Inline)*? This\r
     * is important for chameleon ins and del processing in\r
     * HTMLPurifier_ChildDef_Chameleon. Dynamically set: modules don't\r
     * have to worry about this one.\r
     * @type bool\r
     */\r
    public $descendants_are_inline = false;\r
\r
    /**\r
     * List of the names of required attributes this element has.\r
     * Dynamically populated by HTMLPurifier_HTMLDefinition::getElement()\r
     * @type array\r
     */\r
    public $required_attr = array();\r
\r
    /**\r
     * Lookup table of tags excluded from all descendants of this tag.\r
     * @type array\r
     * @note SGML permits exclusions for all descendants, but this is\r
     *       not possible with DTDs or XML Schemas. W3C has elected to\r
     *       use complicated compositions of content_models to simulate\r
     *       exclusion for children, but we go the simpler, SGML-style\r
     *       route of flat-out exclusions, which correctly apply to\r
     *       all descendants and not just children. Note that the XHTML\r
     *       Modularization Abstract Modules are blithely unaware of such\r
     *       distinctions.\r
     */\r
    public $excludes = array();\r
\r
    /**\r
     * This tag is explicitly auto-closed by the following tags.\r
     * @type array\r
     */\r
    public $autoclose = array();\r
\r
    /**\r
     * If a foreign element is found in this element, test if it is\r
     * allowed by this sub-element; if it is, instead of closing the\r
     * current element, place it inside this element.\r
     * @type string\r
     */\r
    public $wrap;\r
\r
    /**\r
     * Whether or not this is a formatting element affected by the\r
     * "Active Formatting Elements" algorithm.\r
     * @type bool\r
     */\r
    public $formatting;\r
\r
    /**\r
     * Low-level factory constructor for creating new standalone element defs\r
     */\r
    public static function create($content_model, $content_model_type, $attr)\r
    {\r
        $def = new HTMLPurifier_ElementDef();\r
        $def->content_model = $content_model;\r
        $def->content_model_type = $content_model_type;\r
        $def->attr = $attr;\r
        return $def;\r
    }\r
\r
    /**\r
     * Merges the values of another element definition into this one.\r
     * Values from the new element def take precedence if a value is\r
     * not mergeable.\r
     * @param HTMLPurifier_ElementDef $def\r
     */\r
    public function mergeIn($def)\r
    {\r
        // later keys takes precedence\r
        foreach ($def->attr as $k => $v) {\r
            if ($k === 0) {\r
                // merge in the includes\r
                // sorry, no way to override an include\r
                foreach ($v as $v2) {\r
                    $this->attr[0][] = $v2;\r
                }\r
                continue;\r
            }\r
            if ($v === false) {\r
                if (isset($this->attr[$k])) {\r
                    unset($this->attr[$k]);\r
                }\r
                continue;\r
            }\r
            $this->attr[$k] = $v;\r
        }\r
        $this->_mergeAssocArray($this->excludes, $def->excludes);\r
        $this->attr_transform_pre = array_merge($this->attr_transform_pre, $def->attr_transform_pre);\r
        $this->attr_transform_post = array_merge($this->attr_transform_post, $def->attr_transform_post);\r
\r
        if (!empty($def->content_model)) {\r
            $this->content_model =\r
                str_replace("#SUPER", $this->content_model, $def->content_model);\r
            $this->child = false;\r
        }\r
        if (!empty($def->content_model_type)) {\r
            $this->content_model_type = $def->content_model_type;\r
            $this->child = false;\r
        }\r
        if (!is_null($def->child)) {\r
            $this->child = $def->child;\r
        }\r
        if (!is_null($def->formatting)) {\r
            $this->formatting = $def->formatting;\r
        }\r
        if ($def->descendants_are_inline) {\r
            $this->descendants_are_inline = $def->descendants_are_inline;\r
        }\r
    }\r
\r
    /**\r
     * Merges one array into another, removes values which equal false\r
     * @param $a1 Array by reference that is merged into\r
     * @param $a2 Array that merges into $a1\r
     */\r
    private function _mergeAssocArray(&$a1, $a2)\r
    {\r
        foreach ($a2 as $k => $v) {\r
            if ($v === false) {\r
                if (isset($a1[$k])) {\r
                    unset($a1[$k]);\r
                }\r
                continue;\r
            }\r
            $a1[$k] = $v;\r
        }\r
    }\r
}\r
\r
// vim: et sw=4 sts=4\r