# minirefresh/minirefresh

优雅的H5 下拉刷新。零依赖，高性能，多主题，易拓展。(A Graceful HTML5 Drop-Down-Refresh Plugin. )

Repository: https://github.com/minirefresh/minirefresh
Canonical: https://ross.abutalabs.com/products/minirefresh
Homepage: https://minirefresh.github.io/
Language: JavaScript
License: MIT
License Family: permissive
Topics: pulltorefresh, pull-to-refresh, minirefresh, pull-up-refresh, pull-up-loading, pull-down-refresh, pull-to-load, css3, js-framework, themes
Last push: 2018-04-23T08:59:11+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3303, "days_push": 3054, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1539, forks 273 (observed 2026-08-28T04:05:00.344864+00:00)

## What it is
MiniRefresh is a zero-dependency JavaScript library that adds graceful HTML5 pull-down-to-refresh and pull-up-to-load-more functionality to web pages. It offers multiple official themes, CSS3 hardware-accelerated animations, and an extensible three-layer architecture for building custom themes.

## Use cases
- add pull-to-refresh to a mobile web page
- implement pull-up infinite scroll loading in H5 app
- refresh list data on swipe down in mobile browser
- use taobao-style or wechat-miniprogram-style refresh animations
- integrate pull-to-refresh with Vue or IScroll
- build a custom refresh theme for a web app

## When to choose
- you need a dependency-free pull-to-refresh solution for mobile H5 pages
- you want multiple prebuilt refresh themes with easy customization
- you need compatibility with Android, iOS, and mainstream browsers including nested scroll libraries

## When to avoid
- you are building a native mobile app and can use platform-native refresh controls
- your framework already ships a pull-to-refresh component (e.g. Vant, Ant Design Mobile)
- you need a library with recent active development and ongoing maintenance

## Facets
- artifact type: library
- maturity: maintenance
- function: ui-components, animation
- domain: web-development, frontend, mobile-development
- platform: browser, cross-platform
- tags: pull-to-refresh, pull-up-loading, zero-dependency, css3, themes, h5, mobile-web, android, ios

## Member repositories
- minirefresh/minirefresh (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:00.344864+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:30:54.756117+00:00, confidence not recorded.
  - readme: https://github.com/minirefresh/minirefresh (fetched 2026-08-28T04:05:00.344864+00:00, sha b6133c49d33d)
  - homepage: https://minirefresh.github.io/ (fetched 2026-08-29T11:32:38.103633+00:00, sha b0d4a9180900)
  - registry_npm: https://registry.npmjs.org/minirefresh (fetched 2026-08-29T11:32:38.112974+00:00, sha af266bbb523e)
- Data as of 2026-08-30T08:39:29.467469+00:00.