rkaiser0324/dom-query

PHP PowerTools DOM-Query Component

DOM Query Component

PHPPowertools is a web application framework for PHP >= 5.4., _(*1)

PHPPowertools/DOM-Query is the first component of the PHPPowertools that has been released to the public., _(*2)

The purpose of this component is to provide a jQuery-like interface for crawling XML and HTML documents. Under the hood, it uses symfony/CssSelector for converting CSS selectors to XPath queries, _(*3)

The jQuery way :

// Find the elements that match selector 'div.foo'
$s = $('div.foo');

// Pass an element object (DOM Element)
$s = $(document.body);

// Pass a jQuery object
$s = $($('p + p'));

The DOM-Query way :

namespace App;
use \PowerTools\DOM_Query;

// Get file content
$htmlcode = file_get_contents('https://github.com');

// Create a new DOM_Query instance, using a string as a source
$H = new DOM_Query($htmlcode);

// Create a new DOM_Query instance, using an existing DOM_Query instance as a source
$H = new DOM_Query($H->select('body'));

// Find the elements that match selector 'div.foo'
$s = $H->select('div.foo');

// Pass an element object (DOM Element)
$s = $H->select($documentBody);

// Pass a DOM Query instance
$s = $H->select($H->select('p + p'));

Example use :

// Select the body tag
$body = $H->select('body');

// Combine different classes as one selector to get all site blocks
$siteblocks = $body->select('.site-header, .masthead, .site-body, .site-footer');

// Nest your methods just like you would with jQuery
$siteblocks->select('button')->add('span')->addClass('icon icon-printer');

// Use a lambda function to set the text of all site blocks
$siteblocks->text(function($i, $val) {
    return $i . " - " . $val->attr('class');
});

// Append the following HTML to all site blocks
$siteblocks->append('



');

// Use a descendant selector to select the site's footer
$sitefooter = $body->select('.site-footer > .site-center');

// Set some attributes for the site's footer
$sitefooter->attr(array('id' => 'aweeesome', 'data-val' => 'see'));

// Use a lambda function to set the attributes of all site blocks
$siteblocks->attr('data-val', function($i, $val) {
    return $i . " - " . $val->attr('class') . " - photo by Kelly Clark";
});

// Select the parent of the site's footer
$sitefooterparent = $sitefooter->parent();

// Remove the class of all i-tags within the site's footer's parent
$sitefooterparent->select('i')->removeAttr('class');

// Wrap the site's footer within two nex selectors
$sitefooter->wrap('<section>



</section>');

[...]

Supported methods :

• [x] $ (1)
• [x] $.parseHTML
• [x] $.parseXML
• [x] $.parseJSON
• [x] $selection.add
• [x] $selection.addClass
• [x] $selection.after
• [x] $selection.append
• [x] $selection.attr
• [x] $selection.before
• [x] $selection.children
• [x] $selection.closest
• [x] $selection.contents
• [x] $selection.detach
• [x] $selection.each
• [x] $selection.eq
• [x] $selection.empty (2)
• [x] $selection.find
• [x] $selection.first
• [x] $selection.get
• [x] $selection.hasClass
• [x] $selection.insertAfter
• [x] $selection.insertBefore
• [x] $selection.is
• [x] $selection.last
• [x] $selection.parent
• [x] $selection.parents
• [x] $selection.remove
• [x] $selection.removeAttr
• [x] $selection.removeClass
• [x] $selection.text
• [x] $selection.wrap

1. Renamed 'select', for obvious reasons
2. Renamed 'void', since 'empty' is a reserved word in PHP

Author

John slegers