Button group columns

Author: rappasoft

CHANGELOG.md

@@ -7,6 +7,7 @@ All notable changes to `laravel-livewire-tables` will be documented in this file
 ### Added
 
 - Added functionality to display BooleanColumn as Yes/No instead of icons.
+- Added ButtonGroupColumn for multiple LinkColumns in one group. Pretty much built in action buttons support.
 
 ## [2.5.0] - 2022-05-03
 

docs/columns/other-column-types.md

@@ -126,4 +126,36 @@ LinkColumn::make('Action')
         'class' => 'rounded-full',
         'alt' => $row->name . ' Avatar',
     ]),
+```
+
+## Button Group Columns
+
+Button group columns let you provide an array of LinkColumns to display in a single cell.
+
+```php
+ButtonGroupColumn::make('Actions')
+    ->attributes(function($row) {
+        return [
+            'class' => 'space-x-2',
+        ];
+    })
+    ->buttons([
+        LinkColumn::make('View')
+            ->title(fn($row) => 'View ' . $row->name)
+            ->location(fn($row) => route('user.show', $row)),
+            ->attributes(function($row) {
+                return [
+                    'class' => 'underline text-blue-500 hover:no-underline',
+                ];
+            }),
+        LinkColumn::make('Edit ' . $row->name)
+            ->title(fn($row) => 'Edit')
+            ->location(fn($row) => route('user.edit', $row)),
+            ->attributes(function($row) {
+                return [
+                    'target' => '_blank',
+                    'class' => 'underline text-blue-500 hover:no-underline',
+                ];
+            }),
+    ]),
 ```

resources/views/includes/columns/button-group.blade.php

@@ -0,0 +1,5 @@
+<div {!! count($attributes) ? $column->arrayToAttributes($attributes) : '' !!}>
+    @foreach($buttons as $button)
+        {!! $button->getContents($row) !!}
+    @endforeach
+</div>

src/Views/Columns/ButtonGroupColumn.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Rappasoft\LaravelLivewireTables\Views\Columns;
+
+use Illuminate\Database\Eloquent\Model;
+use Rappasoft\LaravelLivewireTables\Views\Column;
+use Rappasoft\LaravelLivewireTables\Views\Traits\Configuration\ButtonGroupColumnConfiguration;
+use Rappasoft\LaravelLivewireTables\Views\Traits\Helpers\ButtonGroupColumnHelpers;
+
+class ButtonGroupColumn extends Column
+{
+    use ButtonGroupColumnConfiguration,
+        ButtonGroupColumnHelpers;
+
+    protected array $buttons = [];
+    protected string $view = 'livewire-tables::includes.columns.button-group';
+    protected $attributesCallback;
+
+    public function __construct(string $title, string $from = null)
+    {
+        parent::__construct($title, $from);
+
+        $this->label(fn () => null);
+    }
+
+    public function getContents(Model $row)
+    {
+        return view($this->getView())
+            ->withColumn($this)
+            ->withRow($row)
+            ->withButtons($this->getButtons())
+            ->withAttributes($this->hasAttributesCallback() ? app()->call($this->getAttributesCallback(), ['row' => $row]) : []);
+    }
+}

src/Views/Traits/Configuration/ButtonGroupColumnConfiguration.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Rappasoft\LaravelLivewireTables\Views\Traits\Configuration;
+
+trait ButtonGroupColumnConfiguration
+{
+    public function buttons(array $buttons): self
+    {
+        $this->buttons = $buttons;
+
+        return $this;
+    }
+
+    public function attributes(callable $callback): self
+    {
+        $this->attributesCallback = $callback;
+        
+        return $this;
+    }
+}

src/Views/Traits/Helpers/ButtonGroupColumnHelpers.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace Rappasoft\LaravelLivewireTables\Views\Traits\Helpers;
+
+use Rappasoft\LaravelLivewireTables\Views\Columns\LinkColumn;
+
+trait ButtonGroupColumnHelpers
+{
+    public function getView(): string
+    {
+        return $this->view;
+    }
+
+    public function getButtons(): array
+    {
+        return collect($this->buttons)
+            ->reject(fn($button) => ! $button instanceof LinkColumn)
+            ->toArray();
+    }
+
+    public function getAttributesCallback()
+    {
+        return $this->attributesCallback;
+    }
+
+    public function hasAttributesCallback()
+    {
+        return $this->attributesCallback !== null;
+    }
+}