feat(datatables): add tooltip support and custom button helper

Add tooltip functionality to datatable buttons with conditional rendering to avoid empty title attributes. Introduce custom() static helper method for simplified button creation with icon, tooltip, color and attributes support. The method intelligently handles empty icons to prevent unnecessary HTML generation.

Include comprehensive test suite with 8 tests covering tooltip rendering, method chaining, custom button creation with various parameter combinations, and argument order validation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: sebastienheyd

src/Datatables/Button.php

@@ -10,6 +10,7 @@ class Button
     protected string $icon = '';
     protected string $label = '';
     protected array $attributes = [];
+    protected string $tooltip = '';
 
     /**
      * Instanciate a new button.
@@ -32,6 +33,28 @@ public static function add(string $label = ''): self
         return new static($label);
     }
 
+    /**
+     * Returns a custom button.
+     *
+     * @param  string  $route
+     * @param  array|string  $args
+     * @param  string  $icon
+     * @param  string  $tooltip
+     * @param  string  $color
+     * @param  array  $attributes
+     * @return string
+     */
+    public static function custom(string $route, array|string $args = [], string $icon = '', string $tooltip = '', string $color = 'default', array $attributes = []): string
+    {
+        $button = self::add()->route($route, $args)->tooltip($tooltip);
+
+        if (! empty($icon)) {
+            $button->icon($icon);
+        }
+
+        return $button->color($color)->attributes($attributes)->make();
+    }
+
     /**
      * Returns an edit button.
      *
@@ -168,8 +191,6 @@ public function link(string $href): self
      */
     public function make(): string
     {
-        $str = '<a href="%s" class="btn btn-sm btn-%s ml-1%s" %s>%s%s</a>';
-
         if (! empty($this->label) && ! empty($this->icon)) {
             $this->label = $this->label.' ';
         }
@@ -182,6 +203,22 @@ public function make(): string
             return sprintf('%s="%s"', $k, $this->attributes[$k]);
         }, array_keys($this->attributes)));
 
-        return sprintf($str, $this->href, $this->color, $this->class, $attributes, $this->label, $this->icon);
+        $tooltip = ! empty($this->tooltip) ? sprintf(' title="%s"', $this->tooltip) : '';
+        $str = '<a href="%s"%s class="btn btn-sm btn-%s ml-1%s" %s>%s%s</a>';
+
+        return sprintf($str, $this->href, $tooltip, $this->color, $this->class, $attributes, $this->label, $this->icon);
+    }
+
+    /**
+     * Sets tooltip of button.
+     *
+     * @param  string  $tooltip
+     * @return $this
+     */
+    public function tooltip(string $tooltip): self
+    {
+        $this->tooltip = $tooltip;
+
+        return $this;
     }
 }

tests/Datatables/ButtonTest.php

@@ -0,0 +1,128 @@
+<?php
+
+namespace Sebastienheyd\Boilerplate\Tests\Datatables;
+
+use Sebastienheyd\Boilerplate\Datatables\Button;
+use Sebastienheyd\Boilerplate\Tests\TestCase;
+
+class ButtonTest extends TestCase
+{
+    public function testTooltipMethod()
+    {
+        $button = Button::add('Test Button')
+            ->link('/test')
+            ->tooltip('This is a tooltip')
+            ->make();
+
+        $this->assertStringContainsString('title="This is a tooltip"', $button);
+    }
+
+    public function testTooltipNotAddedWhenEmpty()
+    {
+        $button = Button::add('Test Button')
+            ->link('/test')
+            ->make();
+
+        $this->assertStringNotContainsString('title=', $button);
+    }
+
+    public function testTooltipMethodChaining()
+    {
+        $button = Button::add('Test')
+            ->link('/test')
+            ->tooltip('Tooltip text')
+            ->color('primary')
+            ->icon('star')
+            ->make();
+
+        $this->assertStringContainsString('title="Tooltip text"', $button);
+        $this->assertStringContainsString('btn-primary', $button);
+        $this->assertStringContainsString('fa-star', $button);
+    }
+
+    public function testButtonHtmlStructure()
+    {
+        $button = Button::add('Click me')
+            ->link('/action')
+            ->tooltip('Button tooltip')
+            ->color('success')
+            ->make();
+
+        $this->assertMatchesRegularExpression('/<a href="\/action" title="Button tooltip" class="btn btn-sm btn-success/', $button);
+    }
+
+    public function testCustomButtonWithRoute()
+    {
+        // Define a test route
+        $this->app['router']->get('/test/{id}', function () {
+            return 'test';
+        })->name('test.route');
+
+        $button = Button::custom(
+            'test.route',
+            ['id' => 1],
+            'star',
+            'Custom tooltip',
+            'success'
+        );
+
+        $this->assertStringContainsString('title="Custom tooltip"', $button);
+        $this->assertStringContainsString('btn-success', $button);
+        $this->assertStringContainsString('fa-star', $button);
+        $this->assertStringContainsString('/test/1', $button);
+    }
+
+    public function testCustomButtonWithAttributes()
+    {
+        $this->app['router']->get('/test', function () {
+            return 'test';
+        })->name('test.route2');
+
+        $button = Button::custom(
+            'test.route2',
+            [],
+            'heart',
+            'Custom tooltip',
+            'primary',
+            ['data-action' => 'custom-action', 'data-id' => '123']
+        );
+
+        $this->assertStringContainsString('data-action="custom-action"', $button);
+        $this->assertStringContainsString('data-id="123"', $button);
+        $this->assertStringContainsString('btn-primary', $button);
+        $this->assertStringContainsString('fa-heart', $button);
+    }
+
+    public function testCustomButtonWithDefaults()
+    {
+        $this->app['router']->get('/default', function () {
+            return 'test';
+        })->name('test.default');
+
+        $button = Button::custom('test.default');
+
+        $this->assertStringNotContainsString('title=', $button);
+        $this->assertStringContainsString('btn-default', $button);
+        $this->assertStringNotContainsString('fa-', $button); // No icon by default
+    }
+
+    public function testCustomButtonArgumentOrder()
+    {
+        // Test that $icon comes before $tooltip in the method signature
+        $this->app['router']->get('/order', function () {
+            return 'test';
+        })->name('test.order');
+
+        $button = Button::custom(
+            'test.order',
+            [],
+            'cog',      // $icon (3rd parameter)
+            'Tooltip',  // $tooltip (4th parameter)
+            'warning'   // $color (5th parameter)
+        );
+
+        $this->assertStringContainsString('fa-cog', $button);
+        $this->assertStringContainsString('title="Tooltip"', $button);
+        $this->assertStringContainsString('btn-warning', $button);
+    }
+}