CnWidgetGrid

CnWidgetGrid is the per-slot CSS grid renderer used internally by CnPageRenderer when dispatching v2 manifest pages. It receives a flat array of widget entries for a single slot (body, sidebar, header-actions, footer, modal, tab:*, section:*) and lays them out as a CSS grid.

Import

import { CnWidgetGrid } from '@conduction/nextcloud-vue'

When you'd use it directly

Most consumers don't — CnPageRenderer mounts it automatically for every slot present on a v2 manifest page. You'd use it directly only when embedding manifest-driven content inside a custom non-page container (e.g. a modal or a sidebar tab that lives outside the page shell).

Slot column counts

Per ADR-036 Decision 2, the number of columns is determined by the slot name:

Slot	Columns
body	12
header-actions	12
footer	12
modal	12
tab:*	12
section:*	12
sidebar	1

gridWidth values exceeding gridColumns are clamped with a console.warn.

Props

Prop	Type	Description
widgets	Array	Widget entries for this slot (from page.widgets[] filtered by slot).
slotName	String	Slot key (e.g. "body", "sidebar", "tab:general").
registry	Object	Consumer registry from CnAppRoot. Normally injected via cnRegistry; passed as prop only for standalone use.

Widget key resolution

Each entry's widgetKey is looked up in this order:

1. Built-in registry (BUILT_IN_WIDGETS) — covers object-table, form-renderer, map-viewer, card-grid, data, metadata, integration.
2. The consumer registry injected via cnRegistry.

Unknown widget keys are skipped with a console.warn so a stale manifest doesn't blow up rendering of the rest of the slot.

Detail-page object context

On a type:"detail" page, CnPageRenderer loads the page's object and publishes it via the cnDetailObjectContext inject (a reactive { value: { objectData, schema, objectType, objectId, register, store } } holder). CnWidgetGrid merges those fields under each widget's own props, so object-detail widgets — data (CnObjectDataWidget), metadata (CnObjectMetadataWidget), file-manager, … — receive the loaded object without the manifest authoring any per-widget props. Explicit widget.props still win on key collision, and the context is ignored outside a detail page (the holder's value is null).

Spec

• REQ-MVR-004 (manifest-v2-renderer) — per-slot grid renderer
• ADR-036 Decision 2 — column-count convention