Stars: 106
Forks: 26
Pull Requests: 315
Issues: 127
Watchers: 6
Last Updated: 2023-07-25 12:00:42
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, benefiting browsers, webservers and content delivery networks.
Important note: the example shown here is for illustrative purposes, but using the DOM to directly set data to elements' values tightly couples the logic to the view, which is considered bad practice. Please see the DomTemplate library for a more robust solution to binding data to the DOM.
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>'
error-prone HTML construction from within PHP.
name.html
)<!doctype html>
<h1>
Hello, <span class="name-output">you</span> !
</h1>
<form>
<input name="name" placeholder="Your name, please" required />
<button>Submit</button>
</form>
index.php
)<?php
use Gt\Dom\HTMLDocument;
use Gt\Dom\HTMLElement\HTMLSpanElement;
require "vendor/autoload.php";
$html = file_get_contents("name.html");
$document = new HTMLDocument($html);
if(isset($_GET["name"])) {
$span = $document->querySelector(".name-output");
$span->innerText = $_GET["name"];
}
echo $document;
Element
type represents all HTMLElement
specifications, such as HTMLAnchorElement
(<a>
), HTMLButtonElement
(<button>
), HTMLInputElement
(<input>
), HTMLTableSectionElement
(<thead>
, <tbody>
, <tfoot>
), etc. The particular type can be detected with Element::getElementType()
, which returns one of the ElementType
enum values.DOMException
extensions for catching different types of exception, such as EnumeratedValueException
, HierarchyRequestError
, IndexSizeException
, etc.FileList
, StyleSheet
, VideoTrackList
, WindowProxy
, etc.Element::querySelector()
and (Element::querySelectorAll()
)ClassList
Element::previousElementSibling
, Element::nextElementSibling
, Element::children
and Element::lastElementChild
and firstElementChild
, etc.ChildNode::remove()
, ChildNode::before
, ChildNode::after
, ChildNode::replaceWith()
HTMLDocument
:
This repository aims to be as accurate as possible to the DOM specification at https://dom.spec.whatwg.org/ - as of v4.0.0 all functionality is implemented with the following minor but unavoidable deviations from the standard:
tagName
property is uppercase.HTMLElement
type, Element::getElementType()
must be called - no subclasses of Element
are available for usage with instanceof
, for example.HTMLInputElement::files
returns a FileList
that enumerates all files that are selected by the user through the browser's interface. This kind of functionality is impossible to implement server-side, but has been stubbed out for consistency with the specification. Attempting to use client-side functionality within this library throws a ClientSideOnlyFunctionalityException
.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 and data binding through custom elements and template attributes, introducing serverside functionality like that of WebComponents.