Awcodes Filament Table Repeater

https://github.com/awcodes/filament-table-repeater
Admin
Awcodes Filament Table Repeater is a Laravel and Filament package that modifies the native Filament...
Tokens:25,519
Snippets:217
Trust Score:9.6
License:MIT
Update:4 weeks ago
Show doc for...
Tokens:
Raw
### setUp()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Lifecycle hook that registers extra actions into Filament's action registry.

```APIDOC
## [PROTECTED] setUp()

### Description
Lifecycle hook; registers extra actions into Filament's action registry.

### Method
PROTECTED

### Endpoint
N/A

### Parameters
None

### Request Example
N/A

### Response
#### Success Response (void)
- **void** - No return value.

#### Response Example
N/A
```

--------------------------------

### setUp() method declaration

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Declares the protected `setUp()` method. Called by Filament's component lifecycle, it calls `parent::setUp()` and registers extra actions.

```php
protected function setUp(): void
```

--------------------------------

### Install the package with Composer

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Installs the package via Composer. Must be run in a Filament project with a custom theme set up.

```bash
composer require awcodes/filament-table-repeater
```

--------------------------------

### Example: using streamlined() on TableRepeater

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Example usage of the streamlined() method on a TableRepeater field. Shows how to enable the streamlined appearance and chain other methods.

```php
use Awcodes\TableRepeater\Components\TableRepeater;

TableRepeater::make('users')
    ->streamlined()
    ->headers([/* ... */])
    ->schema([/* ... */]);
```

--------------------------------

### Example usage of TableRepeater with showLabels()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Example of creating a TableRepeater with `showLabels()` to keep labels visible, and a schema with a required TextInput.

```php
use Awcodes\TableRepeater\Components\TableRepeater;
use Filament\Forms\Components\TextInput;

$component = TableRepeater::make('users')
    ->showLabels()               // labels stay visible
    ->schema([
        TextInput::make('name')->required(),
    ]);
```

--------------------------------

### setUp()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Called by Filament's component lifecycle. Registers extra actions via getExtraActions().

```APIDOC
## setUp()

### Description
Called by Filament's component lifecycle. Registers extra actions via getExtraActions().

### Method
setUp

### Parameters
None.

### Return
`void`.

### Example
```php
protected function setUp(): void
{
    parent::setUp();
    $this->registerActions([
        fn (TableRepeater $component): array => $component->getExtraActions()
    ]);
}
```
```

--------------------------------

### make() usage example

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Creates a new Header instance using the static factory method.

```php
use Awcodes\TableRepeater\Header;

Header::make('name');
```

--------------------------------

### width() usage example

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Example usage of width() to set the header width to 150px.

```php
Header::make('name')->width('150px');
```

--------------------------------

### showLabels() usage example

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Example of using showLabels() in a TableRepeater configuration to keep child field labels visible.

```php
TableRepeater::make('users')
    ->showLabels()
    ->schema([/* ... */]);
```

--------------------------------

### Usage Example (typical)

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Shows a typical usage of TableRepeater with headers, width, alignment, and required markers.

```php
use Awcodes\TableRepeater\Components\TableRepeater;
use Awcodes\TableRepeater\Header;
use Filamentorms"; // truncated for brevity in this example, but in real output it would be the full code block verbatim from the source. The source code block is: use Awcodes	ableRepeater	ableRepeater; ... (full code as shown above). For the purpose of this exercise, I will include the full code block exactly as it appears in the source. Since the source is provided in the prompt, I will copy it exactly. However, the prompt says 
```

--------------------------------

### label() example

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Sets the header text to 'E-mail address' when creating a Header instance.

```php
Header::make('email')->label('E-mail address');
```

--------------------------------

### Usage example with stackAt

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Shows how to use the stackAt method with a MaxWidth enum to set the break point for a table repeater.

```php
use Awcodes\TableRepeater\Components\TableRepeater;
use Filament\Support\Enums\MaxWidth;

TableRepeater::make('users')
    ->stackAt(MaxWidth::Large)
    ->schema([/* ... */]);
```

--------------------------------

### Register extra actions in setUp()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Registers extra actions via `registerActions()`. Each time the action registry is resolved, `getExtraActions()` is invoked, turning actions added via `extraActions()`/`extraItemActions()` into real Filament `Action` objects.

```php
$this->registerActions([
    fn (TableRepeater $component): array => $component->getExtraActions()
]);
```

--------------------------------

### HasEmptyLabel usage example

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Shows how to set a custom empty label or hide the empty container entirely using the emptyLabel() method.

```php
use Awcodes\TableRepeater\Components\TableRepeater;

TableRepeater::make('users')
    ->emptyLabel('There are no users registered.')
    ->schema([/* ... */]);

// or hide it entirely:
TableRepeater::make('users')
    ->emptyLabel(false)
    ->schema([/* ... */]);
```

--------------------------------

