v3.2.0

Changes

💡 It is strongly recommended to upgrade to this version.

Breaking Changes & Upgrade Guide

• Scoped Slot Properties Renamed: To improve readability and adhere to better naming conventions, the properties exposed by the item scoped slot have been changed. Please update your template code after upgrading:
  • record has been renamed to item
  • dateKey has been renamed to key
  • Example of the required change:

    <!-- Before -->
    <template v-slot:item="{ record, index, dateKey }">
      <p>{{ index }}</p>
    </template>
    
    <!-- After -->
    <template v-slot:item="{ item, index, key }">
      <p>{{ index }}</p>
    </template>

Features

• Function support for dataKey: The dataKey prop now accepts a function (e.g., (item) => item.id) in addition to a string path (like 'a.b.c').
• New scroll event emitted: Added a new @scroll event listener to easily capture detailed scroll states. The event payload includes: { top, bottom, offset, direction }.

Core Updates

• Eliminated jitter: Improved rendering behavior in edge cases to ensure a much smoother experience during virtual scrolling and dragging.
• Fixed scroll offset calculation: Resolved issues with retrieving the correct offset during scrolling, enhancing the accuracy of positioning.
• Performance optimization: Further optimized rendering performance and reduced unnecessary calculation overhead.

Build & Chores

• Modernized build outputs (UMD to CJS + ESM). Dropped the legacy UMD build in favor of modern ES Modules and CommonJS.