Virtual scroller

The v-virtual-scroll component displays a virtual, infinite list. It supports dynamic height and scrolling vertically and is a good alternative to pagination.

Basic

The virtual scroller displays just enough records to fill the viewport and uses the existing component, rehydrating it with new data.

Item 1
Item 2
Item 3
Item 4
Item 5
Item 6
Item 7
Item 8
Item 9
Item 10
Item 11
Item 12
Item 13
Item 14
Item 15
Item 16
Item 17
Item 18
Item 19

Guide

The v-virtual-scroll allows you to display thousands of records on a single page without the performance hit of actually showing all of them at once. v-virtual-scroll is devoid of styling and pairs well with components such as v-card to provide a better visual experience.

Height

The v-virtual-scroll component does not have any initial height set on itself.
The following code snippet uses the height prop.

Virtual Item 1
Virtual Item 2
Virtual Item 3
Virtual Item 4
Virtual Item 5
Virtual Item 6
Virtual Item 7
Virtual Item 8
Virtual Item 9
Virtual Item 10
Virtual Item 11
Virtual Item 12
Virtual Item 13

Another way of making sure that the component has height is to place it inside an element with display: flex.

Virtual Item 1
Virtual Item 2
Virtual Item 3
Virtual Item 4
Virtual Item 5
Virtual Item 6
Virtual Item 7
Virtual Item 8
Virtual Item 9
Virtual Item 10
Virtual Item 11
Virtual Item 12
Virtual Item 13
Virtual Item 14
Virtual Item 15
Virtual Item 16

Item Height

For lists where the item height is static and uniform for all items, it’s recommended that you define a specific item-height. This value is used for v-virtual-scroll's calculations.

Company Employee List
Employee Name
Badge #1
Employee Name
Badge #2
Employee Name
Badge #3
Employee Name
Badge #4
Employee Name
Badge #5
Employee Name
Badge #6
Employee Name
Badge #7

If your items are not of a uniform size, omit the item-height prop to have v-virtual-scroll dynamically calculate each item.

Dynamic item 1
Dynamic item 2
Dynamic item 3
Dynamic item 4
Dynamic item 5
Dynamic item 6
Dynamic item 7
Dynamic item 8
Dynamic item 9
Dynamic item 10
Dynamic item 11
Dynamic item 12
Dynamic item 13
Dynamic item 14
Dynamic item 15
Dynamic item 16
Dynamic item 17
Dynamic item 18
Dynamic item 19
Dynamic item 20
Dynamic item 21
Dynamic item 22
Dynamic item 23
Dynamic item 24
Dynamic item 25

User Directory

The v-virtual-scroll component can render an large amount of items by rendering only what it needs to fill the scroller’s viewport.

User Directory
Lorem ipsum dolor sit, amet consectetur adipisicing elit. Quasi nobis a at voluptates culpa optio amet! Inventore deserunt voluptatem maxime a veniam placeat, eos impedit nulla quos? Officiis, aperiam ducimus.
J D
James Davis
O P
Olivia Perez
J C
John Carter
O R
Olivia Roberts
H K
Harry King
J W
Joe Walker
D J
Daniel Johnson
M S
Margaret Scott
J H
Joe Hernandez
CONTENTS
  • Introduction

  • Basic

  • Guide

  • Height

  • Item Height

  • User Directory