Add Text Alignment

lrljoe · lrljoe · commit 5da7c6c60d46 · 2025-07-17T19:41:26.000+01:00
diff --git a/docs/columns/styling.md b/docs/columns/styling.md
@@ -308,4 +308,26 @@ public function configure(): void
 ```php
 Column::make("Name", "name")
   ->wrapText(),
-```
+```
+
+## Set Text Alignment
+
+You may customise the alignment of the text within the Column td elements as follows.  This will over-ride the value set by "setDefaultBodyTextAlignment" methods
+
+### Left
+```php
+Column::make("Name", "name")
+  ->setTextAlignLeft(),
+```
+
+### Center
+```php
+Column::make("Name", "name")
+  ->setTextAlignCenter(),
+```
+
+### Right
+```php
+Column::make("Name", "name")
+  ->setTextAlignRight(),
+```
diff --git a/docs/datatable/styling.md b/docs/datatable/styling.md
@@ -496,4 +496,21 @@ public function configure(): void
 }
 ```
 
-Keep in mind that you must only call methods from configure() once to avoid overriding or conflicting results.
+Keep in mind that you must only call methods from configure() once to avoid overriding or conflicting results.
+
+
+### Default TD Content Alignment
+
+Should you wish to default the text alignment for each td element, you may use one of the following methods:
+
+```php
+public function configure(): void
+{
+  $this->setDefaultBodyTextAlignLeft(); // Sets Default To Left
+  $this->setDefaultBodyTextAlignCenter(); // Sets Default To Center
+  $this->setDefaultBodyTextAlignRight(); // Sets Default To Right
+}
+```
+When not set, this will adhere to the parent element text alignment.
+
+You can customise this on a per-Column basis.
diff --git a/resources/views/components/table/td/td.blade.php b/resources/views/components/table/td/td.blade.php
@@ -1,24 +1,32 @@
 @aware(['isTailwind','isTailwind4','isBootstrap', 'collapsingColumnInfo', 'tableRowDetails'])
