webino / WebinoDraw

src/WebinoDraw/Dom/Element.php

<?php
/**
 * Webino (http://webino.sk)
 *
 * @link        https://github.com/webino/WebinoDraw for the canonical source repository
 * @copyright   Copyright (c) 2012-2017 Webino, s. r. o. (http://webino.sk)
 * @author      Peter Bačinský <peter@bacinsky.sk>
 * @license     BSD-3-Clause
 */

namespace WebinoDraw\Dom;

use DOMElement;
use DOMNode;
use DOMText;

/**
 * Class Element
 *
 * Extended DOMElement
 *
 * @method $this appendChild(DOMNode $newnode)
 */
class Element extends DOMElement implements
    NodeInterface,
    Locator\LocatorAwareInterface
{
    use NodeTrait;
    use Locator\LocatorAwareTrait;

    const NODE_NAME_PROPERTY  = 'nodeName';
    const NODE_PATH_PROPERTY  = 'nodePath';

    /**
     * @param string $locator CSS selector or XPath (xpath=)
     * @return NodeList
     */
    public function query($locator)
    {
        return new NodeList($this->getLocator(), $this->getLocator()->locate($this, $locator));
    }

    /**
     * Attributes mass assignment
     *
     * @param array $attribs
     * @param callable $callback Called on each attribute value
     * @return self
     */
    public function setAttributes(array $attribs, $callback = null)
    {
        foreach ($attribs as $name => $value) {

            is_callable($callback)
                and $value = $callback($value, $name);

            if (empty($value) && !is_numeric($value)) {
                $this->removeAttribute($name);
            } else {
                $this->setAttribute($name, trim($value));
            }
        }

        return $this;
    }

    /**
     * Returns the node body html
     *
     * @return string
     */
    public function getInnerHtml()
    {
        if (null === $this->childNodes) {
            return '';
        }

        $innerHtml = '';
        foreach ($this->childNodes as $child) {
            $childHtml = $child->ownerDocument->saveXML($child);
            empty($childHtml) or $innerHtml .= $childHtml;
        }
        return $innerHtml;
    }

    /**
     * Returns the node html
     *
     * @return string
     */
    public function getOuterHtml()
    {
        return trim($this->ownerDocument->saveXML($this));
    }

    /**
     * Returns the node text value and attributes in the array
     *
     * @param string $prefix
     * @return array
     */
    public function getProperties($prefix = null)
    {
        $properties = [
            $prefix . $this::NODE_NAME_PROPERTY  => empty($this->nodeName)  ? '' : $this->nodeName,
            $prefix . $this::NODE_VALUE_PROPERTY => empty($this->nodeValue) ? '' : $this->nodeValue,
            $prefix . $this::NODE_PATH_PROPERTY  => empty($this->nodeName)  ? '' : $this->getNodePath(),
        ];

        if (!empty($this->attributes)) {
            foreach ($this->attributes as $attr) {
                $properties[$prefix . $attr->name] = $attr->value;
            }
        }

        return $properties;
    }

    /**
     * @return bool
     */
    public function isEmpty()
    {
        $nodeValue = trim($this->nodeValue);

        if (!empty($nodeValue) || is_numeric($nodeValue)) {
            return false;
        }

        // node value is empty,
        // check for children other than text
        foreach ($this->childNodes as $childNode) {
            if (!($childNode instanceof DOMText)) {
                return false;
            }
        }

        return true;
    }

    /**
     * @param string $source
     * @return $this
     */
    public function appendHtml($source)
    {
        $errors = libxml_use_internal_errors();
        libxml_use_internal_errors(true);

        // from fragment
        $frag = $this->ownerDocument->createDocumentFragment();
        $frag->appendXml($source);

        if ($frag->hasChildNodes()) {
            $this->appendChild($frag);
            libxml_use_internal_errors($errors);
            return $this;
        }

        // from document fallback
        $dom = new Document;
        $dom->loadHTML($source, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);

LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD is of type integer, but the function expects a array|null.

        $elm = $this->ownerDocument->importNode($dom->getDocumentElement(), true);
        $this->appendChild($elm);

        libxml_use_internal_errors($errors);
        return $this;
    }
}