PHPackages                             ilbronza/form - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. ilbronza/form

ActiveLibrary[Utility & Helpers](/categories/utility)

ilbronza/form
=============

:form creator

1.0(3y ago)0286MITPHP

Since Sep 3Pushed 3w ago2 watchersCompare

[ Source](https://github.com/ilBronza/Form)[ Packagist](https://packagist.org/packages/ilbronza/form)[ Docs](https://github.com/ilbronza/form)[ RSS](/packages/ilbronza-form/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (3)DependenciesVersions (4)Used By (0)

IlBronza Form
=============

[](#ilbronza-form)

Pacchetto Laravel per costruire form strutturati in **fieldset**, con markup **UIkit 3**, integrazione con **Eloquent** e flussi tipici CRUD (create, edit, show, PDF). I singoli campi sono istanze di `IlBronza\FormField\FormField`, create tramite il pacchetto companion **ilbronza/formfield** (`FormFieldsProvider`).

[![Latest Version on Packagist](https://camo.githubusercontent.com/ce9747c64445a6b030adafaef8e11653179842fdbace984687c4185e95da8caf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696c62726f6e7a612f666f726d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ilbronza/form)

---

Requisiti e dipendenze
----------------------

[](#requisiti-e-dipendenze)

- **Laravel** (il service provider è auto-scoperto da `composer.json`).
- **`IlBronza\FormField`** — definizione tipi di campo, validazione lato definizione, rendering del controllo. Questo repository (`ilbronza/form`) orchestr **fieldset** e **Form**; i **FormField** vivono nel pacchetto FormField.
- In uso nel codice compaiono anche: **`IlBronza\Buttons`**, trait **`IlBronza\CRUD`** (classi HTML / navbar), **`IlBronza\UikitTemplate\Fetcher`** (extra views). Per una pagina completa come `form::uikit.form` serve un layout coerente (es. `uikittemplate::app`).

Se manca una di queste dipendenze, installarle nel progetto host o adattare le view.

---

Installazione
-------------

[](#installazione)

```
composer require ilbronza/form
```

Pubblicare la configurazione (opzionale):

```
php artisan vendor:publish --tag=form.config
```

Namespace view e traduzioni: **`form::`** (es. `form::uikit.form`, chiavi `form::form.*`).

---

Concetti: `Form`, `FormFieldset`, `FormField`
---------------------------------------------

[](#concetti-form-formfieldset-formfield)

ComponenteRuolo**`IlBronza\Form\Form`**Contenitore del form: action, method, modello, fieldset o lista piatta di campi, titolo, card, pulsanti di chiusura, modalità di visualizzazione (`form` / `show` / `pdf`).**`IlBronza\Form\FormFieldset`**Raggruppa campi (e altri fieldset annidati), legenda, griglia UIkit, larghezza colonna, collapse, ruoli di visibilità a livello fieldset.**`IlBronza\FormField\FormField`**Singolo input (text, select, relazioni, ecc.), creato da **`FormFieldsProvider::createByNameParameters($nomeCampo, $parametri)`**.Il flusso tipico è: definisci **parametri** (array o `FieldsetParametersFile`) → **`FieldsetsProvider`** li trasforma in `FormFieldset` + `FormField` → li agganci a un **`Form`** → **`$form->render()`** (o `_render()` per il partial).

---

Classe `Form`: uso programmatico
--------------------------------

[](#classe-form-uso-programmatico)

### Istanza

[](#istanza)

Il container registra un singleton `form`:

```
$form = app('form'); // oppure alias Form se configurato nel progetto
```

Oppure `new \IlBronza\Form\Form()`.

### Modello, action, method

[](#modello-action-method)

```
$form->setModel($user);
$form->setAction(route('users.update', $user));
$form->setMethod('PUT'); // la view aggiunge @method se non è GET/POST
```

### Campi senza fieldset

[](#campi-senza-fieldset)

```
$form->addFormField($formField); // $formField è FormField già costruito
```

### Fieldset

[](#fieldset)

```
$fieldset = $form->addFormFieldset('anagrafica', [
    'width' => 1,
    'columns' => 2,
    'showLegend' => true,
]);
$fieldset->addFormField($campoNome);
```

Oppure aggiungere un `FormFieldset` già creato:

```
$form->addFieldset($fieldset);
```

Per appiattire tutti i campi dei fieldset in un’unica lista (e svuotare i fieldset):

```
$form->flattenFieldsets();
```

### Ricerca campo per nome

[](#ricerca-campo-per-nome)

```
$field = $form->getFieldByName('email'); // false se assente
```

### Rendering

[](#rendering)

MetodoUso**`render()`**View `form::uikit.form` — estende `uikittemplate::app` e include il contenuto del form.**`_render()`**Partial `form::uikit._form` — card, contenuto, footer pulsanti; adatto a embed in layout custom.**`_renderAjax()`**`form::uikit._ajax`.**`_renderShow()`** / **`_renderPdf()`**Impostano `displayMode` su `show` o `pdf` e delegano a `_render()`.**`renderContent()`**Solo il blocco contenuto (`_content`) come stringa HTML.La modalità **`displayMode`** controlla come ogni `FormField` viene disegnato in `_fields.blade.php`: `render()`, `renderShow()` o `renderPdf()`.

### Aspetto e UX

[](#aspetto-e-ux)

- **`setHorizontalForm()`** / **`setVerticalForm()`** / **`setStackedForm()`** — classi UIkit (`uk-form-horizontal` vs stacked).
- **`setTitle()`**, **`setIntro()`**, **`setShowTitle()`**, **`setHideTitle()`**.
- **`hasCard()`**, **`setCard()`**, **`addCardClasses()`** — card UIkit; classi create/edit possono essere influenzate da `config('form.createCardClasses')` / `editCardClasses` nel progetto che le applica.
- **`setCancelHref()`**, pulsanti submit / “save and …” tramite **`FormButtonsTrait`** (`setHasSubmitButton`, `addSaveAndNewButton`, `addClosureButton`, ecc.).
- **`addExtraView($position, $view, $params)`**, **`addFetcher($position, $fetcher)`** — posizioni valide: `outherTop`, `outherBottom`, `innerTop`, `innerBottom`, `left`, `right`, `outherLeft`, `outherRight` (nomi storici con typo “outher”).

### Altri flag utili

[](#altri-flag-utili)

- **`setDisplayMode('form'|'show'|'pdf')`**
- **`setAllDatabaseFields()`** / **`getDatabaseField()`** — metadati opzionali per i campi.
- **`hasUpdateEditor()`** — se il modello esiste e `config('form.updateEditor')` è true (salvo override con `setUpdateEditor()`), influisce su **`hasClosureButtons()`** (footer azioni).

---

Classe `FormFieldset`
---------------------

[](#classe-formfieldset)

### Creazione

[](#creazione)

```
use IlBronza\Form\FormFieldset;

$fs = new FormFieldset('contatti', $form, [
    'legend' => 'contatti',       // chiave traduzione se translateLegend è true
    'width' => 1,                 // intero (frazione UIkit) o array es. ["1-2@m", "1-3@l"]
    'columns' => 2,             // intero o array di breakpoint per uk-child-width-*
    'classes' => ['uk-margin-bottom'],
    'containerClasses' => [],
    'showLegend' => true,
    'divider' => true,
    'translationPrefix' => 'fieldsets', // prefisso per __() sulla legenda
    'collapsedInitially' => null,        // null = usa config('form.fieldset_collapsed_by_default')
    'canBeHidden' => true,               // mostra toggle accordion sulla legenda
]);
```

### Modello

[](#modello)

- **`setModel()`** / **`setModelRecursively()`** — propaga il modello ai campi e ai fieldset figli.

### Annidamento

[](#annidamento)

- **`addFieldset($altroFormFieldset)`** — fieldset figlio.
- **`addFormFieldset($nome, $parameters)`** — crea un figlio con la stessa API.

### Custom view nel fieldset

[](#custom-view-nel-fieldset)

Se imposti `$fieldset->view` come array `['name' => 'mia.view', 'variables' => ['var' => 'metodoModello'], 'parameters' => []]`, il template può chiamare metodi sul modello per popolare variabili (**`renderView()`**).

### Visibilità e sicurezza

[](#visibilità-e-sicurezza)

- **`setVisibility(bool)`** — se false, il partial `_fieldset` non renderizza il blocco (`isVisible()`).
- A livello **array** (provider), il fieldset può avere chiave **`roles`**: visibile solo se l’utente ha **almeno uno** di quei ruoli (`hasAnyRole`); assenza utente → 403.

### Griglia e collapse

[](#griglia-e-collapse)

- Larghezza contenitore: **`width`** (vedi `getContainerHtmlClasses()`).
- Colonne campi: **`columns`** → `getColumnsClass()`.
- **`hasCollapse()`**, **`hasCollapseRow()`**, **`hasCollapseColumn()`** — se non impostati sul fieldset, leggono **`config('form.collapse')`**, `collapseRow`, `collapseColumn`.
- **`collapsedInitially`**: se il fieldset è collassabile e ha legenda, determina se il corpo parte nascosto; default globale **`fieldset_collapsed_by_default`** in `config/form.php`.

---

Definizione struttura da array: `FieldsetParametersFile` e `FieldsetsProvider`
------------------------------------------------------------------------------

[](#definizione-struttura-da-array-fieldsetparametersfile-e-fieldsetsprovider)

### Struttura ad albero

[](#struttura-ad-albero)

Ogni **chiave di primo livello** è il nome del fieldset. Il valore è un array che può contenere:

- **`fields`** — mappa `nomeCampo => parametri` (parametri passati a `FormFieldsProvider` del pacchetto FormField).
- **`fieldsets`** — fieldset annidati (stessa struttura ricorsiva).
- Opzioni di presentazione: `width`, `columns`, `classes`, `containerClasses`, `showLegend`, `divider`, `roles`, `buttons`, ecc. (tutto ciò che `FormFieldset::manageParameters()` assegna alle proprietà).

Se l’array **non** ha la chiave `fields`, viene interpretato come **solo lista di campi** e viene avvolto automaticamente in un fieldset `default` (`getSanitizedContainerParameters`).

### Shorthand per singolo campo

[](#shorthand-per-singolo-campo)

Ogni campo può essere definito in due modi (vedi `FieldsetParametersFile::parseFieldsetsParameters`):

1. **Esplicito**: `'nome' => ['type' => 'text', 'rules' => 'required|string|max:255', ...]`
2. **Compatto** (una sola chiave): `'nome' => ['text' => 'required|string|max:255']` — la chiave è il **tipo**, il valore è la stringa **rules** (o array dopo sanitizzazione).

È obbligatorio avere **`rules`** dopo il parsing (direttamente o via shorthand). Per tipi speciali (es. **`json`**) la sanitizzazione tratta anche i sotto-campi.

### Parsing centralizzato

[](#parsing-centralizzato)

```
use IlBronza\Form\Helpers\FieldsetsProvider\FieldsetParametersFile;

$file = FieldsetParametersFile::makeByParameters($arrayFieldsets);
$parametri = $file->getFieldsetsParameters();
```

`setParameters()` esegue: sanificazione container → `parseFieldsParameters()` su tutto l’albero.

### Inserire campi in una posizione

[](#inserire-campi-in-una-posizione)

```
FieldsetParametersFile::insertFieldsInPosition(
    ['nuovo_campo' => ['type' => 'text', 'rules' => 'nullable']],
    $fieldset['fields'],
    3
);
```

Utile per estendere definizioni statiche da provider o trait.

---

`FieldsetsProvider`: da parametri a `Form` / modello
----------------------------------------------------

[](#fieldsetsprovider-da-parametri-a-form--modello)

Classe base: **`IlBronza\Form\Helpers\FieldsetsProvider\FieldsetsProvider`**.

### Factory

[](#factory)

```
// Da array già pronto (es. da FieldsetParametersFile)
$provider = FieldsetsProvider::setFieldsetsParametersByArray($parameters, $model);

// Da classe che estende FieldsetParametersFile e implementa _getFieldsetsParameters()
$provider = FieldsetsProvider::setFieldsetsParametersByFile($file, $model);
```

### Collegare al form

[](#collegare-al-form)

```
FieldsetsProvider::addFieldsetsToFormByParametersFile($form, $file, $model);
// oppure
$provider->setForm($form);
$provider->setParametersByFile($file);
$provider->setFieldsetsCollectionToForm();
```

### Solo collezione di fieldset

[](#solo-collezione-di-fieldset)

```
$collection = $provider->getFieldsetsCollection();
// oppure con modello assegnato ricorsivamente:
$provider->setFieldsetsCollectionToModel();
```

Per ogni fieldset, **`filterByRolesAndPermissions`** rimuove dall’array i campi che l’utente non può vedere:

- **`roles`** sul campo: l’utente deve avere quel ruolo (`hasRole`) — i superadmin vedono tutto.
- **`permissions`**: richiede `hasAnyPermission` sul campo.

I fieldset con **`roles`** usano **`userCanSeeFieldsetByRoles`** (vedi sopra).

---

Ruoli e permessi (riepilogo)
----------------------------

[](#ruoli-e-permessi-riepilogo)

LivelloChiaveComportamentoFieldset`roles`Array di ruoli: visibile se `Auth::user()->hasAnyRole(...)`; senza utente → 403.Campo`roles`Singolo ruolo o convenzione del trait: filtro con `hasRole`.Campo`permissions``hasAnyPermission`; superadmin escluso dal filtro.---

Configurazione `config/form.php`
--------------------------------

[](#configurazione-configformphp)

ChiaveEffetto`grid-size`Classe aggiuntiva griglia sul form (default `uk-grid-small`).`divider`Default divisori griglia (anche fieldset nuovi da form con `setDivider`).`hasCard`Default uso card (il form espone `hasCard()` / `setCard()`).`updateEditor`Comportamento editor in update e pulsanti di chiusura.`showIntro`Se `getIntro()` può mostrare l’intro.`createCardClasses` / `editCardClasses`Classi extra card (consumate dal progetto che le applica).`collapse`, `collapseRow`, `collapseColumn`Default collapse griglia sui fieldset.`fieldset_collapsed_by_default`Accordion: corpo fieldset nascosto all’avvio se `collapsedInitially` è null.`showSelectPlaceholderText`Usato dal layer FormField/select nel pacchetto host.---

Esempio end-to-end minimale
---------------------------

[](#esempio-end-to-end-minimale)

```
use IlBronza\Form\Form;
use IlBronza\Form\Helpers\FieldsetsProvider\FieldsetParametersFile;
use IlBronza\Form\Helpers\FieldsetsProvider\FieldsetsProvider;

$parameters = [
    'dati' => [
        'fields' => [
            'name' => ['type' => 'text', 'rules' => 'required|string|max:120'],
            'email' => ['email' => 'nullable|email'],
        ],
        'columns' => 1,
    ],
];

$file = FieldsetParametersFile::makeByParameters($parameters);

$form = new Form();
$form->setModel($user);
$form->setAction(route('users.update', $user));
$form->setMethod('PUT');
$form->setTitle(__('Modifica utente'));

FieldsetsProvider::addFieldsetsToFormByParametersFile($form, $file, $user);

return $form->_render(); // in una view Blade: {!! $form->_render() !!}
```

*(I tipi `text` / `email` e le chiavi esatte dei parametri dipendono da **ilbronza/formfield**.)*

---

View principali
---------------

[](#view-principali)

- **`form::uikit.form`** — pagina intera (estende layout UIkit template).
- **`form::uikit._form`** — form con card, extra views, `_content`, footer.
- **`form::uikit._opening`** — tag ``, CSRF, `@method`.
- **`form::uikit._fieldsets`** / **`_fieldset`** / **`_fields`** — struttura fieldset e loop sui `FormField`.

Per integrare in un layout proprio si usa in genere **`_render()`** o **`renderContent()`**.

---

Helper aggiuntivo
-----------------

[](#helper-aggiuntivo)

**`IlBronza\Form\Helpers\FieldsetsExtractorHelper::getFieldsParametersByFieldsetsParametersArray($fieldsets)`** — appiattisce tutti i `fields` di un array fieldsets (anche annidati) in un unico array `nome => parametri` (utile per validazione o export).

Il **`FieldsetsProvider`** espone anche metodi per relazioni Eloquent (`getBindableAttributeFields`, `getExtraTableRelationshipsFields`, ecc.) quando i parametri campo definiscono **`relation`**.

---

Provider tipizzati per CRUD
---------------------------

[](#provider-tipizzati-per-crud)

Nel pacchetto sono presenti classi come **`CreateFieldsetsProvider`**, **`EditFieldsetsProvider`**, **`ShowFieldsetsProvider`**, **`ValidateStoreFieldsetsProvider`**, ecc., che estendono la base con **`$type`** statico: servono a convenzioni del progetto (es. file parametri diversi per create vs edit). La logica di costruzione fieldset è nella classe base **`FieldsetsProvider`**.

---

Change log e licenza
--------------------

[](#change-log-e-licenza)

- [changelog.md](changelog.md)
- [license.md](license.md)
- [contributing.md](contributing.md)

---

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance62

Regular maintenance activity

Popularity11

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 89% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~373 days

Total

3

Last Release

1384d ago

Major Versions

0.2 → 1.02022-09-19

### Community

Maintainers

![](https://www.gravatar.com/avatar/33c65523e8a1cdfe8ed5f5fb8d90101b28eceb8c2ef7acb50a24cf6c42b8e639?d=identicon)[ilBronza](/maintainers/ilBronza)

---

Top Contributors

[![bronza](https://avatars.githubusercontent.com/u/3426331?v=4)](https://github.com/bronza "bronza (65 commits)")[![ilBronza](https://avatars.githubusercontent.com/u/68387610?v=4)](https://github.com/ilBronza "ilBronza (7 commits)")[![lbortolon](https://avatars.githubusercontent.com/u/109848849?v=4)](https://github.com/lbortolon "lbortolon (1 commits)")

---

Tags

laravelform

### Embed Badge

![Health badge](/badges/ilbronza-form/health.svg)

```
[![Health](https://phpackages.com/badges/ilbronza-form/health.svg)](https://phpackages.com/packages/ilbronza-form)
```

###  Alternatives

[kris/laravel-form-builder

Laravel form builder - symfony like

1.7k2.3M46](/packages/kris-laravel-form-builder)[anahkiasen/former

A powerful form builder

1.4k1.4M14](/packages/anahkiasen-former)[barryvdh/laravel-form-bridge

This packages integrates Symfony Form Component in Laravel.

168371.2k3](/packages/barryvdh-laravel-form-bridge)[inkvizytor/fluentform

Form builder for Laravel

3416.6k](/packages/inkvizytor-fluentform)[vildanbina/livewire-tabs

Laravel Livewire Tab Form component

505.2k](/packages/vildanbina-livewire-tabs)[okipa/laravel-form-components

Ready-to-use and customizable form components.

208.1k1](/packages/okipa-laravel-form-components)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)