ui-awesome / html-attribute
Type-safe traits and backed enums for HTML attribute composition: global attributes, ARIA, data-*, events, and element-specific setters.
Requires
- php: ^8.3
- ui-awesome/html-helper: ^0.7.6
- ui-awesome/html-mixin: ^0.8.3
Requires (Dev)
- infection/infection: ^0.35
- maglnet/composer-require-checker: ^4.1
- php-forge/coding-standard: ^0.3
- php-forge/support: ^0.3
- phpstan/extension-installer: ^1.4
- phpstan/phpstan: ^2.2
- phpstan/phpstan-strict-rules: ^2.0
- phpunit/phpunit: ^12.5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Html Attribute
Features
A focused library for building and rendering structured HTML attributes
Type-safe helpers and value objects to compose complex attribute structures (classes, data-attributes, ARIA, etc.).
Installation
composer require ui-awesome/html-attribute:^0.8
Quick start
Compose reusable attribute APIs by combining the package traits with the immutable attribute mixin.
<?php declare(strict_types=1); namespace App; use UIAwesome\Html\Attribute\Global\{HasClass, HasData, HasId}; use UIAwesome\Html\Attribute\HasRel; use UIAwesome\Html\Attribute\Values\Rel; use UIAwesome\Html\Helper\Attributes; use UIAwesome\Html\Mixin\HasAttributes; final class LinkAttributes { use HasAttributes; use HasClass; use HasData; use HasId; use HasRel; public function render(): string { return Attributes::render($this->getAttributes()); } } $attributes = (new LinkAttributes()) ->id('documentation') ->class('nav-link') ->class('is-active') ->rel(Rel::NOOPENER) ->addDataAttribute('tracking', 'docs'); echo '<a' . $attributes->render() . ' href="/docs">Documentation</a>'; // <a class="nav-link is-active" id="documentation" rel="noopener" data-tracking="docs" href="/docs">Documentation</a>
Documentation
For detailed configuration options and advanced usage, see the repository:
- 🧪 Testing Guide
AI assistance
AI agents: read the documentation index and fetch the Markdown version
of a page by appending index.md to its URL. The
AI agents guide covers skill installation, client setup and
verification.
- 🤖
ui-awesome-html-attributeskill: global, ARIA,data-*, event and element-specific attribute traits, and their value enums.
Match the installed package revision. If hosted documentation does not match or is unavailable, use the
repository guides, the installed skill source at skills/ui-awesome-html-attribute/SKILL.md, the source
PHPDoc and the changelog. The package-specific AI guide is available in the repository after the pending
skill changes are published. This package is framework-independent and does not render HTML by itself; rendering comes
from ui-awesome/html-helper.