This library provides a powerful, flexible, and fluent PHP interface for generating HTML, with first-class support for modern frontend techniques using HTMX and Hyperscript.

Please read this document's package usage instructions.

HTML Element Generator

Overview

This PHP library provides a comprehensive, extensible, and fluent interface for generating HTML elements, including full support for all HTML5 and deprecated elements. It features:

• Dedicated PHP classes and static factory methods for every HTML element
• Fluent attribute and child management
• Comprehensive support for HTMX and Hyperscript
• Automated, environment-aware script injection with robust error handling
• Usage examples and documentation in every element class file

Table of Contents

• Features
• Setup
• Usage - Basic Usage - HTMX & Hyperscript - Automated Script Injection
• Coverage
• Contribution Guidelines
• License
• Links

Features

• All HTML5 and deprecated elements as PHP classes
• Static factory methods for all elements via `HtmlElement::elementname()`
• Fluent interface for setting attributes and adding children
• Usage examples in every element class file
• HTMX and Hyperscript support with dedicated setters
• Automated, environment-aware script injection (see ScriptManager)
• Easily extensible for future HTML elements and frontend libraries

Setup

1. Install via Composer:
   composer require hypertool/html
   

2. Include the Composer autoloader in your project:
   require_once 'vendor/autoload.php';
   

3. Use the namespaced classes:
   use Hypertool\Html\HtmlElement;
   use Hypertool\Html\ScriptManager;
   // ... etc.
   

4. (Optional) Configure environment: - Set the `APP_ENV` environment variable to `production` for local asset loading, or leave unset for CDN loading.

Usage

Basic Usage

// Assumes autoloader is included as per Setup instructions
use Hypertool\Html\HtmlElement;
use Hypertool\Html\H1; // Example specific element

// Using the generic HtmlElement class
$html = new HtmlElement('div');
$html->setId('myDiv')->setClass('some-class');
$html->add_child('MainTitle','h1')->text('Hello, World!')->setClass('title');
$html->MainTitle->setStyle('color: blue;');
echo $html->output();

Using Dedicated Element Classes

// Assumes autoloader is included and 'use Hypertool\Html\Div;' is present
$div = new Div('Content inside div');
echo $div->output();

Using Static Factory Methods

// Assumes autoloader is included and 'use Hypertool\Html\HtmlElement;' is present
$div = HtmlElement::div('Content inside div');
echo $div->output();

Usage Examples in Element Files

Each element class file (e.g., src/b.php, src/section.php) contains a usage example at the end, demonstrating both direct instantiation and static factory usage.

HTMX & Hyperscript

This library provides comprehensive support for HTMX and Hyperscript:

• Dedicated setters for all official HTMX attributes and events (e.g., `setHxGet`, `setHxPost`, `setHxTrigger`, `setHxSwap`, etc.)
• Dedicated setter for Hyperscript's _ attribute (`setHyperscript`)
• HTMX event support via `setHxOn($event, $handler)`

HTMX Usage Example

// Assumes autoloader is included and 'use Hypertool\Html\HtmlElement;' is present
$button = HtmlElement::button('Load Data')
    ->setHxGet('/api/data')
    ->setHxTarget('#result')
    ->setHxSwap('outerHTML');
echo $button->output();

Hyperscript Usage Example

// Assumes autoloader is included and 'use Hypertool\Html\HtmlElement;' is present
$button = HtmlElement::button('Click Me')
    ->setHyperscript('on click add .clicked to me');
echo $button->output();

Combining HTMX and Hyperscript

// Assumes autoloader is included and 'use Hypertool\Html\HtmlElement;' is present
$button = HtmlElement::button('Load & Animate')
    ->setHxGet('/api/data')
    ->setHyperscript('on htmx:afterSwap add .animated to #result');
echo $button->output();

Automated Script Injection

Use the ScriptManager class (now namespaced) for robust, environment-aware script loading:

// Assumes autoloader is included and 'use Hypertool\Html\ScriptManager;' is present

// In your page/component:
ScriptManager::requireHtmx();
ScriptManager::requireHyperscript();

// In your layout/footer (once per page):
echo ScriptManager::outputScripts();

• Loads from CDN in development, local assets in production
• Prevents duplicate inclusions
• Adds error handling and a <noscript> fallback

Coverage

• All HTML5 elements and most deprecated elements are included.
• Deprecated elements (e.g., `<marquee>`, `<font>`, `<center>`, etc.) are supported for legacy compatibility.
• For a full list of supported elements, see `src/html_elements_master_list.php`.

Contribution Guidelines

We welcome contributions! To contribute:

1. Fork the repository and create a new branch.
2. Add or update code, tests, or documentation.
3. Ensure your code follows the project's style and passes any tests.
4. Submit a pull request with a clear description of your changes.

To add new HTML elements or attributes: - Create a new PHP class in src/ for the element. - Add usage examples at the end of the file. - If adding new HTMX/Hyperscript features, update the relevant setters and documentation.

To report bugs or request features: - Open an issue on GitHub. // Updated link

License

This project is licensed under the MIT License.

Links

• HTMX Documentation
• Hyperscript Documentation
• GitHub Repository // Updated link
• Open an Issue // Updated link