Collection view

Tier

directive

Surfaces

page

Fallback

literal

State

open

A collection's view, shown on a page: the canonical ::collection-view leaf directive naming the collection and the view to draw. No alternate directive name is interpreted.

::collection-view{src="/collections/tasks" view="Board"}
::collection-view{src="/collections/initiatives" view="All" filter="goal=@page"}

src is the bundle-absolute, extensionless concept id of the direct collections/<name>.md declaration, and view names one of its views. Every further attribute is carried both ways verbatim and means nothing, with one exception: filter, which narrows what this embed lists.

filter's grammar is closed: property=value — one condition, no operators, no lists, no nesting. value is a bundle-absolute path to a document, or the reserved word @page, meaning the page the embed sits on. The narrowing joins the view's saved query and never writes to it, so one view embedded on two pages is narrowed differently by each and changed by neither. A filter naming a property the collection does not declare lists nothing and says so — showing every row is the thing it exists to prevent.

The directive is a view of the declaration only. It never changes the collection's item selector or writes membership.