Add support for all polling options

Author: rappasoft

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to `laravel-livewire-tables` will be documented in this file
 
 ## [Unreleased]
 
+### Added
+
+- Support for polling `keep-alive` and `visible`.
+
 ### Changed
 
 - Updated Tailwind search clear button (https://github.com/rappasoft/laravel-livewire-tables/pull/217).

README.md

@@ -392,7 +392,7 @@ There are some class level properties you can set:
 | $searchFilterDebounce | null | null/int | Adds a debounce of `$searchFilterDebounce` ms to the search input |
 | $searchFilterDefer | null | null/bool | Adds `.defer` to the search input |
 | $searchFilterLazy | null | null/bool | Adds `.lazy` to the search input |
-| $refresh | false | false/int/string | Whether or not to refresh the table at a certain interval. false = off, int = ms, string = functionCall |
+| $refresh | false | false/int/string | Whether or not to refresh the table at a certain interval. false = off, int = ms, string = functionCall (if the string is `keep-alive` it will use `wire:poll.keep-alive`, if the string is `visible` it will use `wire:poll.visible`) |
 | $offlineIndicator | true | bool | Shows a red banner when there is no internet connection. |
 
 #### Using more than one table on a page

resources/views/bootstrap-4/datatable.blade.php

@@ -1,5 +1,15 @@
 <div
-    @if (is_numeric($refresh)) wire:poll.{{ $refresh }}ms @elseif(is_string($refresh)) wire:poll="{{ $refresh }}" @endif
+    @if (is_numeric($refresh))
+        wire:poll.{{ $refresh }}ms
+    @elseif(is_string($refresh))
+        @if ($refresh === '.keep-alive' || $refresh === 'keep-alive')
+            wire:poll.keep-alive
+        @elseif($refresh === '.visible' || $refresh === 'visible')
+            wire:poll.visible
+        @else
+            wire:poll="{{ $refresh }}"
+        @endif
+    @endif
     class="container-fluid"
 >
     @include('livewire-tables::bootstrap-4.includes.offline')

resources/views/bootstrap-5/datatable.blade.php

@@ -1,5 +1,15 @@
 <div
-    @if (is_numeric($refresh)) wire:poll.{{ $refresh }}ms @elseif(is_string($refresh)) wire:poll="{{ $refresh }}" @endif
+    @if (is_numeric($refresh))
+        wire:poll.{{ $refresh }}ms
+    @elseif(is_string($refresh))
+        @if ($refresh === '.keep-alive' || $refresh === 'keep-alive')
+            wire:poll.keep-alive
+        @elseif($refresh === '.visible' || $refresh === 'visible')
+            wire:poll.visible
+        @else
+            wire:poll="{{ $refresh }}"
+        @endif
+    @endif
     class="container-fluid"
 >
     @include('livewire-tables::bootstrap-5.includes.offline')

resources/views/tailwind/datatable.blade.php

@@ -1,5 +1,15 @@
 <div
-    @if (is_numeric($refresh)) wire:poll.{{ $refresh }}ms @elseif(is_string($refresh)) wire:poll="{{ $refresh }}" @endif
+    @if (is_numeric($refresh))
+        wire:poll.{{ $refresh }}ms
+    @elseif(is_string($refresh))
+        @if ($refresh === '.keep-alive' || $refresh === 'keep-alive')
+            wire:poll.keep-alive
+        @elseif($refresh === '.visible' || $refresh === 'visible')
+            wire:poll.visible
+        @else
+            wire:poll="{{ $refresh }}"
+        @endif
+    @endif
 >
     @include('livewire-tables::tailwind.includes.offline')
 

src/DataTableComponent.php

@@ -68,7 +68,7 @@ abstract class DataTableComponent extends Component
      * Whether or not to refresh the table at a certain interval
      * false is off
      * If it's an integer it will be treated as milliseconds (2000 = refresh every 2 seconds)
-     * If it's a string it will call that function every 5 seconds.
+     * If it's a string it will call that function every 5 seconds unless it is 'keep-alive' or 'visible'.
      *
      * @var bool|string
      */