-@props(['colIndex', 'isHtml' => false, 'wrapText' => false, 'isClickable' => false, 'customAttributes' => ['default' => true, 'default-colors' => true, 'default-styling' => true]])
+@props(['colIndex', 'isHtml' => false, 'wrapText' => false, 'isClickable' => false, 'customAttributes' => ['default' => true, 'default-colors' => true, 'default-styling' => true], 'textAlign' => $this->getDefaultBodyTextAlign()])
 
 <td {{
         $attributes->merge($isClickable ? $tableRowDetails['tdAttribs'] : [])->merge($customAttributes)
             ->class([
                 'whitespace-wrap' => $wrapText && $isTailwind,
             ])
             ->class([
+                    'text-left' => $textAlign == 'left' && $isTailwind,
+                    'text-center' => $textAlign == 'center' && $isTailwind,
+                    'text-right' => $textAlign == 'right' && $isTailwind,
+
                     'whitespace-wrap' => (!$wrapText && $isHtml) && $isTailwind && ($customAttributes['default-styling'] ?? true),
                     'whitespace-nowrap' => (!$wrapText && !$isHtml) && $isTailwind && ($customAttributes['default-styling'] ?? true),
 
                     'px-6 py-4 text-sm font-medium' => $isTailwind && ($customAttributes['default-styling'] ?? true),
                     'dark:text-white' => $isTailwind && ($customAttributes['default-colors'] ?? true),
 
-
                     'cursor-pointer' => $isTailwind && ($isClickable && ($tableRowDetails['url'] !== null && ($tableRowDetails['attributes']['default'] ?? true))),
                     
                     'tw4ph whitespace-wrap' => (!$wrapText && $isHtml) && $isTailwind4 && ($customAttributes['default-styling'] ?? true),
                     'tw4ph whitespace-nowrap' => (!$wrapText && !$isHtml) && $isTailwind4 && ($customAttributes['default-styling'] ?? true),
 
+                    'tw4ph text-left' => $textAlign == 'left' && $isTailwind4,
+                    'tw4ph text-center' => $textAlign == 'center' && $isTailwind4,
+                    'tw4ph text-right' => $textAlign == 'right' && $isTailwind4,
+
+
                     'tw4ph px-6 py-4 text-sm font-medium' => $isTailwind4 && ($customAttributes['default-styling'] ?? true),
                     'tw4ph dark:text-white' => $isTailwind4 && ($customAttributes['default-colors'] ?? true),
 
diff --git a/resources/views/components/tbody/tbody.blade.php b/resources/views/components/tbody/tbody.blade.php
@@ -8,13 +8,20 @@
         ] : [])
         ->merge($tableRowDetails['attributes'])
         ->class([
+            'text-left' => $this->getDefaultBodyTextAlign() == 'left' && $isTailwind,
+            'text-center' => $this->getDefaultBodyTextAlign() == 'center' && $isTailwind,
+            'text-right' => $this->getDefaultBodyTextAlign() == 'right' && $isTailwind,
             'even:bg-white even:dark:bg-gray-700 odd:bg-gray-50 odd:dark:bg-gray-800 dark:text-white' => $isTailwind,
             'divide-gray-200 dark:divide-none' => $isTailwind && ($coreTableAttributes['tbody']['default-colors'] ?? ($coreTableAttributes['tbody']['default'] ?? true)),
             'divide-y' => $isTailwind && ($coreTableAttributes['tbody']['default-styling'] ?? ($coreTableAttributes['tbody']['default'] ?? true)),
             
             'tw4ph even:bg-white even:dark:bg-gray-700 odd:bg-gray-50 odd:dark:bg-gray-800 dark:text-white' => $isTailwind4,
             'tw4ph divide-gray-200 dark:divide-none' => $isTailwind4 && ($coreTableAttributes['tbody']['default-colors'] ?? ($coreTableAttributes['tbody']['default'] ?? true)),
             'tw4ph divide-y' => $isTailwind4 && ($coreTableAttributes['tbody']['default-styling'] ?? ($coreTableAttributes['tbody']['default'] ?? true)),
+            'tw4ph text-left' => $this->getDefaultBodyTextAlign() == 'left' && $isTailwind4,
+            'tw4ph text-center' => $this->getDefaultBodyTextAlign() == 'center' && $isTailwind4,
+            'tw4ph text-right' => $this->getDefaultBodyTextAlign() == 'right' && $isTailwind4,
+            
         ])
         ->except(['default','default-styling','default-colors']) 
     }} x-data="{ opening: false, }" >
@@ -33,7 +40,7 @@
         @endif
         
         @tableloop($selectedVisibleColumns as $colIndex => $column)
-            <x-livewire-tables::table.td :isClickable="$column->isClickable()" :wrapText="$column->shouldWrapText()" :isHtml="$column->isHtml()" :customAttributes="$this->getTdAttributes($column, $row, $colIndex, $rowIndex)" :$colIndex wire:key="{{ $dataTableFingerprint . '-table-td-'.$rowPk.'-'.$column->getSlug() }}"  x-ref="{{ $dataTableFingerprint . '_' . $rowIndex . '_' . $colIndex }}">
+            <x-livewire-tables::table.td :textAlign="$column->hasTextAlign() ? $column->getTextAlign() : $this->getDefaultBodyTextAlign()" :isClickable="$column->isClickable()" :wrapText="$column->shouldWrapText()" :isHtml="$column->isHtml()" :customAttributes="$this->getTdAttributes($column, $row, $colIndex, $rowIndex)" :$colIndex wire:key="{{ $dataTableFingerprint . '-table-td-'.$rowPk.'-'.$column->getSlug() }}"  x-ref="{{ $dataTableFingerprint . '_' . $rowIndex . '_' . $colIndex }}">
                 @if($column->setIndexes($rowIndex, $colIndex)->isHtml())
                     {!! $column->renderContents($row) !!}
                 @else
diff --git a/src/Features/Columns/Views/Column.php b/src/Features/Columns/Views/Column.php
@@ -4,7 +4,7 @@
 
 use Illuminate\Support\Str;
 use Rappasoft\LaravelLivewireTables\Traits\Core\HasLocalisations;