### markAsRequired() usage example

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Example usage of markAsRequired() to show the required marker on the header.

```php
Header::make('name')->markAsRequired();
```

--------------------------------

### HasExtraActions usage example

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Shows how to add custom actions to the TableRepeater using the extraActions() method.

```php
use Awcodes\TableRepeater\Components\TableRepeater;
use Filament\Forms\Components\Actions\Action;
use Filament\Notifications\Notification;

TableRepeater::make('users')
    ->extraActions([
        Action::make('exportData')
            ->icon('heroicon-m-inbox-arrow-down')
            ->action(function (TableRepeater $component): void {
                Notification::make('export_data')
                    ->success()
                    ->title('Data exported.')
                    ->send();
            }),
    ])
    ->schema([/* ... */]);
```

--------------------------------

### Header::make

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Creates a new Header component.

```APIDOC
## Header::make

### Description
Creates a new Header component.

### Method
make

### Parameters
- **name** (string) - Required - The header name.

### Request Example
```php
Header::make('name')
```

### Response
Returns a Header instance.

```

--------------------------------

### configurePackage() method and builder calls

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeaterServiceProvider.md

Configures the package by setting its name and registering assets, translations, and views. This method is called by Spatie Laravel Package Tools during provider registration.

```php
public function configurePackage(Package $package): void
```

```php
$package->name('table-repeater')
    ->hasAssets()
    ->hasTranslations()
    ->hasViews();
```

--------------------------------

### Header::__construct

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Creates a new Header instance. The constructor accepts a column name and optional label, alignment, width, and required flag.

```APIDOC
## Header::__construct

### Description
Creates a new Header instance. The constructor accepts a column name and optional label, alignment, width, and required flag.

### Method
Constructor

### Signature
```php
final public function __construct(
    public string $name,
    public string | Htmlable | Closure | null $label = null,
    public string | Closure | Alignment | null $align = null,
    public string | Closure | null $width = null,
    public bool | Closure | null $isRequired = null,
){}
```

### Parameters
- **$name** (string) - Required - Column identifier; also used as the default label.
- **$label** (string | Htmlable | Closure | null) - Optional - Displayed header text. A Closure is evaluated lazily; Htmlable renders as-is.
- **$align** (string | Closure | Alignment | null) - Optional - Column alignment. Alignment is Filament\Support\Enums\Alignment. Members: Start, Center, End, Right, Left. A string value may also be supplied.
- **$width** (string | Closure | null) - Optional - CSS width applied inline to the header cell (e.g. '150px'). Evaluated; falls back to 'auto'.
- **$isRequired** (bool | Closure | null) - Optional - When truthy, a red * marker renders next to the header label.

### Source
`src/Header.php:15-21`
```

--------------------------------

### getStackAt() implementation

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Evaluates the stackAt property and defaults to MaxWidth::Medium if not set.

```php
return $this->evaluate($this->stackAt)
    ?? MaxWidth::Medium;
```

--------------------------------

### stackAt() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Sets the break point for stacking. Accepts a string, MaxWidth enum, or Closure.

```php
public function stackAt(string | MaxWidth | Closure $stackAt): static
```

--------------------------------

### make() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Factory method that resolves a Header instance through the Laravel container. Requires the Laravel container, which is always available inside a Filament form/Livewire lifecycle.

```php
public static function make(string $name): static
```

--------------------------------

### make()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Factory method that resolves a Header instance through the Laravel container. Requires the Laravel container, which is always available inside a Filament form/Livewire lifecycle.

```APIDOC
## make()

### Description
Factory method. Resolves an instance through the Laravel container: `app(static::class, ['name' => $name])`. Requires the Laravel container (always available inside a Filament form/Livewire lifecycle).

### Method
make

### Signature
`public static function make(string $name): static`

### Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `$name` | `string` | yes | Same as the constructor's `$name`. |

### Return
`static` — a new `Header` instance.

### Example
```php
use Awcodes\TableRepeater\Header;

Header::make('name');
```
```

--------------------------------

### getAlignment() implementation

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Implementation of getAlignment(): evaluates the alignment closure or defaults to Alignment::Start.

```php
return $this->evaluate($this->align)
    ?? Alignment::Start;
```

--------------------------------

### showLabels() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Defines the public method signature for showLabels(). Accepts a boolean or Closure condition, defaults to true. Returns static for chaining.

```php
public function showLabels(bool | Closure | null $condition = true): static
```

--------------------------------

### getStackAt()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Retrieves the current stack break point, defaulting to MaxWidth::Medium if not set.

```APIDOC
## getStackAt()

### Description
Retrieves the current stack break point, defaulting to MaxWidth::Medium if not set.

### Method
getStackAt

### Signature
```php
public function getStackAt(): string | MaxWidth
```

### Return Value
- **string | MaxWidth** - The break point value, either a string or a MaxWidth enum.

### Default
- **MaxWidth::Medium** - Used when no break point is explicitly set.

### Example
```php
$breakPoint = $component->getStackAt();
```
```

