Add prepend/append options to BaseListView

src/BaseListView.php

@@ -115,6 +115,8 @@
      */
     private ?string $containerTag = 'div';
     private array $containerAttributes = [];
+    private string $prepend = '';
+    private string $append = '';
 
     /**
      * @psalm-var non-empty-string|null
@@ -218,7 +220,7 @@
         return $new;
     }
 
     final public function multiSort(bool $enable = true): static
     {
         $new = clone $this;
         $new->multiSort = $enable;
@@ -248,6 +250,30 @@
         return $new;
     }
 
+    /**
+     * Returns a new instance with HTML content to be added after the open container tag.
+     *
+     * @param string|Stringable $prepend The HTML content to be prepended.
+     */
+    final public function prepend(string|Stringable $prepend): static
+    {
+        $new = clone $this;
+        $new->prepend = (string) $prepend;
+        return $new;
+    }
+
+    /**
+     * Returns a new instance with HTML content to be added before the close container tag.
+     *
+     * @param string|Stringable $append The HTML content to be appended.
+     */
+    final public function append(string|Stringable $append): static
+    {
+        $new = clone $this;
+        $new->append = (string) $append;
+        return $new;
+    }
+
     /**
      * Return a new instance with the empty text.
      *
@@ -543,6 +569,13 @@
             )
         );
 
+        if ($this->prepend !== '') {
+            $content = $this->prepend . "\n" . $content;
+        }
+        if ($this->append !== '') {
+            $content .= "\n" . $this->append;
+        }
+
         return $this->containerTag === null
             ? $content
             : Html::tag($this->containerTag, "\n" . $content . "\n", $this->containerAttributes)
@@ -593,7 +626,7 @@
      *
      * @psalm-return list{FilterInterface[]|null,ValidationResult}
      */
     protected function makeFilters(): array
     {
         return [[], new ValidationResult()];
     }
@@ -762,7 +795,7 @@
             }
         }
 
         if (!empty($sort) && $dataReader->isSortable()) {
             $sortObject = $dataReader->getSort();
             if ($sortObject !== null) {
                 $order = OrderHelper::stringToArray($sort);
@@ -777,7 +810,7 @@
             }
         }
 
         if (!empty($filters) && $dataReader->isFilterable()) {
             $dataReader = $dataReader->withFilter(new All(...$filters));
         }
 
@@ -921,7 +954,7 @@
         $currentPage = $dataReader->getCurrentPage();
 
         // The starting row number (1-based) currently being displayed
         $begin = ($currentPage - 1) * $dataReader->getPageSize() + 1;
 
         // The number of rows currently being displayed
         $count = $dataReader->getCurrentPageSize();