Features Overview
The unified <gui-form> component (React <FormComponent>, Angular <gui-form>, Lit <gui-form>) takes a small set of inputs and produces a fully-rendered, validated, accessible form. Most of the interesting customization happens through the formConfig object you hand to it.
This section walks through every feature you can plug in, in increasing order of depth. Each page is self-contained — read what you need, skip the rest.
What <gui-form> accepts
Section titled “What <gui-form> accepts”| Input | Description |
|---|---|
formDef | An array of gui.* shortcuts (Programmatic) or a parsed JSON form definition. See Form Definition API. |
data | The initial form data object. |
formConfig | Engine wiring: widget loaders, item renderers, validators, dependencies, validation timing, states. |
formSelectors | GSL selectors that decorate widgets by type, tag, or uid. |
localization | i18n translator (e.g. i18next). |
formEvent | Callback for events emitted by widgets. |
formHealth | Callback that reports the live validation status of the form. |
Features
Section titled “Features”- Widget Loaders — register the UI widgets the form can render.
- Item Renderers — supply custom item templates for
dropdown,list, and similar widgets. - Validators — declarative validation rules with localized error messages.
- Middlewares — intercept the store to add logging, persistence, or schema validation.
- Form Events — listen to widget events and react in your application code.
- i18n — wire i18next or any other translator and localize labels, placeholders, validators, and dates.
- Dependencies — inject third-party helpers (e.g. a markdown parser) at the form level.
- States — declare named conditions and use them to gate fields, override props, and compose behavior.
See also
Section titled “See also”- Extending GolemUI for building your own widgets, item renderers, validators, and middlewares.
- Form Definition API for the full
gui.*andgui.selectorsreference.