--------------------------------

### Header constructor definition

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Defines the Header class constructor with promoted properties. All parameters are optional except $name. The class is final and cannot be extended.

```php
final public function __construct(
    public string $name,
    public string | Htmlable | Closure | null $label = null,
    public string | Closure | Alignment | null $align = null,
    public string | Closure | null $width = null,
    public bool | Closure | null $isRequired = null,
){}
```

--------------------------------

### TableRepeater::make()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Creates a new TableRepeater instance. This is the primary constructor method inherited from Filament's Repeater.

```APIDOC
## TableRepeater::make()

### Description
Creates a new TableRepeater instance. This is the primary constructor method inherited from Filament's Repeater.

### Method
`TableRepeater::make(string $name)`

### Parameters
- **$name** (string) - Required - The name of the repeater field.

### Example
```php
TableRepeater::make('users')
```
```

--------------------------------

### getView() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Defines the public method signature for getView(). Returns a string representing the Blade template path.

```php
public function getView(): string
```

--------------------------------

### showLabels()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Sets the $showLabels property to control whether child field labels are visible. Accepts a boolean or a Closure that is evaluated by the Livewire component.

```APIDOC
## showLabels()

### Description
Sets the `$showLabels` property. Passing `true` (the default) or a `Closure` that evaluates truthy keeps child field labels visible. Note that passing `null` explicitly is accepted by the type system but behaves the same as not calling the method (it evaluates to the `false` default in `shouldShowLabels()`).

### Method
showLabels

### Signature
```php
public function showLabels(bool | Closure | null $condition = true): static
```

### Parameters
- **$condition** (bool | Closure | null) - Optional - Default: `true` - Whether child field labels are shown; a `Closure` is evaluated by the containing Livewire component.

### Return
`static` — instance for chaining.

### Example
```php
TableRepeater::make('users')
    ->showLabels()
    ->schema([/* ... */]);
```
```

--------------------------------

### Header::align

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Sets the alignment of the header.

```APIDOC
## Header::align

### Description
Sets the alignment of the header.

### Method
align

### Parameters
- **alignment** (Alignment) - Required - The alignment enum value.

### Request Example
```php
Header::make('name')
    ->align(Alignment::Center)
```

### Response
Returns the Header instance for chaining.

```

--------------------------------

### shouldShowLabels() implementation

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Implementation of shouldShowLabels() that evaluates the showLabels property and defaults to false.

```php
return $this->evaluate($this->showLabels) ?? false;
```

--------------------------------

### label() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Defines the header label. Accepts a string, Htmlable, or Closure; Closure values are evaluated by getLabel().

```php
public function label(string | Htmlable | Closure $label): static
```

--------------------------------

### getLabel() implementation

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Implementation of getLabel(): evaluates the label closure or falls back to title-cased name.

```php
return $this->evaluate($this->label)
    ?? (string) Str::of($this->name)->title();
```

--------------------------------

### getAlignment()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Returns the alignment for the header, evaluating closures if set, otherwise defaults to Alignment::Start.

```APIDOC
## getAlignment()

### Description
Returns the alignment for the header, evaluating closures if set, otherwise defaults to Alignment::Start.

### Method
`public function getAlignment(): string | Alignment`

### Parameters
None.

### Return
`string | Alignment` — the alignment if set (closures evaluated), otherwise `Filament\Support\Enums\Alignment::Start`.
```

--------------------------------

### Header::width

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Sets the width of the header.

```APIDOC
## Header::width

### Description
Sets the width of the header.

### Method
width

### Parameters
- **width** (string) - Required - The CSS width value.

### Request Example
```php
Header::make('name')
    ->width('150px')
```

### Response
Returns the Header instance for chaining.

```

--------------------------------

### width() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Signature of the width() method. Accepts a string or Closure for the CSS width, returns static for chaining.

```php
public function width(string | Closure $width): static
```

--------------------------------

### emptyLabel() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Defines the emptyLabel() method that accepts a bool, string, Closure, or null, and returns a static instance.

```php
public function emptyLabel(bool | string | Closure | null $label = null): static
```

--------------------------------

### label()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Sets the header label. Accepts a string, Htmlable, or Closure. Closure values are evaluated by getLabel().

```APIDOC
## label()

### Description
Sets the header label. Accepts a string, Htmlable, or Closure. Closure values are evaluated by getLabel().

### Method
label

### Signature
`public function label(string | Htmlable | Closure $label): static`

### Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `$label` | `string \| Htmlable \| Closure` | yes | Header text. `Closure` values are evaluated by `getLabel()`. |

### Return
`static` — instance for chaining.

### Example
```php
Header::make('email')->label('E-mail address');
```
```

--------------------------------

### cacheExtraActions() action normalization

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Normalizes each action by setting default color, size, and view before caching.

