Merge pull request #2951 from Laravel-Backpack/add-fluent-field-group

Add fluent field group

src/app/Library/CrudPanel/CrudField.php

@@ -365,6 +365,7 @@ public function getAttributes()
     {
         return $this->attributes;
     }
+
     // ---------------
     // PRIVATE METHODS
     // ---------------

src/app/Library/CrudPanel/CrudObjectGroup.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Backpack\CRUD\app\Library\CrudPanel;
+
+class CrudObjectGroup
+{
+    protected $objects;
+
+    /**
+     * Add CrudObjects (fields, columns etc) to the group.
+     */
+    public function __construct(...$objects)
+    {
+        if (is_array($objects[0])) {
+            $objects = $objects[0];
+        }
+
+        $this->objects = $objects;
+    }
+
+    // -------------
+    // MAGIC METHODS
+    // -------------
+
+    /**
+     * We forward any call to the corresponding class passed by developer (Field, Columns, Filters etc ..).
+     */
+    public function __call(string $method, array $parameter)
+    {
+        foreach ($this->objects as $object) {
+            $object->{$method}($parameter[0]);
+        }
+
+        return $this;
+    }
+}

src/app/Library/CrudPanel/CrudPanel.php

@@ -518,4 +518,19 @@ private function getRelatedEntries($model, $relationString)
 
         return $results;
     }
+
+    /**
+     * Allow to add an attribute to multiple fields/columns/filters/buttons at same time.
+     *
+     * Using the fluent syntax allow the developer to add attributes to multiple fields at the same time. Eg:
+     *
+     * - CRUD::group(CRUD::field('price')->type('number'), CRUD::field('title')->type('text'))->tab('both_on_same_tab');
+     *
+     * @param  mixed fluent syntax objects.
+     * @return CrudObjectGroup
+     */
+    public function group(...$objects)
+    {
+        return new CrudObjectGroup(...$objects);
+    }
 }

tests/Unit/CrudPanel/CrudPanelObjectGroupTest.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Backpack\CRUD\Tests\Unit\CrudPanel;
+
+/**
+ * @covers Backpack\CRUD\app\Library\CrudPanel\CrudObjectGroup
+ */
+class CrudPanelObjectGroupTest extends \Backpack\CRUD\Tests\config\CrudPanel\BaseCrudPanel
+{
+    public function testItCanCreateAGroupOfCrudObjects()
+    {
+        $this->crudPanel->group(
+            $this->crudPanel->field('test'),
+            $this->crudPanel->field('test2')
+        )->label('testing');
+
+        $this->assertEquals('testing', $this->crudPanel->fields()['test']['label']);
+        $this->assertEquals('testing', $this->crudPanel->fields()['test2']['label']);
+    }
+
+    public function testItCanCreateAGroupOfCrudObjectsFromArrayInput()
+    {
+        $this->crudPanel->group([
+            $this->crudPanel->field('test'),
+            $this->crudPanel->field('test2'),
+        ])->label('testing');
+
+        $this->assertEquals('testing', $this->crudPanel->fields()['test']['label']);
+        $this->assertEquals('testing', $this->crudPanel->fields()['test2']['label']);
+    }
+}