RecyclerConfig

Column count for grid mode. Phase 3 - ignored in Phase 1.

Estimated height per item (px). A fixed number, a Signal<number> for a reactive uniform estimate (e.g. an input() bound after construction), or a (index) => number for genuine per-index variable heights. Only the last form carries per-frame cost; a signal resolves to one uniform value.

Layout mode. 'list' (default) uses padding spacers. 'grid' is Phase 3 - passing it logs a dev-mode warning and falls back to 'list'.

Extra items to render above/below the viewport. Default: 5.

Debounce for scroll events in ms. Default: 16 (~1 frame).

Scroll container. CSS selector, native element, or ElementRef.

Server-side total for A11y (aria-setsize) and "Showing X of Y" display. When not set, totalCount is used.

Delay before skeletons are shown (ms). Default: 0. E.g. 300 means showSkeleton only becomes true after 300ms - fast loads (< 300ms) never show a skeleton.

Async state source. When set, the recycler derives skeleton rendering, refresh state, and empty state from it - same convention as CngxCardGrid, CngxTreetable, CngxPopoverPanel, and CngxDialog.

Total number of items. Reactive - changes on infinite scroll.

Important: For infinite scroll, this is the number of loaded items, not the server-side total. Otherwise the sentinel becomes unreachable.