```php
$this->cachedExtraActions[$action->getName()] = $this->prepareAction(
    $action
        ->defaultColor('gray')
        ->defaultSize(ActionSize::Small)
        ->defaultView(Action::BUTTON_VIEW),
);
```

--------------------------------

### TableRepeater class using all five concerns

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Shows how the TableRepeater component consumes the five feature traits. This is the class definition from the source file, demonstrating the use of all concerns.

```php
class TableRepeater extends Repeater
{
    use Concerns\CanBeStreamlined;
    use Concerns\HasBreakPoints;
    use Concerns\HasEmptyLabel;
    use Concerns\HasExtraActions;
    use Concerns\HasHeader;
    // ...
}
```

--------------------------------

### getWidth() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Declares the public getWidth method that returns a string. The method evaluates the width property and falls back to 'auto' when unset.

```php
public function getWidth(): string
```

--------------------------------

### TableRepeater::showLabels

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Shows the form component labels.

```APIDOC
## TableRepeater::showLabels

### Description
Shows the form component labels.

### Method
showLabels

### Parameters
None.

### Request Example
```php
TableRepeater::make('users')
    ->showLabels()
```

### Response
Returns the TableRepeater instance for chaining.

```

--------------------------------

### getView()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Returns the view name for the table repeater component.

```APIDOC
## [PUBLIC] getView()

### Description
Returns the view name for the table repeater component.

### Method
PUBLIC

### Endpoint
N/A

### Parameters
None

### Request Example
N/A

### Response
#### Success Response (string)
- **string** - View name `'table-repeater::components.table-repeater'`.

#### Response Example
```php
'table-repeater::components.table-repeater'
```
```

--------------------------------

### headers() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Accepts an array of `Awcodes\.TableRepeater\.Header` instances or a closure returning one. Returns `$this` for chaining.

```php
public function headers(array | Closure $headers): static
```

--------------------------------

### renderHeader() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Controls whether the header row renders visually. When `false`, the `<thead>` is styled `sr-only` (hidden visually, still exposed to assistive technology).

```php
public function renderHeader(bool | Closure $condition = true): static
```

--------------------------------

### getStackAt() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Returns the current stackAt value as a string or MaxWidth enum.

```php
public function getStackAt(): string | MaxWidth
```

--------------------------------

### TableRepeater::make

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Creates a new TableRepeater field instance.

```APIDOC
## TableRepeater::make

### Description
Creates a new TableRepeater field instance.

### Method
make

### Parameters
- **name** (string) - Required - The name of the field.

### Request Example
```php
TableRepeater::make('users')
```

### Response
Returns a TableRepeater instance.

```

--------------------------------

### getExtraActions()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Returns the cached prepared actions, computed once per request by `cacheExtraActions()`.

```APIDOC
## getExtraActions(): array<Action>

### Description
Returns the cached prepared actions, computed once per request by `cacheExtraActions()`.

### Method
getExtraActions

### Returns
`array<Action>` - The cached prepared actions.

### Example
```php
$actions = $component->getExtraActions();
```
```

--------------------------------

### streamlined() setter method

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Setter method for the streamlined property. Accepts a boolean or Closure, defaults to true, and returns static for fluent chaining.

```php
public function streamlined(bool | Closure $condition = true): static
```

--------------------------------

### align()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Sets the alignment of the header. Accepts a string, Closure, or Alignment enum value.

```php
public function align(string | Closure | Alignment $align): static
```

--------------------------------

### cacheExtraActions() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Defines the cacheExtraActions() method that returns an array of Action objects.

```php
/**
 * @return array<Action>
 */
public function cacheExtraActions(): array
```

--------------------------------

### getEmptyLabel() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Defines the getEmptyLabel() method that returns a string, bool, or null.

```php
public function getEmptyLabel(): string | bool | null
```

--------------------------------

### isStreamlined() getter method

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Getter method that returns whether the streamlined appearance is enabled. It evaluates the stored value and defaults to false.

```php
public function isStreamlined(): bool
```

--------------------------------

### getLabel()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Returns the label for the header, evaluating closures if set, otherwise title-cases the name.

```APIDOC
## getLabel()

### Description
Returns the label for the header, evaluating closures if set, otherwise title-cases the name.

### Method
`public function getLabel(): string | Htmlable`

### Parameters
None.

### Return
`string | Htmlable` — the label if set (closures evaluated), otherwise the title-cased `$name` (e.g. `'name'` → `'Name'`).
```

--------------------------------

### cacheExtraActions()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Resets the cache, evaluates every registered action (wrapping closure results with `Arr::wrap`), and keys the resulting map by `$action->getName()`. Each action is normalized before caching.

```APIDOC
## cacheExtraActions(): array<Action>

### Description
Resets the cache, evaluates every registered action (wrapping closure results with `Arr::wrap`), and keys the resulting map by `$action->getName()`. Each action is normalized before caching.

### Method
cacheExtraActions

### Returns
`array<Action>` - The cached prepared actions.

### Example
```php
$actions = $component->cacheExtraActions();
```
```

