Add LinkList Column

src/UI/Component/Table/Column/Factory.php

@@ -114,10 +114,21 @@ public function timeSpan(string $title, \ILIAS\Data\DateFormat\DateFormat $forma
      * ---
      * description:
      *   purpose: >
-     *      The Link Column features a Link.
+     *      The Link Column features a Standard Link.
      *
      * ---
      * @return \ILIAS\UI\Component\Table\Column\Link
      */
     public function link(string $title): Link;
+
+    /**
+     * ---
+     * description:
+     *   purpose: >
+     *      The Link Column features a Listing of Standard Links.
+     *
+     * ---
+     * @return \ILIAS\UI\Component\Table\Column\LinkList
+     */
+    public function linkList(string $title): LinkList;
 }

src/UI/Component/Table/Column/LinkList.php

@@ -0,0 +1,25 @@
+<?php
+
+/**
+ * This file is part of ILIAS, a powerful learning management system
+ * published by ILIAS open source e-Learning e.V.
+ *
+ * ILIAS is licensed with the GPL-3.0,
+ * see https://www.gnu.org/licenses/gpl-3.0.en.html
+ * You should have received a copy of said license along with the
+ * source code, too.
+ *
+ * If this is not the case or you just want to try ILIAS, you'll find
+ * us at:
+ * https://www.ilias.de
+ * https://github.com/ILIAS-eLearning
+ *
+ *********************************************************************/
+
+declare(strict_types=1);
+
+namespace ILIAS\UI\Component\Table\Column;
+
+interface LinkList extends Column
+{
+}

src/UI/Implementation/Component/Table/Column/Factory.php

@@ -68,4 +68,9 @@ public function link(string $title): I\Link
     {
         return new Link($title);
     }
+
+    public function linkList(string $title): I\LinkList
+    {
+        return new LinkList($title);
+    }
 }

src/UI/Implementation/Component/Table/Column/LinkList.php

@@ -0,0 +1,37 @@
+<?php
+
+/**
+ * This file is part of ILIAS, a powerful learning management system
+ * published by ILIAS open source e-Learning e.V.
+ *
+ * ILIAS is licensed with the GPL-3.0,
+ * see https://www.gnu.org/licenses/gpl-3.0.en.html
+ * You should have received a copy of said license along with the
+ * source code, too.
+ *
+ * If this is not the case or you just want to try ILIAS, you'll find
+ * us at:
+ * https://www.ilias.de
+ * https://github.com/ILIAS-eLearning
+ *
+ *********************************************************************/
+
+declare(strict_types=1);
+
+namespace ILIAS\UI\Implementation\Component\Table\Column;
+
+use ILIAS\UI\Component\Table\Column as C;
+use ILIAS\UI\Component\Link\Standard;
+use ILIAS\UI\Component\Listing\Listing;
+use ILIAS\UI\Component\Component;
+
+class LinkList extends Column implements C\LinkList
+{
+    public function format($value): string|Component
+    {
+        $this->checkArgInstanceOf('value', $value, Listing::class);
+        $check = $value->getItems();
+        $this->checkArgListElements("list items", $check, Standard::class);
+        return $value;
+    }
+}

src/UI/examples/Table/Column/Link/base.php

@@ -55,6 +55,7 @@ public function getTotalRowCount(
         }
     };
 
-    $table = $f->table()->data('Link Columns', $columns, $data_retrieval);
+    $table = $f->table()->data('Link Columns', $columns, $data_retrieval)
+        ->withRequest($DIC->http()->request());
     return $r->render($table);
 }

src/UI/examples/Table/Column/LinkList/base.php

@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ILIAS\UI\examples\Table\Column\LinkList;
+
+use ILIAS\UI\Component\Table as I;
+use ILIAS\Data\Range;
+use ILIAS\Data\Order;
+
+function base(): string
+{
+    global $DIC;
+    $f = $DIC->ui()->factory();
+    $r = $DIC->ui()->renderer();
+
+    $columns = [
+        'l1' => $f->table()->column()->linkList("a link list column")
+    ];
+
+    $some_link = $f->link()->standard('ILIAS Homepage', 'http://www.ilias.de');
+    $some_linklist = $f->listing()->unordered([$some_link, $some_link, $some_link]);
+
+    $dummy_records = [
+        ['l1' => $some_linklist],
+        ['l1' => $some_linklist]
+    ];
+
+    $data_retrieval = new class ($dummy_records) implements I\DataRetrieval {
+        protected array $records;
+
+        public function __construct(array $dummy_records)
+        {
+            $this->records = $dummy_records;
+        }
+
+        public function getRows(
+            I\DataRowBuilder $row_builder,
+            array $visible_column_ids,
+            Range $range,
+            Order $order,
+            ?array $filter_data,
+            ?array $additional_parameters
+        ): \Generator {
+            foreach ($this->records as $idx => $record) {
+                $row_id = '';
+                yield $row_builder->buildDataRow($row_id, $record);
+            }
+        }
+
+        public function getTotalRowCount(
+            ?array $filter_data,
+            ?array $additional_parameters
+        ): ?int {
+            return null;
+        }
+    };
+
+    $table = $f->table()->data('Link List Columns', $columns, $data_retrieval)
+               ->withRequest($DIC->http()->request());
+    return $r->render($table);
+}

tests/UI/Component/Table/Column/ColumnFactoryTest.php

@@ -34,7 +34,8 @@ class ColumnFactoryTest extends AbstractFactoryTest
         "status" => ["context" => false, "rules" => false],
         "statusIcon" => ["context" => false, "rules" => false],
         "timeSpan" => ["context" => false, "rules" => false],
-        "link" => ["context" => false, "rules" => false]
+        "link" => ["context" => false, "rules" => false],
+        "linkList" => ["context" => false, "rules" => false]
     ];
 
     public $factory_title = 'ILIAS\\UI\\Component\\Table\\Column\\Factory';
@@ -61,7 +62,8 @@ public function getColumnTypeProvider(): array
             [Column\Status::class, $f->status("")],
             [Column\StatusIcon::class, $f->statusIcon("")],
             [Column\EMail::class, $f->eMail("")],
-            [Column\Link::class, $f->link("")]
+            [Column\Link::class, $f->link("")],
+            [Column\LinkList::class, $f->linkList("")]
         ];
     }
 

tests/UI/Component/Table/Column/ColumnTest.php

@@ -24,6 +24,7 @@
 
 use ILIAS\UI\Implementation\Component\Table\Column;
 use ILIAS\UI\Implementation\Component\Link;
+use ILIAS\UI\Implementation\Component\Listing;
 
 /**
  * Basic Tests for Table-Columns.
@@ -110,4 +111,12 @@ public function testDataTableColumnLinkFormatAcceptsOnlyLinks(): void
         $link = 'some string';
         $this->assertEquals($link, $col->format($link));
     }
+
+    public function testDataTableColumnLinkListFormat(): void
+    {
+        $col = new Column\LinkList('col');
+        $link = new Link\Standard('label', '#');
+        $linklist = new Listing\Unordered([$link,$link,$link]);
+        $this->assertEquals($linklist, $col->format($linklist));
+    }
 }