🖼️ Add persistent per-view layout modes (table / tiles / gallery)

lib/Constants/ViewUpdatableParameters.php

@@ -16,4 +16,7 @@ enum ViewUpdatableParameters: string {
 	case SORT = 'sort';
 	case FILTER = 'filter';
 	case COLUMN_SETTINGS = 'columns';
+	case LAYOUT = 'layout';
+	case CARD_BACKGROUND_SOURCE = 'cardBackgroundSource';
+	case CARD_TITLE_SOURCE = 'cardTitleSource';
 }

lib/Controller/Api1Controller.php

@@ -334,6 +334,7 @@ public function indexViews(int $tableId): DataResponse {
 	 * @param int $tableId Table ID that will hold the view
 	 * @param string $title Title for the view
 	 * @param string|null $emoji Emoji for the view
+	 * @param string|null $layout Layout for the view with 'table', 'tiles', 'gallery' or null
 	 *
 	 * @return DataResponse<Http::STATUS_OK, TablesView, array{}>|DataResponse<Http::STATUS_FORBIDDEN|Http::STATUS_INTERNAL_SERVER_ERROR|Http::STATUS_NOT_FOUND, array{message: string}, array{}>
 	 *
@@ -346,9 +347,9 @@ public function indexViews(int $tableId): DataResponse {
 	#[CORS]
 	#[RequirePermission(permission: Application::PERMISSION_MANAGE, type: Application::NODE_TYPE_TABLE, idParam: 'tableId')]
 	#[OpenAPI(scope: OpenAPI::SCOPE_DEFAULT)]
-	public function createView(int $tableId, string $title, ?string $emoji): DataResponse {
+	public function createView(int $tableId, string $title, ?string $emoji, ?string $layout = null): DataResponse {
 		try {
-			return new DataResponse($this->viewService->create($title, $emoji, $this->tableService->find($tableId))->jsonSerialize());
+			return new DataResponse($this->viewService->create($title, $emoji, $this->tableService->find($tableId), null, $layout)->jsonSerialize());
 		} catch (PermissionError $e) {
 			$this->logger->warning('A permission error occurred: ' . $e->getMessage(), ['exception' => $e]);
 			$message = ['message' => $e->getMessage()];
@@ -404,6 +405,9 @@ public function getView(int $viewId): DataResponse {
 	 *      columns?: list<int>,
 	 *      columnSettings?: list<array{columnId?: int, order?: int, readonly?: bool, mandatory?: bool}>,
 	 *      sort?: list<array{columnId: int, mode: 'ASC'|'DESC'}>,
+	 *      layout?: 'table'|'tiles'|'gallery'|null,
+	 *      cardBackgroundSource?: int|null,
+	 *      cardTitleSource?: int|null,
 	 *      filter?: list<list<array{columnId: int, operator: 'begins-with'|'ends-with'|'contains'|'does-not-contain'|'is-equal'|'is-not-equal'|'is-greater-than'|'is-greater-than-or-equal'|'is-lower-than'|'is-lower-than-or-equal'|'is-empty', value: string|int|float}>>
 	 *  } $data fields of the view with their new values
 	 * @return DataResponse<Http::STATUS_OK, TablesView, array{}>|DataResponse<Http::STATUS_FORBIDDEN|Http::STATUS_NOT_FOUND|Http::STATUS_BAD_REQUEST|Http::STATUS_INTERNAL_SERVER_ERROR, array{message: string}, array{}>

lib/Controller/ApiTablesController.php

@@ -181,6 +181,7 @@ public function createFromScheme(string $title, string $emoji, string $descripti
 					$view['emoji'],
 					$table,
 					$this->userId,
+					$view['layout'] ?? null,
 				);
 
 				$inputColumnsArray = [];
@@ -218,6 +219,7 @@ public function createFromScheme(string $title, string $emoji, string $descripti
 					array_merge($inputColumnsArray, [
 						'sort' => $newSort,
 						'filter' => $newFilter,
+						'layout' => $view['layout'] ?? null,
 					])
 				));
 			}

lib/Controller/ViewController.php

@@ -78,9 +78,9 @@ public function show(int $id): DataResponse {
 
 	#[NoAdminRequired]
 	#[RequirePermission(permission: Application::PERMISSION_MANAGE, type: Application::NODE_TYPE_TABLE, idParam: 'tableId')]
-	public function create(int $tableId, string $title, ?string $emoji): DataResponse {
-		return $this->handleError(function () use ($tableId, $title, $emoji) {
-			return $this->service->create($title, $emoji, $this->getTable($tableId, true));
+	public function create(int $tableId, string $title, ?string $emoji, ?string $layout = null): DataResponse {
+		return $this->handleError(function () use ($tableId, $title, $emoji, $layout) {
+			return $this->service->create($title, $emoji, $this->getTable($tableId, true), null, $layout);
 		});
 	}
 

lib/Db/View.php

@@ -45,6 +45,12 @@
  * @method setEmoji(string $emoji)
  * @method getDescription(): string
  * @method setDescription(string $description)
+ * @method getLayout(): ?string
+ * @method setLayout(?string $layout)
+ * @method getCardBackgroundSource(): ?int
+ * @method setCardBackgroundSource(?int $cardBackgroundSource)
+ * @method getCardTitleSource(): ?int
+ * @method setCardTitleSource(?int $cardTitleSource)
  * @method getIsShared(): bool
  * @method setIsShared(bool $isShared)
  * @method getOnSharePermissions(): ?Permissions
@@ -74,6 +80,9 @@ class View extends EntitySuper implements JsonSerializable {
 	protected ?string $columns = null; // json
 	protected ?string $sort = null; // json
 	protected ?string $filter = null; // json
+	protected ?string $layout = null;
+	protected ?int $cardBackgroundSource = null;
+	protected ?int $cardTitleSource = null;
 
 	// virtual properties
 	protected ?bool $isShared = null;
@@ -89,6 +98,8 @@ class View extends EntitySuper implements JsonSerializable {
 	public function __construct() {
 		$this->addType('id', 'integer');
 		$this->addType('tableId', 'integer');
+		$this->addType('cardBackgroundSource', 'integer');
+		$this->addType('cardTitleSource', 'integer');
 	}
 
 	/**
@@ -171,6 +182,10 @@ public function setFilterArray(array $array):void {
 		$this->setFilter(\json_encode($array));
 	}
 
+	public function getLayoutNormalized(): string {
+		return in_array($this->layout, ['tiles', 'gallery'], true) ? $this->layout : 'table';
+	}
+
 	private function getSharePermissions(): ?Permissions {
 		return $this->getOnSharePermissions();
 	}
@@ -199,6 +214,9 @@ public function jsonSerialize(): array {
 			'hasShares' => (bool)$this->hasShares,
 			'rowsCount' => $this->rowsCount ?: 0,
 			'ownerDisplayName' => $this->ownerDisplayName,
+			'layout' => $this->getLayoutNormalized(),
+			'cardBackgroundSource' => $this->cardBackgroundSource,
+			'cardTitleSource' => $this->cardTitleSource,
 		];
 		$serialisedJson['filter'] = $this->getFilterArray();
 

lib/Migration/Version1000Date20260318000000.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Tables\Migration;
+
+use Closure;
+use OCP\DB\ISchemaWrapper;
+use OCP\DB\Types;
+use OCP\Migration\IOutput;
+use OCP\Migration\SimpleMigrationStep;
+use Override;
+
+class Version1000Date20260318000000 extends SimpleMigrationStep {
+
+	#[Override]
+	public function changeSchema(IOutput $output, Closure $schemaClosure, array $options): ?ISchemaWrapper {
+		/** @var ISchemaWrapper $schema */
+		$schema = $schemaClosure();
+		$tableName = 'tables_views';
+		if (!$schema->hasTable($tableName)) {
+			return null;
+		}
+
+		$table = $schema->getTable($tableName);
+		if (!$table->hasColumn('layout')) {
+			$table->addColumn('layout', Types::STRING, [
+				'notnull' => false,
+				'length' => 16,
+			]);
+		}
+		if (!$table->hasColumn('card_background_source')) {
+			$table->addColumn('card_background_source', Types::INTEGER, [
+				'notnull' => false,
+				'unsigned' => false,
+			]);
+		}
+		if (!$table->hasColumn('card_title_source')) {
+			$table->addColumn('card_title_source', Types::INTEGER, [
+				'notnull' => false,
+				'unsigned' => false,
+			]);
+		}
+
+		return $schema;
+	}
+}

lib/Model/ViewUpdateInput.php

@@ -29,6 +29,9 @@ public function __construct(
 		protected readonly ?ColumnSettings $columnSettings = null,
 		protected readonly ?FilterSet $filterSet = null,
 		protected readonly ?SortRuleSet $sortRuleSet = null,
+		protected readonly ?string $layout = null,
+		protected readonly ?int $cardBackgroundSource = null,
+		protected readonly ?int $cardTitleSource = null,
 	) {
 	}
 
@@ -51,6 +54,15 @@ public function updateDetail(): Generator {
 		if ($this->sortRuleSet) {
 			yield ViewUpdatableParameters::SORT => $this->sortRuleSet;
 		}
+		if ($this->layout !== null) {
+			yield ViewUpdatableParameters::LAYOUT => $this->layout;
+		}
+		if ($this->cardBackgroundSource !== null) {
+			yield ViewUpdatableParameters::CARD_BACKGROUND_SOURCE => $this->cardBackgroundSource;
+		}
+		if ($this->cardTitleSource !== null) {
+			yield ViewUpdatableParameters::CARD_TITLE_SOURCE => $this->cardTitleSource;
+		}
 	}
 
 	/**
@@ -61,6 +73,9 @@ public function updateDetail(): Generator {
 	 *     columns?: list<int>,
 	 *     columnSettings?: list<array{columnId?: int, order?: int, readonly?: bool, mandatory?: bool}>,
 	 *     sort?: list<array{columnId: int, mode: 'ASC'|'DESC'}>,
+	 *     layout?: 'table'|'tiles'|'gallery'|null,
+	 *     cardBackgroundSource?: int|null,
+	 *     cardTitleSource?: int|null,
 	 *     filter?: list<list<array{columnId: int, operator: 'begins-with'|'ends-with'|'contains'|'does-not-contain'|'is-equal'|'is-not-equal'|'is-greater-than'|'is-greater-than-or-equal'|'is-lower-than'|'is-lower-than-or-equal'|'is-empty', value: string|int|float}>>
 	 * } $data
 	 */
@@ -80,16 +95,38 @@ public static function fromInputArray(array $data): self {
 			$data['columnSettings'] = $value;
 		}
 
+		$layout = self::normalizeLayout($data['layout'] ?? null);
+
 		return new self(
 			title: $data['title'] ? new Title($data['title']) : null,
 			description: $data['description'] ?? null,
 			emoji: $data['emoji'] ? new Emoji($data['emoji']) : null,
 			columnSettings: $data['columnSettings'] ? ColumnSettings::createFromInputArray($data['columnSettings']) : null,
 			filterSet: $data['filter'] ? FilterSet::createFromInputArray($data['filter']) : null,
 			sortRuleSet: $data['sort'] ? SortRuleSet::createFromInputArray($data['sort']) : null,
+			layout: $layout,
+			cardBackgroundSource: array_key_exists('cardBackgroundSource', $data) && $data['cardBackgroundSource'] !== null ? (int)$data['cardBackgroundSource'] : null,
+			cardTitleSource: array_key_exists('cardTitleSource', $data) && $data['cardTitleSource'] !== null ? (int)$data['cardTitleSource'] : null,
 		);
 	}
 
+
+	private static function normalizeLayout(mixed $layout): ?string {
+		if ($layout === null || $layout === '') {
+			return null;
+		}
+
+		if (!is_string($layout)) {
+			throw new \InvalidArgumentException('Invalid layout value.');
+		}
+
+		if (!in_array($layout, ['table', 'tiles', 'gallery'], true)) {
+			throw new \InvalidArgumentException('Invalid layout value.');
+		}
+
+		return $layout;
+	}
+
 	protected static function transformJsonToArrayInPayload(array $input, array $keys): array {
 		$output = $input;
 		foreach ($keys as $targetKey) {

lib/ResponseDefinitions.php

@@ -29,6 +29,9 @@
  *  columnSettings:list<array{columnId: int, order: int, readonly: bool}>,
  *  sort: list<array{columnId: int, mode: 'ASC'|'DESC'}>,
  *  filter: list<list<array{columnId: int, operator: 'begins-with'|'ends-with'|'contains'|'does-not-contain'|'is-equal'|'is-not-equal'|'is-greater-than'|'is-greater-than-or-equal'|'is-lower-than'|'is-lower-than-or-equal'|'is-empty', value: string|int|float}>>,
+ *  layout: 'table'|'tiles'|'gallery',
+ *  cardBackgroundSource: int|null,
+ *  cardTitleSource: int|null,
  * 	isShared: bool,
  *	favorite: bool,
  * 	onSharePermissions: ?array{

lib/Service/TableTemplateService.php

@@ -856,7 +856,7 @@ private function createRow(Table $table, array $values): void {
 	private function createView(Table $table, array $data): void {
 		try {
 			$inputData = ViewUpdateInput::fromInputArray($data);
-			$view = $this->viewService->create($data['title'], $data['emoji'], $table);
+			$view = $this->viewService->create($data['title'], $data['emoji'], $table, null, $data['layout'] ?? null);
 			$this->viewService->update($view->getId(), $inputData);
 		} catch (PermissionError $e) {
 			$this->logger->warning('Cannot create view, permission denied: ' . $e->getMessage());

lib/Service/ViewService.php

@@ -193,7 +193,7 @@ public function findSharedViewsWithMe(?string $userId = null): array {
 	 * @throws InternalError
 	 * @throws PermissionError
 	 */
-	public function create(string $title, ?string $emoji, Table $table, ?string $userId = null): View {
+	public function create(string $title, ?string $emoji, Table $table, ?string $userId = null, ?string $layout = null): View {
 		/** @var string $userId */
 		$userId = $this->permissionsService->preCheckUserId($userId, false); // $userId is set
 
@@ -209,6 +209,7 @@ public function create(string $title, ?string $emoji, Table $table, ?string $use
 			$item->setEmoji($emoji);
 		}
 		$item->setDescription('');
+		$item->setLayout(in_array($layout, ['tiles', 'gallery'], true) ? $layout : null);
 		$item->setTableId($table->getId());
 		$item->setCreatedBy($userId);
 		$item->setLastEditBy($userId);
@@ -251,12 +252,12 @@ public function update(int $id, ViewUpdateInput $data, ?string $userId = null, b
 					$this->assertInputColumnsAreValid($view, $userId, $value);
 				}
 
-				if ($value instanceof JsonSerializable) {
-					$insertableValue = json_encode($value);
-				}
+				$insertableValue = $value instanceof JsonSerializable
+					? json_encode($value)
+					: $value;
 
 				$setterMethod = 'set' . ucfirst($parameter->value);
-				$view->$setterMethod($insertableValue ?? $value);
+				$view->$setterMethod($insertableValue);
 			}
 
 			$time = new DateTime();
@@ -613,6 +614,9 @@ public function importView(int $tableId, array $view, string $userId): void {
 		$item->setColumns(json_encode($view['columnSettings']));
 		$item->setSort(json_encode($view['sort']));
 		$item->setFilter(json_encode($view['filter']));
+		$item->setLayout(in_array($view['layout'] ?? null, ['tiles', 'gallery'], true) ? $view['layout'] : null);
+		$item->setCardBackgroundSource(isset($view['cardBackgroundSource']) ? (int)$view['cardBackgroundSource'] : null);
+		$item->setCardTitleSource(isset($view['cardTitleSource']) ? (int)$view['cardTitleSource'] : null);
 		try {
 			$this->mapper->insert($item);
 		} catch (\Exception $e) {

openapi.json

@@ -863,6 +863,9 @@
                     "columnSettings",
                     "sort",
                     "filter",
+                    "layout",
+                    "cardBackgroundSource",
+                    "cardTitleSource",
                     "isShared",
                     "favorite",
                     "onSharePermissions",
@@ -1013,6 +1016,24 @@
                             }
                         }
                     },
+                    "layout": {
+                        "type": "string",
+                        "enum": [
+                            "table",
+                            "tiles",
+                            "gallery"
+                        ]
+                    },
+                    "cardBackgroundSource": {
+                        "type": "integer",
+                        "format": "int64",
+                        "nullable": true
+                    },
+                    "cardTitleSource": {
+                        "type": "integer",
+                        "format": "int64",
+                        "nullable": true
+                    },
                     "isShared": {
                         "type": "boolean"
                     },
@@ -1834,6 +1855,12 @@
                                         "type": "string",
                                         "nullable": true,
                                         "description": "Emoji for the view"
+                                    },
+                                    "layout": {
+                                        "type": "string",
+                                        "nullable": true,
+                                        "default": null,
+                                        "description": "Layout for the view with 'table', 'tiles', 'gallery' or null"
                                     }
                                 }
                             }
@@ -2135,6 +2162,25 @@
                                                     }
                                                 }
                                             },
+                                            "layout": {
+                                                "type": "string",
+                                                "nullable": true,
+                                                "enum": [
+                                                    "table",
+                                                    "tiles",
+                                                    "gallery"
+                                                ]
+                                            },
+                                            "cardBackgroundSource": {
+                                                "type": "integer",
+                                                "format": "int64",
+                                                "nullable": true
+                                            },
+                                            "cardTitleSource": {
+                                                "type": "integer",
+                                                "format": "int64",
+                                                "nullable": true
+                                            },
                                             "filter": {
                                                 "type": "array",
                                                 "items": {