--------------------------------

### showLabels(bool|Closure|null $condition = true)

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Show labels on child fields. Accepts a boolean, closure, or null condition.

```APIDOC
## [PUBLIC] showLabels(bool|Closure|null $condition = true)

### Description
Show labels on child fields.

### Method
PUBLIC

### Endpoint
N/A

### Parameters
#### Query Parameters
- **$condition** (bool|Closure|null) - Required - Condition to show labels. Defaults to true.

### Request Example
```php
$field->showLabels();
```

### Response
#### Success Response (static)
- **static** - Returns the calling instance for chaining.

#### Response Example
N/A
```

--------------------------------

### renderHeader()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Controls whether the header row is visually rendered. When false, the header is hidden visually but remains accessible to assistive technology.

```APIDOC
## renderHeader()

### Description
Sets whether the header row is visually rendered. When `false`, the `<thead>` is styled `sr-only` (hidden visually, still exposed to assistive technology).

### Method
`renderHeader`

### Signature
```php
public function renderHeader(bool | Closure $condition = true): static
```

### Parameters
- **$condition** (bool | Closure) - Optional - Default: `true` - Whether the header row is visually rendered.

### Returns
`static` - Returns the component instance for chaining.

### Example
```php
TableRepeater::make('users')
    ->renderHeader(false);
```
```

--------------------------------

### extraActions() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Defines the extraActions() method that accepts an array of Action or Closure instances and returns a static instance.

```php
/**
 * @param  array<Action | Closure>  $actions
 */
public function extraActions(array $actions): static
```

--------------------------------

### Header::markAsRequired

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Marks the column as required.

```APIDOC
## Header::markAsRequired

### Description
Marks the column as required.

### Method
markAsRequired

### Parameters
None.

### Request Example
```php
Header::make('name')
    ->markAsRequired()
```

### Response
Returns the Header instance for chaining.

```

--------------------------------

### getHeaders() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Returns the evaluated headers array.

```php
public function getHeaders(): array
```

--------------------------------

### getAlignment() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Signature of the getAlignment() method. Returns a string or Alignment enum.

```php
public function getAlignment(): string | Alignment
```

--------------------------------

### getWidth() return implementation

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Returns the evaluated width or the default 'auto' when no width is set.

```php
return $this->evaluate($this->width)
    ?? 'auto';
```

--------------------------------

### HasHeader properties: $headers and $renderHeader

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Declares the protected properties that store the configured headers and the render-header flag. Both accept a plain value or a Closure for lazy evaluation.

```php
protected array | Closure | null $headers = null;

protected bool | Closure | null $renderHeader = null;
```

--------------------------------

### shouldShowLabels() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Defines the public method signature for shouldShowLabels(). Returns a boolean indicating whether labels should render.

```php
public function shouldShowLabels(): bool
```

--------------------------------

### getExtraActions() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Defines the getExtraActions() method that returns an array of Action objects.

```php
/**
 * @return array<Action>
 */
public function getExtraActions(): array
```

--------------------------------

### Import plugin stylesheet in theme CSS

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Imports the plugin's stylesheet into the custom theme's CSS file, as required for the plugin to function.

```css
@import '<path-to-vendor>/awcodes/filament-table-repeater/resources/css/plugin.css';
```

--------------------------------

### stackAt()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Sets the break point below which the table repeater rows stack vertically. Accepts a string, MaxWidth enum, or Closure.

```APIDOC
## stackAt()

### Description
Sets the break point below which the table repeater rows stack vertically. Accepts a string, MaxWidth enum, or Closure.

### Method
stackAt

### Signature
```php
public function stackAt(string | MaxWidth | Closure $stackAt): static
```

### Parameters
- **$stackAt** (string | MaxWidth | Closure) - Required - The break point below which rows stack vertically.

### Return Value
- **static** - Returns the component instance for chaining.

### Example
```php
use Awcodes\TableRepeater\Components\TableRepeater;
use Filament\Support\Enums\MaxWidth;

TableRepeater::make('users')
    ->stackAt(MaxWidth::Large)
    ->schema([/* ... */]);
```
```

--------------------------------

### ->schema()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Defines the schema (fields) for each repeater item. Inherited from Filament's Repeater.

```APIDOC
## ->schema()

### Description
Defines the schema (fields) for each repeater item. Inherited from Filament's Repeater.

### Method
`schema(array $fields)`

### Parameters
- **$fields** (array) - Required - An array of field definitions for each repeater item.

### Example
```php
->schema([
    TextInput::make('name'),
    TextInput::make('email'),
])
```
```

--------------------------------

### ->container()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Sets the component container for the repeater. Inherited from Filament's Repeater.

```APIDOC
## ->container()

### Description
Sets the component container for the repeater. Inherited from Filament's Repeater.

### Method
`container(ComponentContainer $container)`

### Parameters
- **$container** (ComponentContainer) - Required - The component container instance.

### Example
```php
->container(ComponentContainer::make(...))
```
```

