diff --git a/src/ListView.php b/src/ListView.php
index 0e4881fc9..7b88dc1ec 100644
--- a/src/ListView.php
+++ b/src/ListView.php
@@ -35,7 +35,7 @@ final class ListView extends BaseListView
* @psalm-var non-empty-string|null
*/
private ?string $itemViewTag = 'li';
- private array $itemViewAttributes = [];
+ private array|Closure $itemViewAttributes = [];
private string $separator = "\n";
private array $viewParams = [];
private ?View $view = null;
@@ -166,11 +166,25 @@ public function itemViewTag(?string $tag): self
}
/**
- * return new instance with the HTML attributes for the container of item view.
+ * Return new instance with the HTML attributes for the container of item view.
*
- * @param array $values Attribute values indexed by attribute names.
+ * @param array|Closure $values Attribute values indexed by attribute names.
+ * If this property is specified as a function, it must return an array of attributes and have the following
+ * signature:
+ *
+ * ```php
+ * function ($data, $key, $index, $widget)
+ * ```
+ * Also, each attribute value can be a function too, with the same signature as in:
+ *
+ * ```php
+ * [
+ * 'class' => static fn($data, $key, $index, $widget) => "custom-class-{$data['id']}",
+ * ]
+ * ```
+ * @return ListView
*/
- public function itemViewAttributes(array $values): self
+ public function itemViewAttributes(array|Closure $values): self
{
$new = clone $this;
$new->itemViewAttributes = $values;
@@ -242,10 +256,20 @@ protected function renderItem(array|object $data, mixed $key, int $index): strin
$content = (string)call_user_func($this->itemView, $data, $key, $index, $this);
}
+ $itemViewAttributes = is_callable($this->itemViewAttributes)
+ ? (array)call_user_func($this->itemViewAttributes, $data, $key, $index, $this)
+ : $this->itemViewAttributes;
+
+ foreach ($itemViewAttributes as $i => $attribute) {
+ if (is_callable($attribute)) {
+ $itemViewAttributes[$i] = $attribute($data, $key, $index, $this);
+ }
+ }
+
return $this->itemViewTag === null
? $content
: Html::tag($this->itemViewTag)
- ->attributes($this->itemViewAttributes)
+ ->attributes($itemViewAttributes)
->content("\n" . $content)
->encode(false)
->render();
diff --git a/tests/ListView/BaseTest.php b/tests/ListView/BaseTest.php
index 69f9bd695..fb6892382 100644
--- a/tests/ListView/BaseTest.php
+++ b/tests/ListView/BaseTest.php
@@ -407,4 +407,87 @@ public function testNoItemViewTagNoItemsWrapperTag(): void
->render(),
);
}
+
+ public function testClosureForItemViewAttributes(): void
+ {
+ Assert::equalsWithoutLE(
+ <<
+
+ -
+
Id: 1
Name: John
Age: 20
+
+ -
+
Id: 2
Name: Mary
Age: 21
+
+
+ Page 1 of 1
+
+ HTML,
+ ListView::widget()
+ ->itemView(dirname(__DIR__) . '/Support/view/_listview.php')
+ ->itemViewAttributes(static fn (array $data, $key, $index, $widget) => [
+ 'data-item-id' => $data['id'],
+ 'data-item-key' => $key,
+ 'data-item-index' => $index,
+ ])
+ ->dataReader($this->createOffsetPaginator($this->data, 10))
+ ->separator(PHP_EOL)
+ ->render(),
+ );
+ }
+
+ public function testItemViewAttributesWithClosure(): void
+ {
+ Assert::equalsWithoutLE(
+ <<
+
+ -
+
Id: 1
Name: John
Age: 20
+
+ -
+
Id: 2
Name: Mary
Age: 21
+
+
+ Page 1 of 1
+
+ HTML,
+ ListView::widget()
+ ->itemView(dirname(__DIR__) . '/Support/view/_listview.php')
+ ->itemViewAttributes([
+ 'class' => static fn(array $data, $key, $index) => "id-{$data['id']}-key-{$key}-index-{$index}",
+ ])
+ ->dataReader($this->createOffsetPaginator($this->data, 10))
+ ->separator(PHP_EOL)
+ ->render(),
+ );
+ }
+
+ public function testClosureForItemViewAttributesWithClosure(): void
+ {
+ Assert::equalsWithoutLE(
+ <<
+
+ -
+
Id: 1
Name: John
Age: 20
+
+ -
+
Id: 2
Name: Mary
Age: 21
+
+
+ Page 1 of 1
+
+ HTML,
+ ListView::widget()
+ ->itemView(dirname(__DIR__) . '/Support/view/_listview.php')
+ ->itemViewAttributes(static fn (array $data, $key, $index) => [
+ 'class' => static fn(array $data, $key, $index) => "id-{$data['id']}-key-{$key}-index-{$index}",
+ ])
+ ->dataReader($this->createOffsetPaginator($this->data, 10))
+ ->separator(PHP_EOL)
+ ->render(),
+ );
+ }
}