Qu'est-ce qu'un composant de défilement infini
Que devons-nous faire lorsque notre page de liste contient des millions de données ? La pagination n'est peut-être pas le meilleur moyen d'en faire l'expérience. Le défilement infini est un meilleur moyen technique pour résoudre ce scénario. Lorsque l'utilisateur fait défiler le contenu, le composant liste de la page suivante est automatiquement ajouté pour charger plus de contenu. Les utilisateurs n'ont pas besoin d'attendre que la page soit préchargée et pour le rendu frontal, un grand nombre de composants ne sont pas rendus à plusieurs reprises, ce qui améliore les performances de rendu des pages. Le défilement infini peut donc offrir une meilleure expérience aux utilisateurs.
Le défilement infini est un mode très courant dans les applications telles que les sites Web de commerce électronique et les backends CMS. Les détaillants en ligne adorent ce modèle de chargement de produits car il permet aux utilisateurs de parcourir de manière transparente tous les produits disponibles dans une catégorie sans avoir à constamment faire une pause et attendre le chargement de la page suivante. [Recommandé :Tutoriel vidéo Vue]
À propos de vue3-infinite-list
Site officiel : https://github.com/tnfe/vue3-infinite-list
vue3-infinite-list
Il s'agit d'un composant de défilement infini court et concis pour vue3. Il est de très petite taille, n'a aucune dépendance sur gzip et ne fait que 3 Ko. Bien qu'il existe de nombreux composants open source à défilement infini liés à vue, par rapport à des produits similaires,vue3-infinite-list
possède encore de nombreuses fonctionnalités qui lui sont propres et utilise entièrementvue3 setup api + typescript
Écrit, le projet LOGO est une chenille à mille pattes ?.vue3-infinite-list
是一个针对vue3的短小精悍的无限滚动组件,它体积非常小、零依赖gzip只有 3kb。虽然vue相关的无限滚动开源组件也有很多,但是对比同类产品vue3-infinite-list
依然有不少自己的特点,并且它完全使用vue3 setup api + typescript
编写,项目LOGO是一只千足毛毛虫? 。
特性
- 体积小 & 零依赖– gzipped 后只有 3kb
- 支持百万级列表渲染, 不费吹灰之力
- 支持滚动到指定条目和指定初始滚动偏移量
- 支持固定和可变宽/高的各类列表
- 支持垂直or水平不同布局的列表
- For Vue3typescript编写
- 使用简单可以结合各类UI库使用
如何使用
使用 npm:
npm install vue3-infinite-list --save
使用 yarn:
yarn add vue3-infinite-list
引用
import InfiniteList from 'vue3-infinite-list';
{{ index + 1 }} : {{ item }}
使用示例
1.基本用法: item固定高度类型, 垂直滚动(默认) demo
使用非常简单,内部可以结合element-plus或者antd-vue、tdesign等UI库。
{{ index + 1 }} : {{ item }}
2.设置滚动方向为水平方向 demo
item{{ index }}
xxxxxxx
xxxxxxx
Primary
这里scrollDirection="horizontal"
可以设置滚动方向为水平。
3.动态控制滚动高度(每一项item高度值是变化的) demo
item {{ index }} : {{ item }}
// 通过这个函数可以动态设置元素宽高. const getItemSize = (i: number): number => { switch (i % 4) { case 1: return 80; case 2: return 50; case 3: return 100; default: return 200; } };
这里getItemSize
是一个有如下语法的函数 :(i: number): number
, 通过这个函数可以动态设置元素宽高。
4.滚动到指定元素位置 demo
item{{ index + 1 }} : {{ item }}
你也可以使用scrollToIndex
来滚动到指定元素。
5.滚动到指定元素 (更精细的对齐方式) demo
item{{ index + 1 }} : {{ item }}
你可以使用scrollToIndex
和scrollToAlignment
属性来指定滚动元素如何与滚动区域对齐, 由四个选项:auto
,start
,center
,end
,分别对应自动对齐、位于容器起始,位于容器中间,位于容器末尾。
6.滚动到指定位置,单位是像素 demo
index: {{ index + 1 }} xxxxxxxxxx Primary Success
你也可以使用scrollOffset
- Petite taille et aucune dépendance– seulement 3 Ko après gzippé
- Prend en charge le rendu de listes de plusieurs millions de niveaux, sans effort
- Prise en charge du défilement vers les éléments spécifiésetSpécifier le décalage de défilement initial
- Prise en charge fixeetVariablediverses listes de largeur/hauteur
- Prend en charge les listes verticalesouhorizontalesavec différentes mises en page < li> Pour Vue3Écriture dactylographiée
- Facile à utiliserPeut être utilisé en combinaison avec diverses bibliothèques d'interface utilisateur
Utiliser npm :
item{{ index + 1 }} 2022-05-01 Name: Tom Button Button
Utiliser fil :
{{ index + 1 }} : {{ item }}
Citer
rrreeerrreeeExemple d'utilisation
< strong>1. Utilisation de base : type d'élément à hauteur fixe, démo à défilement vertical (par défaut) Il est très simple à utiliser et peut être combiné avec element- plus ou des bibliothèques d'interface utilisateur internes telles que antd-vue et tdesign. rrreee2. Définissez la direction de défilement sur la démo horizontalerrreeeIciscrollDirection="horizontal"
peut définir la scroll La direction est horizontale.3. Contrôlez dynamiquement la hauteur de défilement (la valeur de hauteur de chaque élément change) démorrreeerrreeeicigetItemSize code > est une fonction avec la syntaxe suivante :
(i: number): number
Grâce à cette fonction, la largeur et la hauteur de l'élément peuvent être définies dynamiquement.4. Faites défiler jusqu'à la démo de position de l'élément spécifiérrreee Vous pouvez également utiliserscrollToIndex
pour faire défiler jusqu'à l'élément spécifié.5. Faites défiler jusqu'à la démo de l'élément spécifié (alignement fin)rrreeeVous pouvez utiliser les attributsscrollToIndex
etscrollToAlignment
pour spécifier le mode de défilement. les éléments sont alignés avec la zone de défilement a quatre options :auto
,start
,center
,end
, correspondant respectivement. Aligné automatiquement, situé au début du conteneur, au milieu du conteneur et à la fin du conteneur.6. Faites défiler jusqu'à la position spécifiée, l'unité est une démo de pixelsrrreeeVous pouvez également utiliserscrollOffset
pour faire défiler jusqu'à la position spécifiée.
7.支持动态变更数据 demo
item{{ index + 1 }} 2022-05-01 Name: Tom Button Button
只需要动态的改变绑定的data
.
8.设置额外渲染元素的数量 demo
{{ index + 1 }} : {{ item }}
在可见的item上/下再各多渲染额外的
overscanCount
个item。调整它可以帮助减少某些浏览器/设备上的滚动闪烁。
组件的属性和配置
属性 | 类型 | 是否必须? | 描述 |
---|---|---|---|
width | Number or String* | ✓ | 列表宽度. 在滚动方向是'horizontal' 是用于确定滚动元素个数. |
height | Number or String* | ✓ | 列表宽度. 在滚动方向是'vertical' 是用于确定滚动元素个数. |
data | any[] | ✓ | 构建滚动元素的数据 |
itemSize | (index: number): number |
可以是一个固定的宽/高(取决于滚动方向), 一个包含列表所有元素的数组, 或者是返回指定位置元素高度的函数:(index: number): number |
|
scrollDirection | String | 指定滚动方向'vertical' (默认) 或'horizontal' . |
|
scrollOffset | Number | 可以指定滚动位置 | |
scrollToIndex | Number | 可以指定到滚动到哪个元素 | |
scrollToAlignment | String | 结合scrollToIndex 一起用, 用于控制滚动到的元素的对齐方式. 可选:'start' ,'center' ,'end' or'auto' . 使用'start' 将对齐到容器的起始位置,'end' 则对齐到元素的结尾. 使用'center 可以对齐到容器正中间.'auto' 则是滚动到scrollToIndex 指定元素恰好完全可见的位置 |
|
overscanCount | Number | 在可见元素上/下额外渲染的元素数量. 这可以减少在特定浏览器/设备上的闪烁 |
width 在scrollDirection
是'vertical'
时只能是string类型。类似的, Height 在scrollDirection
是'horizontal'
时也只能是string类型*
结尾
一款零依赖,适用于vue的短小精悍的无限滚动加载库的使用方法就介绍完了,是不超级容易上手,赶紧使用起来吧,使用过程中有任何问题,请在此 report it 提报。