Fields

Repeater

Repeater manages repeated groups of fields and can persist hasMany relationship data.

Repeater manages repeated groups of fields and can persist hasMany relationship data.

Basic Usage

use NyonCode\WireForms\Components\Repeater;
use NyonCode\WireForms\Components\TextInput;
 
Repeater::make('contacts')
    ->schema([
        TextInput::make('name')->required(),
        TextInput::make('email')->email(),
    ])
use NyonCode\WireForms\Components\Repeater;
use NyonCode\WireForms\Components\TextInput;

Repeater::make('contacts')
    ->schema([
        TextInput::make('name')->required(),
        TextInput::make('email')->email(),
    ])

Relationship Mode

Use relationship() when the repeater should save related records.

Repeater::make('contacts')
    ->relationship('contacts')
    ->schema([
        TextInput::make('name')->required(),
        TextInput::make('email')->email(),
    ])
    ->addable()
    ->deletable()
    ->reorderable()
Repeater::make('contacts')
    ->relationship('contacts')
    ->schema([
        TextInput::make('name')->required(),
        TextInput::make('email')->email(),
    ])
    ->addable()
    ->deletable()
    ->reorderable()

Limits and UX Controls

Repeater::make('contacts')
    ->minItems(1)
    ->maxItems(10)
    ->addButtonLabel('Add contact')
    ->collapsible()
Repeater::make('contacts')
    ->minItems(1)
    ->maxItems(10)
    ->addButtonLabel('Add contact')
    ->collapsible()

Method	Purpose
`addable()`	Allow new items
`deletable()`	Allow item removal
`reorderable()`	Allow manual reordering
`collapsible()`	Let users collapse item blocks
`collapsed()`	Start items collapsed
`minItems()` / `maxItems()`	Constrain collection size
`addable(bool)`	Allow adding new items (default `true`)
`deletable(bool)`	Allow removing items (default `true`)
`reorderable(bool)`	Allow drag-to-reorder (default `false`)
`collapsible(bool)`	Allow collapsing item blocks
`collapsed(bool)`	Start all items collapsed (implies `collapsible`)
`minItems(int\|null)`	Minimum item count
`maxItems(int\|null)`	Maximum item count
`addButtonLabel(string\|null)`	Label on the add button
`disabled(bool\|Closure)`	Disable add/delete/reorder controls
`mutateRelationshipDataBeforeSaveUsing(Closure)`	Transform item data before persistence

When to Use It

Use Repeater when a single form owns a small to medium collection of related child records and the user should manage them inline.

If the child records need independent filtering, pagination, or heavy workflows, give them their own table or screen.

Repeater

Basic Usage

Relationship Mode

Limits and UX Controls

When to Use It

Related Docs