ilDOMUtil Class Reference

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Collaboration diagram for ilDOMUtil:

Static Public Member Functions
static	setFirstOptionalElement (php4DOMDocument $doc, php4DOMElement $parent_node, string $a_node_name, array $a_successors, string $a_content, array $a_attributes, bool $a_remove_childs=true)
	searches for an element $a_node_name within the childs of $parent_node if no node is found, a new is created before the childs with names of $a_successors. More...
static	set_attributes (php4DOMElement $a_node, array $a_attributes)
	set attributes of a node More...
static	deleteAllChildsByName (php4DOMElement $a_parent, array $a_node_names)
	delete all childs of a node by names in $a_node_names More...
static	addElementToList (php4DOMDocument $doc, php4DOMElement $parent_node, string $a_node_name, array $a_successors, string $a_content, array $a_attributes)
	Places a new node $a_node_name directly before nodes with names of $a_successors. More...

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning class for DOM utilities

Author

Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 24 of file class.ilDOMUtil.php.

Member Function Documentation

addElementToList()

static ilDOMUtil::addElementToList ( php4DOMDocument  $doc, php4DOMElement  $parent_node, string  $a_node_name, array  $a_successors, string  $a_content, array  $a_attributes  )

static

Places a new node $a_node_name directly before nodes with names of $a_successors.

The content of the node is set to $a_content and the attributes to $a_attributes

Definition at line 128 of file class.ilDOMUtil.php.

References php4DOMNode\append_child(), php4DOMNode\child_nodes(), php4DOMDocument\create_element(), and set_attributes().

Referenced by ilMediaAliasItem\addMapArea(), ilPCInteractiveImage\addTriggerArea(), ilPCInteractiveImage\addTriggerMarker(), and ilMediaAliasItem\setParameters().

     : php4DOMElement {
        $search = $a_successors;
        $child = null;
        $childs = $parent_node->child_nodes();
        $cnt_childs = count($childs);
        $found = false;
        foreach ($childs as $child) {
            $child_name = $child->node_name();
            if (in_array($child_name, $search)) {
                $found = true;
                break;
            }
        }
        // didn't successors -> append at the end
        $new_node = $doc->create_element($a_node_name);
        if (!$found) {
            $new_node = $parent_node->append_child($new_node);
        } else {
            $new_node = $child->insert_before($new_node, $child);
        }
        if ($a_content != "") {
            $new_node->set_content($a_content);
        }
        ilDOMUtil::set_attributes($new_node, $a_attributes);

        return $new_node;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

deleteAllChildsByName()

static ilDOMUtil::deleteAllChildsByName ( php4DOMElement  $a_parent, array  $a_node_names  )

static

delete all childs of a node by names in $a_node_names

Definition at line 110 of file class.ilDOMUtil.php.

References php4DOMNode\child_nodes().

Referenced by ilPCTabs\saveCaptions(), ilMediaAliasItem\setAreaExtLink(), ilMediaAliasItem\setAreaIntLink(), ilPCTable\setCaption(), and ilPCSection\setNoLink().

     : void {
        $childs = $a_parent->child_nodes();
        foreach ($childs as $child) {
            $child_name = $child->node_name();
            if (in_array($child_name, $a_node_names)) {
                $child->unlink_node();
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

set_attributes()

static ilDOMUtil::set_attributes ( php4DOMElement  $a_node, array  $a_attributes  )

static

set attributes of a node

Parameters

array

$a_attributes

attributes array (attribute_name => attribute_value pairs)

Definition at line 92 of file class.ilDOMUtil.php.

References php4DOMElement\has_attribute(), php4DOMElement\remove_attribute(), and php4DOMElement\set_attribute().

Referenced by addElementToList(), and setFirstOptionalElement().

     : void {
        foreach ($a_attributes as $attribute => $value) {
            if ($value != "") {
                $a_node->set_attribute($attribute, $value);
            } else {
                if ($a_node->has_attribute($attribute)) {
                    $a_node->remove_attribute($attribute);
                }
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setFirstOptionalElement()

static ilDOMUtil::setFirstOptionalElement ( php4DOMDocument  $doc, php4DOMElement  $parent_node, string  $a_node_name, array  $a_successors, string  $a_content, array  $a_attributes, bool  $a_remove_childs = true  )

static

searches for an element $a_node_name within the childs of $parent_node if no node is found, a new is created before the childs with names of $a_successors.

the content of the node is set to $a_content and the attributes to $a_attributes

Definition at line 32 of file class.ilDOMUtil.php.

References $i, php4DOMNode\append_child(), php4DOMNode\child_nodes(), php4DOMDocument\create_element(), and set_attributes().

Referenced by ilMediaAliasItem\addMapArea(), ilPCTabs\addTab(), ilPCTabs\saveCaptions(), ilMediaAliasItem\setAreaExtLink(), ilMediaAliasItem\setAreaIntLink(), ilPCMap\setCaption(), ilMediaAliasItem\setCaption(), ilPCTable\setCaption(), ilPCSection\setExtLink(), ilMediaAliasItem\setHeight(), ilMediaAliasItem\setHorizontalAlign(), ilPCSection\setIntLink(), ilPCMap\setLayout(), ilPCFileList\setListTitle(), ilMediaAliasItem\setTextRepresentation(), and ilMediaAliasItem\setWidth().

     : void {
        $search = $a_successors;
        $search[] = $a_node_name;
        $child_name = "";
        $child = null;

        $childs = $parent_node->child_nodes();
        $found = false;
        foreach ($childs as $child) {
            $child_name = $child->node_name();
            //echo "B$child_name";
            if (in_array($child_name, $search)) {
                //echo "C";
                $found = true;
                break;
            }
        }
        // didn't find element
        if (!$found) {
            $new_node = $doc->create_element($a_node_name);
            $new_node = $parent_node->append_child($new_node);
            if ($a_content != "") {
                $new_node->set_content($a_content);
            }
            ilDOMUtil::set_attributes($new_node, $a_attributes);
        } else {
            if ($child_name == $a_node_name) {
                if ($a_remove_childs) {
                    $childs2 = $child->child_nodes();
                    for ($i = 0; $i < count($childs2); $i++) {
                        $child->remove_child($childs2[$i]);
                    }
                }
                if ($a_content != "") {
                    $child->set_content($a_content);
                }
                ilDOMUtil::set_attributes($child, $a_attributes);
            } else {
                $new_node = $doc->create_element($a_node_name);
                $new_node = $child->insert_before($new_node, $child);
                if ($a_content != "") {
                    $new_node->set_content($a_content);
                }
                ilDOMUtil::set_attributes($new_node, $a_attributes);
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

---

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

• Services/COPage/DOM/class.ilDOMUtil.php