Map the items
For this page:When an order can change
Automatic ordering stops once the list has been visible or interacted with. It also skips a currently visible or focused list. A manual preview can still show each order. Use this for sections below the fold. If the initial order above the fold is essential, use server rendering.Mapping and restoration
Mapping and restoration
Each selector must identify one direct child, either by matching the child or a descendant. Different items must resolve to different children. Every variant includes every item ID exactly once.Missing, ambiguous, or replaced nodes invalidate the mapping. Appended items stay in place. Restoration returns captured nodes to their original mapped slots.
Legacy and server-side ordering
Legacy and server-side ordering
Without
order.items, the legacy adapter requires a data-section ID on every child and reorders all children. It lacks the native adapter’s unmapped-slot preservation and visibility lock.For omitted blocks and multi-pass selection, use the separate funnel library.