-use Rappasoft\LaravelLivewireTables\Features\Columns\Views\Traits\{HasDataTableComponent,IsReorderColumn,HasColumnLabelStatus,HasRelations,HasLabelFormat,HasClickable,HasSlug,IsCollapsible,IsSearchable,IsSelectable,IsSortable,HasColumnView,HasFooter,HasSecondaryHeader,HasVisibility, Configuration\ColumnConfiguration, Helpers\ColumnHelpers};
+use Rappasoft\LaravelLivewireTables\Features\Columns\Views\Traits\{HasDataTableComponent,IsReorderColumn,HasColumnLabelStatus,HasRelations,HasLabelFormat,HasClickable,HasSlug,IsCollapsible,IsSearchable,IsSelectable,IsSortable,HasColumnView,HasFooter,HasSecondaryHeader,HasVisibility, HasTextAlign, Configuration\ColumnConfiguration, Helpers\ColumnHelpers};
 use Rappasoft\LaravelLivewireTables\Views\Traits\Core\{HasAttributes, HasLabelAttributes, HasTheme};
 
 class Column
@@ -29,7 +29,8 @@ class Column
         HasLabelAttributes,
         HasSecondaryHeader,
         HasTheme,
-        HasVisibility;
+        HasVisibility,
+        HasTextAlign;
 
     // What displays in the columns header
     protected string $title;
diff --git a/src/Features/Columns/Views/Traits/HasTextAlign.php b/src/Features/Columns/Views/Traits/HasTextAlign.php
@@ -0,0 +1,48 @@
+<?php
+
+namespace Rappasoft\LaravelLivewireTables\Features\Columns\Views\Traits;
+
+trait HasTextAlign
+{
+    protected ?string $textAlign;
+    /**
+     * Undocumented function
+     *
+     * @return boolean
+     */
+    public function hasTextAlign(): bool
+    {
+        return isset($this->textAlign);
+    }
+
+    public function getTextAlign(): string
+    {
+        return $this->textAlign;
+    }
+
+    public function setTextAlign(string $textAlign): self
+    {
+        if($textAlign == 'left' || $textAlign == 'center' || $textAlign == 'right')
+        {
+            $this->textAlign = $textAlign;
+        }
+        
+        return $this;
+    }
+
+    public function setTextAlignLeft(): self
+    {
+        return $this->setTextAlign('left');
+    }
+
+    public function setTextAlignCenter(): self
+    {
+        return $this->setTextAlign('center');
+    }
+
+    public function setTextAlignRight(): self
+    {
+        return $this->setTextAlign('right');
+    }
+
+}
diff --git a/src/Traits/Configuration/TableAttributeConfiguration.php b/src/Traits/Configuration/TableAttributeConfiguration.php
@@ -145,4 +145,30 @@ public function setShouldBeHidden(): void
     {
         $this->setShouldBeDisplayedStatus(false);
     }
+
+    public function setDefaultBodyTextAlign(string $align): self
+    {
+        if($align == 'left' || $align == 'center' || $align == 'right')
+        {
+            $this->defaultBodyTextAlign = $align;
+        }
+
+        return $this;
+    }
+
+    protected function setDefaultBodyTextAlignLeft(): self
+    {
+        return $this->setDefaultBodyTextAlign('left');
+    }
+    
+    protected function setDefaultBodyTextAlignCenter(): self
+    {
+        return $this->setDefaultBodyTextAlign('center');
+    }
+
+    protected function setDefaultBodyTextAlignRight(): self
+    {
+        return $this->setDefaultBodyTextAlign('right');
+    }
+
 }
diff --git a/src/Traits/Helpers/TableAttributeHelpers.php b/src/Traits/Helpers/TableAttributeHelpers.php
@@ -395,5 +395,8 @@ public function getTdAttributesNew(Column $column, Model $row, int $colIndex, in
         return $tdAttribs;
     }
 
-
+    public function getDefaultBodyTextAlign(): string
+    {
+        return $this->defaultBodyTextAlign ?? '';
+    }
 }
diff --git a/src/Traits/WithTableAttributes.php b/src/Traits/WithTableAttributes.php
@@ -104,6 +104,7 @@ trait WithTableAttributes
      */
     protected ?Closure $trUrlTargetCallback;
 
