GET STARTED

Import

Import the canonical standalone component and only the template directives you use.

import {
  NeuralVirtualScroller,
  NeuralVirtualScrollerItemTemplate,
  NeuralVirtualScrollerEmptyTemplate,
  NeuralVirtualScrollerLoadingTemplate,
} from '@neural-ng/core/virtual-scroller';

@Component({
  imports: [
    NeuralVirtualScroller,
    NeuralVirtualScrollerItemTemplate,
    NeuralVirtualScrollerEmptyTemplate,
    NeuralVirtualScrollerLoadingTemplate,
  ],
})

10,000 records

Only the visible window and overscan exist in the DOM. The end index is always exclusive.

Horizontal orientation

The same range engine windows a horizontal card rail without changing its event contract.

Controlled position and imperative scrolling

[(first)], native scrolling and imperative methods remain synchronized.

Lazy ranges and loading

lazyLoad emits each distinct overscanned range for race-safe data sources.

Typed empty and loading templates

State templates receive both the implicit localized label and its named label property.

Unstyled and typed slots

Windowing, dimensions and list semantics remain while consumer classes own every visual choice.

Region and list semantics

The root is a named region. Its viewport is a native list and each rendered record is a listitem.

Keyboard and focus

The viewport remains natively focusable and scrollable. Page Up, Page Down, Home, End and platform scrolling continue to work without custom key interception.

Collection position metadata

Every rendered item exposes aria-posinset and the full collection length through aria-setsize, even though offscreen items are absent.

Reduced motion

Smooth programmatic scrolling falls back to immediate native scrolling when the user requests reduced motion.

SSR and responsibility boundary

The initial range is deterministic during SSR and hydration. Selection, editing and variable-height measurement intentionally belong to composing components or application code.

Component

Inputs and model

Events

Methods

Typed templates and class slots

neuralVirtualScrollerItem, neuralVirtualScrollerEmpty and neuralVirtualScrollerLoading preserve template inference.

Public types

Component tokens