merge 5.x

Author: luanfreitasdev

README.md

@@ -1 +1 @@
-# Simple Powergrid + Bootstrap 5 simple example
+# Simple PowerGrid + Bootstrap 5 simple example

app/Livewire/UserTable.php

@@ -0,0 +1,218 @@
+<?php
+
+namespace App\Livewire;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Support\Carbon;
+use PowerComponents\LivewirePowerGrid\{Button,
+    Column,
+    Components\Rules\RuleActions,
+    Detail,
+    Exportable,
+    Facades\Filter,
+    Footer,
+    Header,
+    PowerGrid,
+    PowerGridColumns,
+    PowerGridComponent,
+    Traits\WithExport};
+
+final class UserTable extends PowerGridComponent
+{
+    use WithExport;
+
+    public array $email = [];
+
+    protected array $rules = [
+        'email.*' => ['required', 'email'],
+    ];
+
+    public function onUpdatedEditable($id, $field, $value): void
+    {
+        User::query()->find($id)->update([
+            $field => $value,
+        ]);
+    }
+
+    /*
+    |--------------------------------------------------------------------------
+    |  Features Setup
+    |--------------------------------------------------------------------------
+    | Setup Table's general features
+    |
+    */
+    public function setUp(): array
+    {
+        $this->showCheckBox();
+
+        return [
+            Exportable::make('export')
+                ->striped()
+                ->type(Exportable::TYPE_XLS, Exportable::TYPE_CSV),
+            Header::make()
+                ->showSearchInput(),
+            Footer::make()
+                ->showPerPage()
+                ->showRecordCount(),
+
+            Detail::make()
+                ->view('components.detail')
+                ->params(['name' => 'Luan'])
+                ->showCollapseIcon(),
+        ];
+    }
+
+    /*
+    |--------------------------------------------------------------------------
+    |  Datasource
+    |--------------------------------------------------------------------------
+    | Provides data to your Table using a Model or Collection
+    |
+    */
+
+    /**
+     * PowerGrid datasource.
+     *
+     * @return Builder<\App\Models\User>
+     */
+    public function datasource(): Builder
+    {
+        return User::query();
+    }
+
+    /*
+    |--------------------------------------------------------------------------
+    |  Add Column
+    |--------------------------------------------------------------------------
+    | Make Datasource fields available to be used as columns.
+    | You can pass a closure to transform/modify the data.
+    |
+    | ❗ IMPORTANT: When using closures, you must escape any value coming from
+    |    the database using the `e()` Laravel Helper function.
+    |
+    */
+    public function addColumns(): PowerGridColumns
+    {
+        return PowerGrid::columns()
+            ->addColumn('id')
+            ->addColumn('name')
+
+           /** Example of custom column using a closure **/
+            ->addColumn('name_lower', function (User $model) {
+                return strtolower(e($model->name));
+            })
+
+            ->addColumn('email')
+            ->addColumn('created_at_formatted', fn (User $model) => Carbon::parse($model->created_at)->format('d/m/Y H:i:s'));
+    }
+
+    /*
+    |--------------------------------------------------------------------------
+    |  Include Columns
+    |--------------------------------------------------------------------------
+    | Include the columns added columns, making them visible on the Table.
+    | Each column can be configured with properties, filters, actions...
+    |
+    */
+
+     /**
+      * PowerGrid Columns.
+      *
+      * @return array<int, Column>
+      */
+    public function columns(): array
+    {
+        return [
+            Column::make('Id', 'id'),
+            Column::make('Full Name', 'name')
+                ->sortable()
+                ->searchable(),
+
+            Column::make('Email', 'email')
+                ->sortable()
+                ->editOnClick(true)
+                ->searchable(),
+
+            Column::make('CREATED AT', 'created_at_formatted', 'created_at')
+                ->searchable()
+                ->sortable(),
+
+            Column::make('UPDATED AT', 'updated_at_formatted', 'updated_at')
+                ->searchable()
+                ->sortable(),
+
+        ];
+    }
+
+    /**
+     * PowerGrid Filters.
+     *
+     * @return array<int, Filter>
+     */
+    public function filters(): array
+    {
+        return [
+            Filter::inputText('name'),
+            Filter::inputText('email'),
+            Filter::datetimepicker('created_at', 'created_at'),
+        ];
+    }
+
+    /*
+    |--------------------------------------------------------------------------
+    | Actions Method
+    |--------------------------------------------------------------------------
+    | Enable the method below only if the Routes below are defined in your app.
+    |
+    */
+
+    /**
+     * PowerGrid User Action Buttons.
+     *
+     * @return array<int, Button>
+     */
+
+    /*
+    public function actions(): array
+    {
+       return [
+           Button::make('edit', 'Edit')
+               ->class('bg-indigo-500 cursor-pointer text-white px-3 py-2.5 m-1 rounded text-sm')
+               ->route('user.edit', ['user' => 'id']),
+
+           Button::make('destroy', 'Delete')
+               ->class('bg-red-500 cursor-pointer text-white px-3 py-2 m-1 rounded text-sm')
+               ->route('user.destroy', ['user' => 'id'])
+               ->method('delete')
+        ];
+    }
+    */
+
+    /*
+    |--------------------------------------------------------------------------
+    | Actions Rules
+    |--------------------------------------------------------------------------
+    | Enable the method below to configure Rules for your Table and Action Buttons.
+    |
+    */
+
+    /**
+     * PowerGrid User Action Rules.
+     *
+     * @return array<int, RuleActions>
+     */
+
+    /*
+    public function actionRules(): array
+    {
+       return [
+
+           //Hide button edit for ID 1
+            Rule::button('edit')
+                ->when(fn($user) => $user->id === 1)
+                ->hide(),
+        ];
+    }
+    */
+}

composer.json

@@ -65,6 +65,6 @@
             "php-http/discovery": true
         }
     },
-    "minimum-stability": "stable",
+    "minimum-stability": "dev",
     "prefer-stable": true
 }