← All libraries

Foundation lib for form and input primitives — the raw component implementations that sugar-bits and sugar-prompt re-export. Extracted out of those two leaf libs so the form/prompt engine can ship as a single standalone dependency.

Install

composer require sugarcraft/candy-forms

Quickstart

use SugarCraft\Forms\Field\Input;
use SugarCraft\Forms\Form;
use SugarCraft\Forms\Validator\Required;

$form = Form::new(
    Input::new('name')
        ->withTitle('What is your name?')
        ->withValidator(new Required())
);

echo $form->view();

What's in the box

Use it for

• Standalone form primitives — when you want the raw inputs without sugar-bits or sugar-prompt overhead.
• Custom form engines — build your own form system on top of the Field interface.
• Spinner and progress components — standalone spinner now lives here, was previously in sugar-bits.

Source & demos

• Source on GitHub
• Full README
• Runnable examples

Try the quickstart →

API

Class	Method	Description
Form	new(Field[])	Create a new form with fields
Field\Input	new(string)	Create a text input field
Field\Confirm	new(string)	Create a confirmation field
Field\Select	new(string, Options)	Create a select field
Validator\Required	validate(mixed)	Check value is not empty
Validator\Email	validate(mixed)	Check valid email format
Spinner\Spinner	new(Style)	Create a spinner with style

Demos.

VHS-recorded GIFs of every example shipped with the library. Regenerated automatically on every push that touches the source.