Skip to content

Commit c55cd81

Browse files
committed
docs(objectui): align the Layout DSL performance note with the #7176 view-level retirement
PR #8252 landed while this branch was open, retiring the pass-through-only list-view virtualScroll under ADR-0049. The replacement section pointed at that key as the real switch; it is no longer authorable (zero entries across the whole authorable surface). Re-pointed at the view's pagination block, matching the wording widget-contract.mdx now carries. Refs #8251
1 parent cd72ac4 commit c55cd81

1 file changed

Lines changed: 8 additions & 5 deletions

File tree

‎content/docs/protocol/objectui/layout-dsl.mdx‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -948,16 +948,19 @@ The Layout DSL has **no** performance surface. A section declares no
948948
(`packages/spec/src/ui/view.zod.ts`) is `.strict()`, so authoring any of them is
949949
a **parse failure** — a loud rejection, not a silent no-op.
950950

951-
Virtualization for large datasets is configured on the **view**, not on a section
952-
or a layout: set the boolean `virtualScroll` on a list-shaped view
953-
(`ListViewSchema`). That is the only virtual-scrolling switch objectui reads —
954-
see [Widget Contract → Performance](/docs/protocol/objectui/widget-contract#performance).
951+
Nor is there an authorable virtual-scrolling switch anywhere else: since 17.0.0
952+
(#7176) the view-level boolean `virtualScroll` is retired too, under ADR-0049
953+
enforce-or-remove — every measured reader only copied the key forward and the
954+
grid renderer never applied it. Large datasets page via the view's `pagination`
955+
block. See
956+
[Widget Contract → Performance](/docs/protocol/objectui/widget-contract#performance).
955957

956958
<Callout type="info">
957959
Earlier revisions of this page documented section-level `virtualScroll` /
958960
`itemHeight` / `lazy` / `source` and a `layout.renderStrategy: progressive`
959961
block. None of them existed on any schema, so they are **removed rather than
960-
implemented**. For the keys a section really accepts, see the
962+
implemented** — real virtualization is an implementation card first. For the
963+
keys a section really accepts, see the
961964
[View Reference](/docs/references/ui/view).
962965
</Callout>
963966

0 commit comments

Comments
 (0)