{"id":13677291,"url":"https://github.com/minirefresh/minirefresh","last_synced_at":"2025-05-15T15:09:51.392Z","repository":{"id":37734625,"uuid":"100658528","full_name":"minirefresh/minirefresh","owner":"minirefresh","description":"优雅的H5 下拉刷新。零依赖，高性能，多主题，易拓展。(A Graceful HTML5 Drop-Down-Refresh Plugin. )","archived":false,"fork":false,"pushed_at":"2018-04-23T08:59:11.000Z","size":10239,"stargazers_count":1555,"open_issues_count":26,"forks_count":278,"subscribers_count":41,"default_branch":"master","last_synced_at":"2025-03-31T20:08:26.979Z","etag":null,"topics":["css3","js-framework","minirefresh","pull-down-refresh","pull-to-load","pull-to-refresh","pull-up-loading","pull-up-refresh","pulltorefresh","themes"],"latest_commit_sha":null,"homepage":"https://minirefresh.github.io/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/minirefresh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-18T01:06:04.000Z","updated_at":"2025-01-16T01:53:53.000Z","dependencies_parsed_at":"2022-08-08T21:30:43.447Z","dependency_job_id":null,"html_url":"https://github.com/minirefresh/minirefresh","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minirefresh%2Fminirefresh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minirefresh%2Fminirefresh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minirefresh%2Fminirefresh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minirefresh%2Fminirefresh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/minirefresh","download_url":"https://codeload.github.com/minirefresh/minirefresh/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247730069,"owners_count":20986404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css3","js-framework","minirefresh","pull-down-refresh","pull-to-load","pull-to-refresh","pull-up-loading","pull-up-refresh","pulltorefresh","themes"],"created_at":"2024-08-02T13:00:39.966Z","updated_at":"2025-04-07T21:13:41.445Z","avatar_url":"https://github.com/minirefresh.png","language":"JavaScript","funding_links":[],"categories":["目录","JavaScript"],"sub_categories":[],"readme":"# minirefresh\n\n[![](https://img.shields.io/badge/codestyle-eslint-brightgreen.svg)](https://eslint.org/)\n[![](https://img.shields.io/circleci/project/minirefresh/minirefresh/master.svg)](https://circleci.com/gh/minirefresh/minirefresh/tree/master)\n[![](https://img.shields.io/codecov/c/github/minirefresh/minirefresh/master.svg)](https://codecov.io/github/minirefresh/minirefresh?branch=master)\n[![](https://img.shields.io/npm/dm/minirefresh.svg)](https://www.npmjs.com/package/minirefresh)\n[![](https://img.shields.io/npm/v/minirefresh.svg)](https://www.npmjs.com/package/minirefresh)\n[![](https://img.shields.io/npm/l/minirefresh.svg)](https://www.npmjs.com/package/minirefresh)\n[![](https://img.shields.io/gitter/room/nwjs/nw.js.svg)](https://gitter.im/minirefreshjs/minirefresh)\n\n[![](https://saucelabs.com/browser-matrix/minirefreshs.svg)](https://saucelabs.com/beta/builds/62749d602ec849809265f00ba5259eae)\n\n优雅的H5下拉刷新。零依赖，高性能，多主题，易拓展。\n\n[README in English](READM.en.md)\n\n[Docs in English](https://minirefresh.github.io/minirefresh-doc-en/)\n\n### [http://www.minirefresh.com](http://www.minirefresh.com)\n\n## Notice\n\n__喜欢，你就给一个star!__\n\n## 特点\n\n- 零依赖（原生JS实现，不依赖于任何库）\n\n- 多平台支持。一套代码，多端运行，支持Android，iOS，主流浏览器\n\n- 丰富的主题，官方提供多种主题（包括默认，applet-仿小程序，drawer3d-3d抽屉效果，taobao-仿淘宝等）\n\n- 高性能。动画采用css3+硬件加速，在主流手机上流畅运行\n\n- 良好的兼容性。支持和各种Scroll的嵌套（包括mui-scroll,IScroll,Swipe等），支持Vue环境下的使用\n\n- 易拓展，三层架构，专门抽取UI层面，方便实现各种的主题，实现一套主题非常方便，而且几乎可以实现任何的效果\n\n- 优雅的API和源码，API设计科学，简单，源码严谨，所有源码通过`ESlint`检测\n\n- 完善的文档与示例，提供完善的showcase，以及文档\n\n## 官网与文档\n\n[http://www.minirefresh.com](http://www.minirefresh.com)\n\n[https://minirefresh.github.io/](https://minirefresh.github.io/)\n\n## 安装\n\n### NPM\n\n```js\nnpm install minirefresh\n```\n\n[https://www.npmjs.com/package/minirefresh](https://www.npmjs.com/package/minirefresh)\n\n### GIT\n\n```js\ngit clone git://github.com/minirefresh/minirefresh.git\n```\n\n[https://github.com/minirefresh/minirefresh](https://github.com/minirefresh/minirefresh)\n\n## 引入\n\n```html\n\u003clink rel=\"stylesheet\" href=\"xxx/minirefresh.css\" /\u003e\n\u003cscript type=\"text/javascript\" src=\"xxx/minirefresh.js\"\u003e\u003c/script\u003e\n```\n\n### `require`引入\n\n```js\n// 同时支持NPM与文件形式引入\nvar MiniRefreshTools = require('xxx/minirefresh.js');\nrequire('xxx/minirefresh.css');\n```\n\n### `import`引入\n\n```js\n// debug下是.js dist下是.min.js\nimport MiniRefreshTools from 'minirefresh';\nimport 'minirefresh/dist/debug/minirefresh.css'\n```\n\n## 页面布局\n\n```html\n\u003c!-- minirefresh开头的class请勿修改 --\u003e\n\u003cdiv id=\"minirefresh\" class=\"minirefresh-wrap\"\u003e\n    \u003cdiv class=\"minirefresh-scroll\"\u003e        \n    \u003c/div\u003e\n\u003c/div\u003e\n```\n\n## 初始化\n\n```js\n// 引入任何一个主题后，都会有一个 MiniRefresh 全局变量\nvar miniRefresh = new MiniRefresh({\n    container: '#minirefresh',\n    down: {\n        callback: function() {\n            // 下拉事件\n        }\n    },\n    up: {\n\n        callback: function() {\n            // 上拉事件\n        }\n    }\n});\n```\n\n### 结束刷新\n\n```js\n// 结束下拉刷新\nminiRefresh.endDownLoading();\n```\n\n```js\n// 结束上拉加载\n// 参数为true代表没有更多数据，否则接下来可以继续加载\nminiRefresh.endUpLoading(true);\n```\n\n### 更多\n\n更多的使用请参考官方文档\n\n## 效果\n\n### 基础示例\n\n__1. 【基础新闻列表】最基本的下拉刷新使用__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/base_default.gif)\n\n__2. 【多列表单容器】每次切换菜单时刷新容器__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/base_single.gif)\n\n__3. 【多列表多容器】多个列表都有一个Minirefresh对象__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/base_multi.gif)\n\n__4. 【Vue支持】支持Vue下的使用__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/base_vue.gif)\n\n### 嵌套示例\n\n__1. 【Mui-Slider】内部嵌套图片轮播__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/nested_slider.gif)\n\n__2. 【Mui-Scroll】嵌套在Mui-Scroll中__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/nested_muiscroll.gif)\n\n__3. 【Swipe】嵌套在Swipe中__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/nested_swipe.gif)\n\n### 主题示例\n\n__1. 【applet】仿微信小程序主题__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/theme_applet.gif)\n\n__2. 【taobao】仿淘宝刷新主题__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/theme_taobao.gif)\n\n__3. 【drawer3d】3D抽屉效果主题__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/theme_drawer3d.gif)\n\n__4. 【drawer-slider】滑动抽屉效果主题__\n\n![](https://minirefresh.github.io/minirefresh/staticresource/screenshoot/theme_drawerslider.gif)\n\n## showcase\n\n可以直接在线体验效果\n\n[https://minirefresh.github.io/minirefresh/examples/](https://minirefresh.github.io/minirefresh/examples/)\n\n![](https://minirefresh.github.io/minirefresh/staticresource/showcase/qrcode.png)\n\n## 贡献\n\n__`minirefresh`需要你!__\n\n来为项目添砖加瓦，新的`Idea`，新的主题，重大Bug发现，新的设计资源（如图标，官网设计等）\n\n都可以通过`Issue`或`PR`的方式提交！\n\n贡献被采纳后会加入贡献者名单，如果有杰出贡献（如持续贡献），可以加入`Manager`小组，共同开发维护`MiniRefresh`\n\n有共同参与项目意愿的，可以申请成为`Member`，成为`Minirefresh`真正的主人！\n\n更多参考：[https://minirefresh.github.io/minirefresh-doc/site/contribute/howtocontributor.html](https://minirefresh.github.io/minirefresh-doc/site/contribute/howtocontributor.html)\n\n## 讨论\n\n- [gitter](https://gitter.im/minirefreshjs/minirefresh)\n\n- QQ群（`601988892`）\n\n_注意，申请加入群时请添加验证信息，例如：minirefresh使用遇到问题等等_\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminirefresh%2Fminirefresh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fminirefresh%2Fminirefresh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminirefresh%2Fminirefresh/lists"}