Html Field

A fluent, immutable PHP library for rendering form fields bound to a form model.
Labels, hints, errors, and controls composed through application-scoped configuration.

Features

Installation

Quick start

Render a field bound to a form model

The field resolves the id, name, and label from the form model and renders a text input by default.

Html output:

Hints and validation errors

Hints link to the input through aria-describedby; property errors render after the control.

Html output:

Replace the control and style the container

Any form control can replace the default input; the form model field config is applied to the replacement.

Html output:

Semantic control factory

Field selects controls through ControlFactory and applies application-scoped recipes to the field, container, control-specific input container and label, control, hint, error, prefix, and suffix contexts. The package does not select a theme: replace $theme with any ThemeInterface implementation, such as Bootstrap5Theme or TailwindTheme.

The default registry supports checkbox, checkbox-list, email, password, radio, radio-list, select, text, and textarea. Registrations are immutable — derive a factory with with() to replace or extend them.

Select and its typed Option objects come from ui-awesome/html: compose the control there and the field passes the resolved model value to Select::value().

CheckboxList, RadioList, and ChoiceItem also come from ui-awesome/html; Field supplies their checked values, name, validation state, label, hint, and errors. See the usage guide for examples, slot contexts, and recipe methods.

Strict field configurations

Form model field configurations are applied through the core config applier in strict mode, once per render, against the control the field finally resolves — so the fluent call order never changes the outcome. An entry naming a method the resolved control does not expose throws ConfigException instead of being skipped, so typos such as maxlenght fail at render time. The model binding runs first and the config last, so entries such as value, id, name, checked, and placeholder act as explicit per-property overrides rather than being silently overwritten. See the upgrade guide for the precedence rules and supported entry shapes.

Documentation

For detailed usage, testing, and quality workflows.

• Testing Guide

Package information

Project status

Our social networks

License