Row Action Buttons

Row Action buttons can be configured inside actions() method, for each row or header() method.

Usage

To add a button, include a new Button::add(string $action) in the actions() or header() method.

Next, place your Button::add(string $action) code inside the method's return [] statement.

Then, configure this Button by chaining Button methods to it.

Example:

//..
public function header(): array
{
    return [
        Button::add('new-modal')
            ->caption('New window')
            ->class('bg-gray-300')
            ->openModal('new', []),
            
        //...
    ];
}

The example above generates a gray button. When clicked, this button opens a new modal window.

Button Methods

The methods below can be chained to the PowerComponents\LivewirePowerGrid\Button class.

add

Creates a new button.

Parameter	Description
(string) $action	internal name of this button

Example:

//..
Button::add('create-dish')

caption

Sets the button label.

Parameter	Description
(string) $caption	button caption

Example:

//..
Button::add('create-dish')  
    ->caption('Create a dish')

class

Sets the button CSS class attribute.

Parameter	Description
(string) $classAttr	HTML class value

Example:

//..
Button::add('create-dish')  
    ->caption('Create a dish')
    ->class('bg-indigo-500 text-white')

emit

Emit works with event listeners.

Parameter	Description
(string) $event	Name of event
(array) $params	Parameters

TIP

Read more about Eventsopen in new window in the Livewire documentation.

The code below:

//...
Button::add('create-dish')  
    ->caption('Create a dish')
    ->class('bg-indigo-500 text-white')
    ->emit('postAdded', ['key' => 'id']),

is equivalent to:

<div>
    <button wire:click="$emit('postAdded', ['key' => 1])">
</div>

emitTo

Emit works with event listeners.

Parameter	Description
(string) $to	Component name
(string) $event	Name of event
(array) $params	Parameters

TIP

Read more about Eventsopen in new window in the Livewire documentation.

The code below:

//...
Button::add('view')
    ->caption('View')
    ->class('btn btn-primary')
    ->emitTo('admin-component','postAdded', ['key' => 'id']),

is equivalent to:

<div>
    <button wire:click="$emitTo('admin-component', 'postAdded', ['key' => 1])">
</div>

dispatch

Dispatch browser events.

Parameter	Description
(string) $event	Name of event
(array) $params	Parameters

TIP

Read more about Eventsopen in new window in the Livewire documentation.

The code below:

//...
Button::add('view')
    ->caption('View')
    ->class('btn btn-primary')
    ->dispatch('eventName', ['key' => 'id']),

is equivalent to:

<div>
    <button x-on:click="$dispatch('eventName', ['key' => 1])">
</div>

openModal

Opens a modal window with wire-elements/modal packages

Parameter	Description
(string) $component	You must pass the `View` of Livewire Modal component.
(array) $params	This is the component parameter.

WARNING

You must install Wire Elements Modalopen in new window to use this functionality. More information is also available at its documentation.

Example:

//...
Button::add('view')
    ->caption('View')
    ->class('btn btn-primary')
    ->openModal('view-dish', ['dish' => 'id']),

method

Sets the action's HTTP method.

Parameter	Description
(string) $method	Valid methods: `get`/`post`/`put`/`delete`

Example:

//...
Button::add('view')
    ->caption('View')
    ->class('btn btn-primary')
    ->method('delete'),

route

Sets the action's route.

Parameter	Description
(string) $route	Valid Laravel route
(string) $params	Route parameters

Example:

//...
Button::add('view')
    ->caption('View')
    ->class('btn btn-primary')
    ->route('dish.edit', ['dish' => 'id']),

target

Sets the target for the specified route.

Parameter	Default	Default
(string) $target	HTML href target	_blank

Example:

//...
Button::add('view')
    ->caption('View')
    ->class('btn btn-primary')
    ->target('_self'),

can

Sets Action's permission.

Parameter	Default	Default
(string) $can	If is `false`, the button will not be rendered.	true

Example:

$canClickButton = true; //User has permission to edit

Button::add('edit-dish')
    ->caption('Edit')
    ->route('dish.edit', ['dish' => 'id'])
    ->can($canClickButton),

Sets the button tooltip (title attribute).

Parameter
(string) $tooltip

Example:

Button::add('edit-dish')
    ->caption('Edit')
    ->route('dish.edit', ['dish' => 'id'])
    ->tooltip('Edit Record'),

toggleDetail

Toggle the detailRow

Example:

Button::add('toggle-detail')
    ->caption('Toggle Detail')
    ->toggleDetail(),

bladeComponent

Allows you to add a custom component overriding all default behavior

Parameter	Default
(string) $component	View component path (blade)
(array) $params	Blade parameters

Example:

Button::add('my-custom-button')
    ->bladeComponent('my-custom-button', ['dishId' => 'id']),

view/components/my-custom-button.blade.php

<button type="button"
        class="inline-flex items-center px-4 py-2 border border-transparent text-sm font-medium rounded-md text-indigo-700 bg-indigo-100 hover:bg-indigo-200 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500">
    My Custom Button #{{ $dishId }}
</button>

Output

<button type="button"
        class="inline-flex items-center px-4 py-2 border border-transparent text-sm font-medium rounded-md text-indigo-700 bg-indigo-100 hover:bg-indigo-200 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500">
    My Custom Button #1
</button>

id

Add custom html id attribute.

Parameter
(string) $value

The code below:

//...
Button::add('view')
    ->caption('View')
    ->class('btn btn-primary')
    ->id('view'),

is equivalent to:

<button id="view-1"> // 1 - is the value set in the current row using primaryKey = id.

Advanced usage

While the standard button methods can handle most tasks, there may be times when you need to customize the Button class to add extra functionality. Below are some examples of how to do so without interiefing with package internals.

Extending Button class

While Button class cannot be extended directly, it is possible to add methods using macrosopen in new window. Also, this class has built-in dynamicProperties variable which can be used to store custom method parameters.

The following code shows how a custom icon method can be added to Button class.

Button::macro('icon', function (string $name) {
    $this->dynamicProperties['icon'] = $name;

    return $this;
});

WARNING

Macros should only be placed in service providers.

With mentioned additions icon can be accessed as regular method.

Button::add('new-modal')
    ->caption('New window')
    ->class('bg-gray-300')
    ->icon('fa-window')
    ->openModal('new', []),

Accessing dynamic properties

In the previous section, we showed how to extend the Button class and store dynamic properties. Now, the remaining task is to utilize these dynamic properties by implementing them inside custom template.

The following example shows modified code snippet from actions.blade.phpopen in new window, which allows to display custom icons inside row button:

@if($actionClass->isButton)
    <button {{ $actionClass->getAttributes() }}>
        <i class="{{ $actionClass->getDynamicProperty('icon') }}"></i>
        {!! $actionClass->caption() !!}
    </button>
@endif

# Row Action Buttons

# Usage

# Button Methods

# add

# caption

# class

# emit

# emitTo

# dispatch

# openModal

# method

# route

# target

# can

# tooltip

# toggleDetail

# bladeComponent

# id

# Advanced usage

# Extending Button class

# Accessing dynamic properties

Row Action Buttons

Usage

Button Methods

add

caption

class

emit

emitTo

dispatch

openModal

method

route

target

can

tooltip

toggleDetail

bladeComponent

id

Advanced usage

Extending Button class

Accessing dynamic properties