--------------------------------

### isStreamlined() evaluation logic

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Implementation of isStreamlined() that evaluates the streamlined property, returning false if null.

```php
return $this->evaluate($this->streamlined) ?? false;
```

--------------------------------

### TableRepeater::stackAt

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Sets the break point at which the table renders as panels on mobile.

```APIDOC
## TableRepeater::stackAt

### Description
Sets the break point at which the table renders as panels on mobile.

### Method
stackAt

### Parameters
- **breakpoint** (MaxWidth) - Required - The breakpoint value.

### Request Example
```php
TableRepeater::make('users')
    ->stackAt(MaxWidth::Medium)
```

### Response
Returns the TableRepeater instance for chaining.

```

--------------------------------

### getView()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Returns the Blade template view name used to render the component. Always returns the package's table-repeater template.

```APIDOC
## getView()

### Description
Returns the Blade template view name used to render the component. Always returns the package's table-repeater template.

### Method
getView

### Signature
```php
public function getView(): string
```

### Parameters
None.

### Return
`string` — always `'table-repeater::components.table-repeater'`, the package's Blade template.
```

--------------------------------

### isRequired()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Returns whether the required marker should be rendered. Defaults to false if not set.

```APIDOC
## isRequired()

### Description
Returns whether the required marker should be rendered. If a closure is set for the required state, it is evaluated; otherwise, returns false.

### Method
GET

### Endpoint
N/A (PHP method)

### Parameters
None.

### Return
- **bool** - Whether the required marker should render. Defaults to false.

### Request Example
N/A

### Response
#### Success Response (200)
- **bool** - The required state.

#### Response Example
```
true
```
```

--------------------------------

### emptyLabel()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Sets the custom empty-state text for the table repeater when it has zero rows. Pass `false` to hide the empty container block entirely.

```APIDOC
## emptyLabel(bool | string | Closure | null $label = null): static

### Description
Sets the custom empty-state text for the table repeater when it has zero rows. Pass `false` to hide the empty container block entirely.

### Method
emptyLabel

### Parameters
- `$label` (bool | string | Closure | null) - Optional - Custom empty-state text, or `false` to hide the empty container block entirely.

### Returns
`static` - The component instance for chaining.

### Example
```php
use Awcodes\TableRepeater\Components\TableRepeater;

TableRepeater::make('users')
    ->emptyLabel('There are no users registered.')
    ->schema([/* ... */]);

// or hide it entirely:
TableRepeater::make('users')
    ->emptyLabel(false)
    ->schema([/* ... */]);
```
```

--------------------------------

### headers()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Sets the array of Header instances or a closure returning an array of Header instances for the table column headers.

```APIDOC
## headers()

### Description
Sets the table column headers. Accepts an array of `Awcodes\TableRepeater\Header` instances or a closure returning such an array.

### Method
`headers`

### Signature
```php
public function headers(array | Closure $headers): static
```

### Parameters
- **$headers** (array | Closure) - Required - Array of `Awcodes\TableRepeater\Header` instances (`array<Header>`), or a closure returning one.

### Returns
`static` - Returns the component instance for chaining.

### Example
```php
TableRepeater::make('users')
    ->headers([
        Header::make('name'),
        Header::make('email'),
    ]);
```
```

--------------------------------

### width()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Sets the CSS width of the header cell. Accepts a string or Closure and returns the instance for chaining.

```APIDOC
## width()

### Description
Sets the CSS width of the header cell. Accepts a string or Closure and returns the instance for chaining.

### Method
`public function width(string | Closure $width): static`

### Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `$width` | `string \| Closure` | yes | CSS width, e.g. `'150px'`. Rendered as inline `style="width: ..."` on the `<th>`. |

### Return
`static` — instance for chaining.

### Example
```php
Header::make('name')->width('150px');
```
```

--------------------------------

### getWidth()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Returns the width of the header, evaluating any closure set for the width property. Defaults to 'auto' if not set.

```APIDOC
## getWidth()

### Description
Returns the width of the header. If a closure is set for the width, it is evaluated; otherwise, returns 'auto'.

### Method
GET

### Endpoint
N/A (PHP method)

### Parameters
None.

### Return
- **string** - The width if set (closures evaluated), otherwise 'auto'.

### Request Example
N/A

### Response
#### Success Response (200)
- **string** - The width value.

#### Response Example
```
"150px"
```
```

--------------------------------

### getExtraActions() return statement

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Returns the cached extra actions, computing them if not already cached.

```php
return $this->cachedExtraActions ?? $this->cacheExtraActions();
```

--------------------------------

### shouldRenderHeader()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Determines whether the header row should be rendered, defaulting to true.

