vardumper/extended-htmldocument

ExtendedHTMLDocument is a simple PHP library which adds all HTML5 Elements as PHP classes and extends PHP 8.4's DOM\HTMLDocument class.

0.2.77 2026-01-07 11:46 UTC

Requires

• php: ^8.4
• ext-dom: *
• mnapoli/silly: ^1.9.1
• revolt/event-loop: ^1.0.8
• symfony/yaml: ^5.4|^7.0|^8.0.1

Requires (Dev)

• amphp/file: >=3.2
• brainmaestro/composer-git-hooks: dev-master
• edent/pretty-print-html: 2025-04-18
• friendsofphp/php-cs-fixer: ^3.92.4
• pestphp/pest: ^3.8.4
• pestphp/pest-plugin-drift: ^3.0
• pestphp/pest-plugin-type-coverage: ^3.6.1
• phpmd/phpmd: ^2.15
• phpstan/phpstan: ^2.1.33
• rector/swiss-knife: ^2.3.4
• symfony/http-kernel: ^5.4|^6.0|^7.0|^8.0.3
• symfony/ux-twig-component: ^2.32
• symplify/easy-coding-standard: ^12.6.2

Suggests

• ext-tidy: Required for formatting HTML5 output.

MIT

• Erik Pöhler

• php
• code generation
• HTML5
• html
• dom
• document
• code generator
• extended
• php8
• php84
• htmldocument

README

Extended HTML Document Library

This library provides a way to work with HTML elements in PHP, offering an object-oriented approach that aligns with the HTML5 specifications. It also provides a way to automatically transform HTML into different templating engines or code for frontend frameworks. It also adds autocompletion to PHP for all HTML5 elements, which is especially useful when working with DOM Documents. It adds additional functionality and a stronger focus on HTML5 while being fully compatible with PHP's DOM\HTMLDocument and DOM\HTMLElement classes.

Installation

composer require --dev vardumper/extended-htmldocument

TL;DR

This library adds the HTML5 specification to PHP and is fully compatible with DOM\HTMLDocument. You can create an Anchor() object and append it to any DOM\Document.

use Html\Delegator\HTMLDocumentDelegator as HTMLDocument;
use Html\Element\Inline\Anchor;

$dom = HTMLDocument::createEmpty()
echo (string) Anchor::create($dom)
    ->setClass('secondary')
    ->setRel(RelEnum::NOFOLLOW)
    ->setHref('https://google.com')
    ->setTitle('Google it')
    ->setContent('Click me');
// output is:
// <a class="secondary" href="https://google.com" rel="nofollow" title="Google it">Click me</a>

Generated Templates

Templates are generated from the HTML5 schema for every HTML element. These allow for better consistency in your design system(s), support all possible HTML attributes and have basic validations for enum attributes. Files are grouped into inline, block and void elements. For elements with a specific content model, a composed template is generated as well. (eg <table><tr><td>Cell</td><tr></table>)

Blade

Blade templates can be found in templates/blade. The README has more infos and usage examples. Blade templates can also be installed via npm with the @typesafe-html5/blade package.

React & NextJS

React and NextJS templates can be found in templates/blade. See the Blade-specific README file for details. Blade templates can also be installed via npm with the @typesafe-html5/react package.

Storybook

Storybook with atoms for all HTML5 elements can be seen in the Demo. Files can be found in templates/storybook. There's also a README with more details.

Storybook for Twig

TBD

Storybook for React/NextJS

TBD

Twig

Twig templates for flexible and performant use with include, embed, and use can be found in templates/twig. See the README for more details and usage examples. Twig templates can also be installed via npm with the @typesafe-html5/twig package.

Twig Components Bundle

Generated, typesafe Twig Components for use with Symfony UXs Twig Components can be found in templates/twig-component. See the README for more details and usage examples. Twig templates can also be installed via the Symfony Bundle vardumper/html5-twig-component-bundle package.

Typescript

Typescript templates can be found in templates/typescript. See the README for more details and usage examples. Typescript templates can also be installed via npm with the @typesafe-html5/typescript package.

Documentation

See the Documentation for more.