# SmileZXLee/uni-z-paging

【uni-app下拉刷新、上拉加载】高性能，全平台兼容(ios、安卓、鸿蒙next、h5以及各家小程序)。支持vue、nvue、vue2、vue3，使用wxs+renderjs实现。支持虚拟列表，支持自定义下拉刷新、上拉加载更多，支持自动管理空数据图、点击返回顶部，支持聊天分页、本地分页，支持国际化等数百项配置，流畅渲染百万级列表数据。

Repository: https://github.com/SmileZXLee/uni-z-paging
Canonical: https://ross.abutalabs.com/products/uni-z-paging
Homepage: https://z-paging.zxlee.cn
Language: JavaScript
License: MIT
License Family: permissive
Topics: uni-app, paging, pagination, pull-refresh, pull-up-loading, refresh, virtual-list
Last push: 2026-07-10T02:44:13+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 91, release rhythm 36, longevity 100
- inputs: {"age_days": 2054, "days_push": 54, "days_rel": 351, "gap_med": 34.0, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1466, forks 101 (observed 2026-08-28T04:04:48.613191+00:00)

## What it is
z-paging is a high-performance paging component for uni-app that provides pull-to-refresh and load-more functionality with fully automatic pagination management. It supports vue2/vue3, nvue, virtual lists for million-item rendering, chat and local pagination modes, and runs across iOS, Android, HarmonyOS Next, H5, and major mini-program platforms.

## Use cases
- add pull-to-refresh and infinite scroll to a uni-app list page
- render very large lists smoothly with a virtual list in a mini program
- build a paginated chat history screen in uni-app
- paginate locally over an already-loaded dataset
- show an empty-state image and back-to-top button automatically for list pages
- implement swipeable tabs with sticky headers and paged lists

## When to choose
- you are building a uni-app project that needs list pagination on multiple platforms
- you want minimal code with automatic pagination state management
- you need high-performance rendering of large lists via virtual list
- you need vue2 and vue3 compatibility in one component

## When to avoid
- your project is not built with uni-app
- you need a plain web (non-uni-app) pagination solution
- you need server-side-only pagination outside the component's model

## Facets
- artifact type: plugin
- maturity: stable
- function: ui-components, state-management, internationalization
- domain: mobile-development, frontend, cross-platform, web-development
- platform: cross-platform
- tags: uni-app, pull-to-refresh, pagination, virtual-list, vue2, vue3, nvue, miniprogram, harmonyos, wxs, renderjs, ios, android, web-server, mobile

## Member repositories
- SmileZXLee/uni-z-paging (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:48.613191+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:35:02.760485+00:00, confidence not recorded.
  - readme: https://github.com/SmileZXLee/uni-z-paging (fetched 2026-08-28T04:04:48.613191+00:00, sha 0471a391c2dc)
  - homepage: https://z-paging.zxlee.cn (fetched 2026-08-29T11:43:46.056870+00:00, sha 5585215948c2)
  - site_page: https://z-paging.zxlee.cn/start/install.html (fetched 2026-08-29T11:43:46.065983+00:00, sha 7c4d6ab3fc22)
- Data as of 2026-08-30T08:39:29.467469+00:00.