feat: thead class builder

fix: #169
fix: yajra/laravel-datatables#2706

Author: yajra

src/Html/Builder.php

@@ -198,13 +198,18 @@ public function table(array $attributes = [], bool $drawFooter = false, bool $dr
         $htmlAttr = $this->html->attributes($this->tableAttributes);
 
         $tableHtml = '<table'.$htmlAttr.'>';
-        $searchHtml = $drawSearch ? '<tr class="search-filter">'.implode('',
-                $this->compileTableSearchHeaders()).'</tr>' : '';
-        $tableHtml .= '<thead><tr>'.implode('', $th).'</tr>'.$searchHtml.'</thead>';
+        $searchHtml = $drawSearch
+                ? '<tr class="search-filter">'.implode('', $this->compileTableSearchHeaders()).'</tr>'
+                : '';
+
+        $tableHtml .= '<thead'.($this->theadClass ?? '').'>';
+        $tableHtml .= '<tr>'.implode('', $th).'</tr>'.$searchHtml.'</thead>';
+
         if ($drawFooter) {
             $tf = $this->compileTableFooter();
             $tableHtml .= '<tfoot><tr>'.implode('', $tf).'</tr></tfoot>';
         }
+
         $tableHtml .= '</table>';
 
         return new HtmlString($tableHtml);

src/Html/HasTable.php

@@ -6,16 +6,7 @@
 
 trait HasTable
 {
-    /**
-     * Retrieves HTML table attribute value.
-     *
-     * @param  string  $attribute
-     * @return string
-     */
-    public function getTableAttribute(string $attribute): string
-    {
-        return $this->tableAttributes[$attribute] ?? '';
-    }
+    protected ?string $theadClass = null;
 
     /**
      * Get table computed table attributes.
@@ -38,16 +29,6 @@ public function setTableId(string $id): static
         return $this->setTableAttribute('id', $id);
     }
 
-    /**
-     * Get HTML table "id" attribute.
-     *
-     * @return string
-     */
-    public function getTableId(): string
-    {
-        return $this->getTableAttribute('id');
-    }
-
     /**
      * Sets HTML table attribute(s).
      *
@@ -81,6 +62,27 @@ public function setTableAttributes(array $attributes): static
         return $this;
     }
 
+    /**
+     * Get HTML table "id" attribute.
+     *
+     * @return string
+     */
+    public function getTableId(): string
+    {
+        return $this->getTableAttribute('id');
+    }
+
+    /**
+     * Retrieves HTML table attribute value.
+     *
+     * @param  string  $attribute
+     * @return string
+     */
+    public function getTableAttribute(string $attribute): string
+    {
+        return $this->tableAttributes[$attribute] ?? '';
+    }
+
     /**
      * Add class names to the "class" attribute of HTML table.
      *
@@ -98,6 +100,19 @@ public function addTableClass(array|string $class): static
         return $this->setTableAttribute('class', $class);
     }
 
+    /**
+     * Set table > thead class names.
+     *
+     * @param  string  $class
+     * @return $this
+     */
+    public function setTableHeadClass(string $class): static
+    {
+        $this->theadClass = " class=\"$class\"";
+
+        return $this;
+    }
+
     /**
      * Remove class names from the "class" attribute of HTML table.
      *

tests/BuilderTest.php

@@ -15,15 +15,15 @@ class BuilderTest extends TestCase
      public function it_can_get_script_default_type_attribute()
      {
          $html = $this->getHtmlBuilder()->scripts()->toHtml();
- 
+
          $this->assertStringContainsString('type="text/javascript"', $html);
      }
 
     /** @test */
      public function it_can_set_script_type_attribute()
      {
         $html = $this->getHtmlBuilder()->scripts(attributes: ['type' => 'module'])->toHtml();
- 
+
         $this->assertStringContainsString('type="module"', $html);
      }
 
@@ -267,6 +267,9 @@ public function it_has_table_options()
 
         $this->assertInstanceOf(HtmlString::class, $builder->table());
         $this->assertEquals('<table class="table" id="my-table"><thead><tr></tr></thead></table>', $builder->table()->toHtml());
+
+        $builder->setTableHeadClass('thead-dark');
+        $this->assertEquals('<table class="table" id="my-table"><thead class="thead-dark"><tr></tr></thead></table>', $builder->table()->toHtml());
     }
 
     /** @test */