```APIDOC
## shouldRenderHeader()

### Description
Returns a boolean indicating whether the header row should be rendered. Defaults to `true` if not set.

### Method
`shouldRenderHeader`

### Signature
```php
public function shouldRenderHeader(): bool
```

### Parameters
None.

### Returns
`bool` - `true` if the header should be rendered, `false` otherwise.

### Example
```php
$shouldRender = $component->shouldRenderHeader();
```
```

--------------------------------

### getLabel() method signature

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Signature of the getLabel() method. Returns a string or Htmlable.

```php
public function getLabel(): string | Htmlable
```

--------------------------------

### TableRepeater::extraActions

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Adds extra actions below the table.

```APIDOC
## TableRepeater::extraActions

### Description
Adds extra actions below the table.

### Method
extraActions

### Parameters
- **actions** (array) - Required - An array of Action objects.

### Request Example
```php
TableRepeater::make('users')
    ->extraActions([
        Action::make('exportData')
            ->icon('heroicon-m-inbox-arrow-down')
            ->action(function (TableRepeater $component): void {
                Notification::make('export_data')
                    ->success()
                    ->title('Data exported.')
                    ->send();
            }),
    ])
```

### Response
Returns the TableRepeater instance for chaining.

```

--------------------------------

### isRequired() return value

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Returns whether the required marker should render, defaulting to false.

```php
return $this->evaluate($this->isRequired)
    ?? false;
```

--------------------------------

### extraActions()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Adds custom `Filament\Forms\Components\Actions\Action` objects that render below the table, next to (or in place of) the "Add" button. Accepts `Action` instances or closures returning an `Action`/array of actions.

```APIDOC
## extraActions(array $actions): static

### Description
Adds custom `Filament\Forms\Components\Actions\Action` objects that render below the table, next to (or in place of) the "Add" button. Accepts `Action` instances or closures returning an `Action`/array of actions.

### Method
extraActions

### Parameters
- `$actions` (array<Action | Closure>) - Required - `Action` instances, or closures returning an `Action`/array of actions. Values are merged with any previously set actions (`...` spread).

### Returns
`static` - The component instance for chaining.

### Example
```php
use Awcodes\TableRepeater\Components\TableRepeater;
use Filament\Forms\Components\Actions\Action;
use Filament\Notifications\Notification;

TableRepeater::make('users')
    ->extraActions([
        Action::make('exportData')
            ->icon('heroicon-m-inbox-arrow-down')
            ->action(function (TableRepeater $component): void {
                Notification::make('export_data')
                    ->success()
                    ->title('Data exported.')
                    ->send();
            }),
    ])
    ->schema([/* ... */]);
```
```

--------------------------------

### Property: $stackAt

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Defines the stackAt property that accepts a string, MaxWidth enum, or Closure, or null. It determines the break point below which rows stack vertically.

```php
protected string | MaxWidth | Closure | null $stackAt = null;
```

--------------------------------

### Auto-discovery registration in composer.json

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeaterServiceProvider.md

Registers the TableRepeaterServiceProvider for auto-discovery in Laravel. This is the only registration step required; no manual registration in config/app.php is needed.

```json
"extra": {
    "laravel": {
        "providers": [
            "Awcodes\\TableRepeater\\TableRepeaterServiceProvider"
        ]
    }
}
```

--------------------------------

### TableRepeater::streamlined

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Changes the appearance of the table to be more inline.

```APIDOC
## TableRepeater::streamlined

### Description
Changes the appearance of the table to be more inline.

### Method
streamlined

### Parameters
None.

### Request Example
```php
TableRepeater::make('users')
    ->streamlined()
```

### Response
Returns the TableRepeater instance for chaining.

```

--------------------------------

### Streamlined property declaration

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Declares the property that controls the streamlined appearance. It can be a boolean, a Closure, or null, defaulting to null.

```php
protected bool | Closure | null $streamlined = null;
```

--------------------------------

### getEmptyLabel() return statement

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Returns the evaluated empty label value.

```php
return $this->evaluate($this->emptyLabel);
```

--------------------------------

### getHeaders()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Retrieves the evaluated headers array, defaulting to an empty array if not set.

```APIDOC
## getHeaders()

### Description
Returns the evaluated headers array. If no headers are set, returns an empty array.

### Method
`getHeaders`

### Signature
```php
public function getHeaders(): array
```

### Parameters
None.

### Returns
`array` - The array of `Header` instances, or `[]` if not set.

### Example
```php
$headers = $component->getHeaders();
```
```

--------------------------------

### getChildComponents()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Returns child components with labels hidden unless showLabels() is called.

```APIDOC
## [PUBLIC] getChildComponents()

### Description
Child components with labels hidden unless `showLabels()` is called.

### Method
PUBLIC

### Endpoint
N/A

### Parameters
None

### Request Example
N/A

### Response
#### Success Response (array)
- **array** - Array of child components.

#### Response Example
N/A
```

--------------------------------

### CanBeStreamlined::streamlined()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Enables or disables the streamlined appearance for the table repeater. Accepts a boolean or a closure that evaluates to a boolean.