+    protected string $defaultBodyTextAlign = '';
 
     /**
      * Undocumented function
diff --git a/tests/Visuals/SearchVisualsTest.php b/tests/Visuals/SearchVisualsTest.php
@@ -3,6 +3,7 @@
 namespace Rappasoft\LaravelLivewireTables\Tests\Visuals;
 
 use Livewire\Livewire;
+use Livewire\Attributes\Url;
 use PHPUnit\Framework\Attributes\Group;
 use Rappasoft\LaravelLivewireTables\Tests\Http\Livewire\PetsTable;
 use Rappasoft\LaravelLivewireTables\Tests\TestCase;
@@ -100,37 +101,84 @@ public function test_search_via_query_string_functions(): void
             ->assertSee('Chico')
             ->assertDontSee('Cartman');
 
-        $mock = new class extends PetsTable
+
+    }
+
+    public function test_search_via_query_string_functions_new(): void
+    {
+
+        Livewire::withQueryParams(['petsearch' => 'Chico'])
+            ->test(new class extends PetsTable
         {
+            #[Url(as: 'petsearch')]
+            public string $search = '';
+
             public ?array $testAttributesArray;
+            
+            public function refreshQueryString()
+            {
+                $this->queryStringHasQueryStringForSearch();
+            }
 
             public function configure(): void
             {
                 $this->setPrimaryKey('id');
-                $this->setDataTableFingerprint('test');
-                $this->setQueryStringAliasForSearch('pet-search');
+                $this->setQueryStringForSearchEnabled();
+                $this->setQueryStringAliasForSearch('petsearch');
+                $this->queryStringHasQueryStringForSearch();
             }
-        };
+})
+            ->assertSeeHtml('Chico')
+            ->assertDontSeeHtml('Cartman');
 
-        Livewire::withQueryParams(['table-search' => 'Chico'])
-            ->test($mock)
-            ->assertSee('Chico')
-            ->assertSee('Cartman');
+        Livewire::withQueryParams(['petsearch' => null])
+            ->test(new class extends PetsTable
+        {
+            #[Url(as: 'petsearch')]
+            public string $search = '';
 
-        Livewire::withQueryParams(['pet-search' => 'Chico'])
-            ->test($mock)
-            ->assertSee('Chico')
-            ->assertDontSee('Cartman');
+            public ?array $testAttributesArray;
+            
+            public function refreshQueryString()
+            {
+                $this->queryStringHasQueryStringForSearch();
+            }
 
-        Livewire::withQueryParams(['pet-search' => null])
-            ->test($mock)
+            public function configure(): void
+            {
+                $this->setPrimaryKey('id');
+                $this->setQueryStringForSearchEnabled();
+                $this->setQueryStringAliasForSearch('petsearch');
+                $this->queryStringHasQueryStringForSearch();
+            }
+})
             ->assertSee('Chico')
             ->assertSee('Cartman');
 
         Livewire::withQueryParams([])
-            ->test($mock)
+            ->test(new class extends PetsTable
+        {
+            #[Url(as: 'petsearch')]
+            public string $search = '';
+
+            public ?array $testAttributesArray;
+            
+            public function refreshQueryString()
+            {
+                $this->queryStringHasQueryStringForSearch();
+            }
+
+            public function configure(): void
+            {
+                $this->setPrimaryKey('id');
+                $this->setQueryStringForSearchEnabled();
+                $this->setQueryStringAliasForSearch('petsearch');
+                $this->queryStringHasQueryStringForSearch();
+            }
+})
             ->assertSee('Chico')
             ->assertSee('Cartman');
 
     }
+
 }

Original file line number	Diff line number	Diff line change
`@@ -395,5 +395,8 @@ public function getTdAttributesNew(Column $column, Model $row, int $colIndex, in`
`395`	`395`	`return $tdAttribs;`
`396`	`396`	`}`
`397`	`397`
`398`		`-`
	`398`	`+ public function getDefaultBodyTextAlign(): string`
	`399`	`+ {`
	`400`	`+ return $this->defaultBodyTextAlign ?? '';`
	`401`	`+ }`
`399`	`402`	`}`