Merge pull request #14 from alejandrodiazpinilla/main

[1.x] new funtion fromData

Author: rmunate

README.md

@@ -395,7 +395,42 @@ In the HTML, you should have a structure similar to the one below. Make sure tha
     </thead>
 </table>
 ```
-
+## With Data Preparated
+You can send data from a array or a collection to the front, for example:
+```php
+Array:1 [
+  0 => array:41 [
+    "status" => "A"
+    "name" => "JOHN ALEJANDRO DIAZ PINILLA"
+    "born_day" => "1993-11-30"
+    "scheduler" => "Sheduler 235 Hour"
+  ]
+]
+
+Collection {
+    0 => array:41 [
+      "status" => "A"
+      "name" => "CARLOS GIOVANNY RODRIGUEZ TRIVIÑO"
+      "born_day" => "1992-10-19"
+      "scheduler" => "Scheduler 235 Hour"
+    ]
+}
+```
+For the send to the front, you must use the method fromData(), and put the array or the collection in the parameters.
+```php
+    $dataTable = new EasyDataTable();
+    /* The array or collection of data must be sent to the method. */
+    $dataTable->fromData($plantaActiva); /* Mandatory / Required */
+    $dataTable->map(function ($row) {
+        return [
+            "status" => $row->status,
+            "name" => $row->name,
+            "born_day" => $row->born_day,
+            "scheduler" => $row->scheduler,
+        ];
+    });
+```
+this method work like the clientSide method, in this way the javascript is the same than the clientSide.
 ## Creator
 - 🇨🇴 Raúl Mauricio Uñate Castro
 - Email: [email protected]

README_SPANISH.md

@@ -395,7 +395,42 @@ En el HTML deberás contar con una estructura similar a la siguiente. Asegúrate
     </thead>
 </table>
 ```
-
+## Data Preparada
+Puedes enviar la data ya preparada como un arreglo o como una colección de datos, como los ejemplos a continuación:
+```php
+Array:1 [
+  0 => array:41 [
+    "estado" => "A"
+    "nombre" => "JOHN ALEJANDRO DIAZ PINILLA"
+    "fecha_nacimiento" => "1993-11-30"
+    "jornada" => "JORNADA 235 HORAS"
+  ]
+]
+
+Collection {
+    0 => array:41 [
+      "estado" => "A"
+      "nombre" => "CARLOS GIOVANNY RODRIGUEZ TRIVIÑO"
+      "fecha_nacimiento" => "1992-10-19"
+      "jornada" => "JORNADA 235 HORAS"
+    ]
+}
+```
+Para el envió al front podrás utilizarlo de la siguiente manera en el controlador:
+```php
+    $dataTable = new EasyDataTable();
+    /* Al metodo se debe enviar el arreglo o la coleccion de datos */
+    $dataTable->fromData($plantaActiva); /* Obligatorio / Requerido */
+    $dataTable->map(function ($row) {
+        return [
+            "estado" => $row->estado,
+            "nombre" => $row->nombre,
+            "fecha_nacimiento" => $row->fecha_nacimiento,
+            "jornada" => $row->jornada,
+        ];
+    });
+```
+Este método funcionar como un clientSide, por este motivo la forma de implementarlo en el javascript será la misma.
 ## Creador
 - 🇨🇴 Raúl Mauricio Uñate Castro
 - Correo electrónico: [email protected]

src/EasyDataTable.php

@@ -22,6 +22,7 @@ class EasyDataTable extends EasyDataTableBase
     private $search;
     private $serverSide;
     private $clientSide;
+    private $data;
 
     /**
      * Create a new EasyDataTable instance.
@@ -88,6 +89,21 @@ public function query(Builder $query)
         return $this;
     }
 
+    /**
+     * Set the array or a collection for the EasyDataTable.
+     *
+     * @param iterable $data
+     *
+     * @return $this
+     */
+    public function fromData(iterable $data)
+    {
+        $this->clientSide();
+        $this->data = $data;
+
+        return $this;
+    }
+
     /**
      * Set the map closure for the EasyDataTable.
      *
@@ -147,11 +163,11 @@ public function response()
      */
     private function dataClientSide()
     {
-        $rows = $this->query->get();
+        $rows = is_iterable($this->data) ? $this->data : $this->query->get();
 
         $data = [];
         foreach ($rows as $r) {
-            $item = !empty($this->map) ? ($this->map)($r) : $r;
+            $item = !empty($this->map) ? ($this->map)((object) $r) : $r;
             $data[] = $item;
         }