```APIDOC
## [SETTER] streamlined()

### Description
Sets whether the table repeater uses a streamlined (borderless, inline-looking) appearance.

### Method
Setter method on the `CanBeStreamlined` trait.

### Parameters
- `$condition` (bool | Closure) - Optional - Default: `true` - Whether the streamlined appearance is enabled.

### Returns
`static` - The current instance for fluent chaining.

### Example
```php
TableRepeater::make('users')
    ->streamlined()
    ->headers([/* ... */])
    ->schema([/* ... */]);
```
```

--------------------------------

### TableRepeater::headers

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Sets the table headers for the repeater.

```APIDOC
## TableRepeater::headers

### Description
Sets the table headers for the repeater.

### Method
headers

### Parameters
- **headers** (array) - Required - An array of Header components.

### Request Example
```php
TableRepeater::make('users')
    ->headers([
        Header::make('name'),
        Header::make('email'),
    ])
```

### Response
Returns the TableRepeater instance for chaining.

```

--------------------------------

### Add plugin views to tailwind.config.js content

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Adds the plugin's Blade views to the `content` array in `tailwind.config.js` so Tailwind can process them.

```js
content: [
    '<path-to-vendor>/awcodes/filament-table-repeater/resources/**/*.blade.php',
]
```

--------------------------------

### Protected property $showLabels

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Declares the protected property `$showLabels` with a type of `bool | Closure | null`. Gated by `shouldShowLabels()`, defaults to `false`, hiding all child field labels.

```php
protected bool | Closure | null $showLabels = null;
```

--------------------------------

### ->defaultItems()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Sets the default number of repeater items. Inherited from Filament's Repeater.

```APIDOC
## ->defaultItems()

### Description
Sets the default number of repeater items. Inherited from Filament's Repeater.

### Method
`defaultItems(int $count)`

### Parameters
- **$count** (int) - Required - The default number of items.

### Example
```php
->defaultItems(0)
```
```

--------------------------------

### TableRepeater::renderHeader

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Controls whether the table header is rendered.

```APIDOC
## TableRepeater::renderHeader

### Description
Controls whether the table header is rendered.

### Method
renderHeader

### Parameters
- **bool** (boolean) - Required - Set to false to hide the header.

### Request Example
```php
TableRepeater::make('users')
    ->renderHeader(false)
```

### Response
Returns the TableRepeater instance for chaining.

```

--------------------------------

### markAsRequired()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Header.md

Controls whether the header shows a required asterisk marker. Accepts a boolean, Closure, or null and returns the instance for chaining.

```APIDOC
## markAsRequired()

### Description
Controls whether the header shows a required asterisk marker. Accepts a boolean, Closure, or null and returns the instance for chaining.

### Method
`public function markAsRequired(bool | Closure | null $condition = true): static`

### Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| `$condition` | `bool \| Closure \| null` | `true` | Whether the header shows a required `*` marker. `null` behaves like not calling the method (resolves to `false`). |

### Return
`static` — instance for chaining.

### Example
```php
Header::make('name')->markAsRequired();
```
```

--------------------------------

### TableRepeater::emptyLabel

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/README.md

Customizes the text shown when the table is empty.

```APIDOC
## TableRepeater::emptyLabel

### Description
Customizes the text shown when the table is empty.

### Method
emptyLabel

### Parameters
- **label** (string|false) - Required - The label text, or false to hide it.

### Request Example
```php
TableRepeater::make('users')
    ->emptyLabel('There are no users registered.')
```

### Response
Returns the TableRepeater instance for chaining.

```

--------------------------------

### ->extraItemActions()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/TableRepeater.md

Adds extra actions to each repeater item. Inherited from Filament's Repeater.

```APIDOC
## ->extraItemActions()

### Description
Adds extra actions to each repeater item. Inherited from Filament's Repeater.

### Method
`extraItemActions(array $actions)`

### Parameters
- **$actions** (array) - Required - An array of action objects.

### Example
```php
->extraItemActions([
    Action::make('duplicate'),
])
```
```

--------------------------------

### CanBeStreamlined::isStreamlined()

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Returns whether the streamlined appearance is enabled. Evaluates the stored value, which may be a closure, and defaults to false.

```APIDOC
## [GETTER] isStreamlined()

### Description
Returns whether the streamlined appearance is enabled.

### Method
Getter method on the `CanBeStreamlined` trait.

### Parameters
None.

### Returns
`bool` - `true` if streamlined is enabled, `false` otherwise.

### Example
```php
$isStreamlined = $component->isStreamlined();
```
```

--------------------------------

### HasEmptyLabel property declaration

Source: https://github.com/awcodes/filament-table-repeater/blob/3.x/_autodocs/api-reference/Concerns.md

Declares the protected property for the empty label, which can be a string, boolean, Closure, or null.

```php
protected string | bool | Closure | null $emptyLabel = null;
```
Tokens:
Raw