Built on top of PHP's native DOMDocument, this project provides access to modern DOM APIs, as you would expect working with client-side code in the browser.
Performing DOM manipulation in your server-side code enhances the way dynamic pages can be built. Utilising a standardised object-oriented interface means the page can be ready-processed, benefitting browsers, webservers and content delivery networks.
Consider a page with a form, with an input element to enter your name. When the form is submitted, the page should greet you by your name.
This is a simple example of how source HTML files can be treated as templates. This can easily be applied to more advanced template pages to provide dynamic content, without requiring non-standard techniques such as {{curly braces}} for placeholders, or echo '<div class='easy-mistake'>' . $content['opa'] . '</div>' horrible HTML construction from within PHP.
<!doctype html>
<h1>
Hello, <span id="your-name">you</span> !
</h1>
<form>
<input name="name" placeholder="Your name, please" required />
<button>Submit</button>
</form><?php
require "vendor/autoload.php";
$html = file_get_contents("name.html");
$document = new \Gt\Dom\HTMLDocument($html);
if(isset($_GET["name"])) {
$document->getElementById("your-name")->textContent = $_GET["name"];
}
echo $document->saveHTML();- DOM level 4 classes:
HTMLDocumentElementHTMLCollection- and more extended DOM classes
- Standardised traits to add functionality in accordance with W3C
- Reference elements using CSS selectors via
querySelector(All) - Add/remove/toggle elements' classes using
ClassList ElementNodes within the document traversable with W3C properties:Element::remove()to detach it from the document- Add elements around another using
Element::before()andElement::after() - Replace an element in place using
Element::replaceWith() - Standard collection properties on the
HTMLDocument:
This repository is intended to be as accurate to the DOM specification as possible. An extension to the repository is available at https://php.gt/domtemplate which adds page templating through custom elements and template attributes, introducing serverside functionality similar to that of WebComponents.