@ezocel/rqgrid-core

Framework-agnostic core engine for RqGrid. Provides virtual scrolling calculations, data windowing, filtering, sorting, grouping, and server-side data fetching utilities.

This package contains no UI framework dependency and is designed to be consumed by framework-specific wrappers such as @ezocel/rqgrid-vue.

Installation

npm install @ezocel/rqgrid-core

API

Constants & Enums

• PropertyOptions / hasOption() — column property flags
• ColumnType — data type identifiers (Text, Numeric, Date, Boolean, etc.)
• FilterType / FilterOperator — filter descriptors
• DEFAULT_ROW_HEIGHT, DEFAULT_FETCH_SIZE, DEFAULT_OVERSCAN — scroll defaults

Virtual Scrolling

• computeVisibleRange(scrollTop, viewportHeight, rowHeight, totalRows, overscan) — returns { start, end } of visible row indices
• computeTotalHeight(totalRows, rowHeight) — returns pixel height for the scroll container
• shouldFetchMore(visibleRange, loadedRange, fetchSize) — determines if more data should be requested
• createScrollState() — creates a reactive scroll tracking object

Data

• fetchRows(url, request) — sends a RowsQuerier request and returns the response
• createDataWindow(fetchSize) — windowed row buffer with automatic eviction

Models

• createSortModel() / SortDirection — multi-column sort state
• createFilterModel() — filter state management
• createGroupModel() — grouping and aggregation state

Schema

• getVisibleColumns(columns, options) — filters columns by visibility
• formatCellValue(value, column) — applies column format to a value
• getCellValue(row, column) — extracts a value from a row

Formatting

• parseFormat(format) / parseRenderer(renderer) / resolveFormat(value, format) — value formatting utilities

License

Copyright (c) 2023-2026 Ezocel S.A.S. All rights reserved. See LICENSE for details.