feat(Table): add extraRecordLinkAttributes() method

refs #18284

Author: Copilot

packages/tables/resources/views/index.blade.php

@@ -1121,7 +1121,7 @@ class="fi-ta-record-checkbox fi-checkbox-input"
                                                 @if ($recordUrl)
                                                     <a
                                                         {{ \Filament\Support\generate_href_html($recordUrl, $openRecordUrlInNewTab, hasNestedClickEventHandler: true) }}
-                                                        class="fi-ta-record-content"
+                                                        {{ $getExtraRecordLinkAttributeBag($record)->class(['fi-ta-record-content']) }}
                                                     >
                                                         @foreach ($columnsLayout as $columnsLayoutComponent)
                                                             {{
@@ -1979,6 +1979,9 @@ class="fi-ta-record-checkbox fi-checkbox-input"
                                                             <{{ $columnWrapperTag }}
                                                                 @if ($columnWrapperTag === 'a')
                                                                     {{ \Filament\Support\generate_href_html($columnUrl ?: $recordUrl, $columnUrl ? $column->shouldOpenUrlInNewTab() : $openRecordUrlInNewTab, hasNestedClickEventHandler: true) }}
+                                                                    @if (blank($columnUrl) && filled($recordUrl))
+                                                                        {{ $getExtraRecordLinkAttributeBag($record) }}
+                                                                    @endif
                                                                 @elseif ($columnWrapperTag === 'button')
                                                                     type="button"
                                                                     wire:click.prevent.stop="{{ $columnWireClickAction }}"

packages/tables/src/Table/Concerns/HasRecordUrl.php

@@ -4,13 +4,19 @@
 
 use Closure;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\View\ComponentAttributeBag;
 
 trait HasRecordUrl
 {
     protected bool | Closure $shouldOpenRecordUrlInNewTab = false;
 
     protected string | Closure | null $recordUrl = null;
 
+    /**
+     * @var array<array<mixed> | Closure>
+     */
+    protected array $extraRecordLinkAttributes = [];
+
     public function openRecordUrlInNewTab(bool | Closure $condition = true): static
     {
         $this->shouldOpenRecordUrlInNewTab = $condition;
@@ -59,4 +65,53 @@ public function shouldOpenRecordUrlInNewTab(Model | array $record): bool
             ] : [],
         );
     }
+
+    /**
+     * @param  array<mixed> | Closure  $attributes
+     */
+    public function extraRecordLinkAttributes(array | Closure $attributes, bool $merge = false): static
+    {
+        if ($merge) {
+            $this->extraRecordLinkAttributes[] = $attributes;
+        } else {
+            $this->extraRecordLinkAttributes = [$attributes];
+        }
+
+        return $this;
+    }
+
+    /**
+     * @param  Model | array<string, mixed>  $record
+     * @return array<mixed>
+     */
+    public function getExtraRecordLinkAttributes(Model | array $record): array
+    {
+        $temporaryAttributeBag = new ComponentAttributeBag;
+
+        foreach ($this->extraRecordLinkAttributes as $extraAttributes) {
+            $temporaryAttributeBag = $temporaryAttributeBag->merge(
+                $this->evaluate(
+                    $extraAttributes,
+                    namedInjections: [
+                        'record' => $record,
+                    ],
+                    typedInjections: ($record instanceof Model) ? [
+                        Model::class => $record,
+                        $record::class => $record,
+                    ] : [],
+                ),
+                escape: false,
+            );
+        }
+
+        return $temporaryAttributeBag->getAttributes();
+    }
+
+    /**
+     * @param  Model | array<string, mixed>  $record
+     */
+    public function getExtraRecordLinkAttributeBag(Model | array $record): ComponentAttributeBag
+    {
+        return new ComponentAttributeBag($this->getExtraRecordLinkAttributes($record));
+    }
 }

tests/src/Tables/RecordTest.php

@@ -14,3 +14,37 @@
     livewire(PostsTable::class)
         ->assertCanSeeTableRecords($posts);
 });
+
+it('can set extra record link attributes', function (): void {
+    $table = livewire(PostsTable::class)->instance()->getTable();
+    $table->extraRecordLinkAttributes(['data-test' => 'value']);
+
+    $post = Post::factory()->create();
+    $attributes = $table->getExtraRecordLinkAttributeBag($post);
+
+    expect($attributes->get('data-test'))->toBe('value');
+});
+
+it('can set dynamic extra record link attributes', function (): void {
+    $table = livewire(PostsTable::class)->instance()->getTable();
+    $table->extraRecordLinkAttributes(fn ($record) => [
+        'data-id' => (string) $record->getKey(),
+    ]);
+
+    $post = Post::factory()->create();
+    $attributes = $table->getExtraRecordLinkAttributeBag($post);
+
+    expect($attributes->get('data-id'))->toBe((string) $post->getKey());
+});
+
+it('can merge extra record link attributes', function (): void {
+    $table = livewire(PostsTable::class)->instance()->getTable();
+    $table->extraRecordLinkAttributes(['data-test' => 'value1']);
+    $table->extraRecordLinkAttributes(['data-test2' => 'value2'], merge: true);
+
+    $post = Post::factory()->create();
+    $attributes = $table->getExtraRecordLinkAttributeBag($post);
+
+    expect($attributes->get('data-test'))->toBe('value1')
+        ->and($attributes->get('data-test2'))->toBe('value2');
+});