\n\n### Vue 3 Pull-to-Refresh\n\nA Vue 3 package that enables a pull-to-refresh experience for touch screens.\n\n## Installation\n\nTo install the package, use the following command:\n\n```bash\nnpm i @amirafa/vue3-pull-to-refresh\n```\n\n## Usage\n\n### Props\n\n| Prop | Type | Default | Description |\n| ---------- | --------- | ------- | ---------------------------------------------------------- |\n| `distance` | `Number` | `50` | Specifies the height of pulling. |\n| `duration` | `Number` | `2000` | Delay (in milliseconds) since the refresh action. |\n| `size` | `Number` | `32` | Size of the icon (in pixels). |\n| `ratio` | `Number` | `2.5` | Power of reaching the distance. |\n| `noreload` | `Boolean` | `false` | Reload window on refresh. |\n| `options` | `Object` | `{}` | Customization options for icon color and background color. |\n\n### Options Object Properties\n\n| Property | Type | Default | Description |\n| --------- | -------- | ------- | -------------------------------------------- |\n| `color` | `String` | `#000` | The color of the icon. |\n| `bgColor` | `String` | `#fff` | The background color of the icon or element. |\n\n### Emit\n\n| Emit | Description |\n| ----------- | ----------------------- |\n| `onrefresh` | `Emit after refreshing` |\n\n### Slot\n\n| Slot | Description |\n| --------- | ----------------------------- |\n| `default` | `Customized Element for icon` |\n\n## Example Usage\n\nHere's an example of how to use the `vue3-pull-to-refresh` component in your Vue 3 project:\n\n```vue\n\n {\n console.log('refreshed');\n }\n \"\n />\n\n\n\n```\n\n### Note on `@ts-ignore`\n\nTo prevent TypeScript type-checking errors when importing third-party libraries that may lack complete type definitions, you can use `// @ts-ignore` above the import statement. This directive tells the TypeScript compiler to ignore the next line, avoiding potential type-related warnings or errors.\n\n## Preventing Interference with Chrome Mobile Refresh\n\nTo prevent conflicts with the native refresh mechanism on Chrome Mobile, add the following CSS to the `body`:\n\n```css\nhtml,\nbody {\n overscroll-behavior-y: contain; /* disables vertical PTR bounce */\n}\n```\n\n## Changelog\n\n### [Version 1.2.17] - 2025-12-13\n\n- Fix A high-severity vulnerability related to `validator.js`\n\n### [Version 1.2.16] - 2025-11-30\n\n- Fix janking on `reload-mode`\n- Fix `box-shadow` on pulling\n- Add `z-index:999999`\n\n### [Version 1.2.15] - 2025-11-30\n\n- Fix `box-shadow` on pulling\n\n### [Version 1.2.14] - 2025-11-30\n\n### [Version 1.2.13] - 2025-10-24\n\n- Minor `package.json` fix\n\n### [Version 1.2.12] - 2025-10-21\n\n- Minor fixes\n\n### [Version 1.2.11] - 2025-10-21\n\n#### Added\n\n- Add logo\n\n### [Version 1.2.10] - 2025-10-21\n\n#### Updated\n\n- Rename `coefficient` to `ratio`\n\n### [Version 1.2.9] - 2025-10-21\n\n#### Added\n\n- Add playground\n\n### [Version 1.2.8] - 2025-10-21\n\n#### Updated\n\n- Remove requirement to import Vue3PullToRefresh from \"@amirafa/vue3-pull-to-refresh\";\n\n### [Version 1.2.7] - 2024-11-06\n\n#### Updated\n\n- Remove requirement to import style.css\n\n### [Version 1.2.2] - 2024-11-06\n\n#### Added\n\n- Github packages config\n\n### [Version 1.2.1] - 2024-11-06\n\n#### Updated\n\n- add ChangeLog to README\n\n### [Version 1.2.1] - 2024-11-06\n\n#### Fixed\n\n- bug on interference with touch clicks\n\n---\n","readmeFilename":"README.md"}
![vue3-pull-to-refresh-logo","directories":{},"_nodeVersion":"22.11.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vue":"^3.4.0","vite":"^5.0.0","vue-tsc":"^2.0.0","typescript":"^5.5.0","vite-plugin-dts":"^4.0.0","@vitejs/plugin-vue":"^5.0.0","javascript-obfuscator":"^4.1.1","vite-plugin-css-injected-by-js":"^3.5.2"},"peerDependencies":{"vue":"^3.4.0"},"_npmOperationalInternal":{"tmp":"tmp/vue3-pull-to-refresh_1.2.11_1761121162942_0.9619363664316452","host":"s3://npm-registry-packages-npm-production"}},"1.2.12":{"name":"@amirafa/vue3-pull-to-refresh","version":"1.2.12","keywords":["vue","vue3","pull-to-refresh","vue-component","refresh","ui-component"],"author":{"name":"Amirafa","email":"amir.h.rafati@gmail.com"},"license":"MIT","_id":"@amirafa/vue3-pull-to-refresh@1.2.12","maintainers":[{"name":"amirafa","email":"amir.h.rafati@gmail.com"}],"homepage":"https://github.com/amirafa/vue3-pull-to-refresh#readme","bugs":{"url":"https://github.com/amirafa/vue3-pull-to-refresh/issues"},"dist":{"shasum":"953cdb90455ba28254202b5a1dad7f72763194ce","tarball":"https://registry.npmjs.org/@amirafa/vue3-pull-to-refresh/-/vue3-pull-to-refresh-1.2.12.tgz","fileCount":10,"integrity":"sha512-rwnVbQBFUr7V0YGokjn2Z02I6e7aabA5djvIkAaOCzcSgKYEywk80GFuYS9pwqiHiqmTPQXJFrBQNwKuxPWfMg==","signatures":[{"sig":"MEYCIQCxOmTy78XYQOL5wLaiCYyN5nser/C8ADAft0e6fXs6awIhAIh6EEUnc6Py5COhLo/+T6UzxcSc0qo4HaTaqCVKgeCZ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34583},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.es.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.es.js","require":"./dist/index.cjs"},"./dist/style.css":"./dist/style.css"},"gitHead":"554611ceda8145299235ac54454a061f1f8b00cc","scripts":{"dev":"vite","build":"vite build && vue-tsc --emitDeclarationOnly","preview":"vite preview"},"_npmUser":{"name":"amirafa","email":"amir.h.rafati@gmail.com"},"repository":{"url":"git+https://github.com/amirafa/vue3-pull-to-refresh.git","type":"git"},"_npmVersion":"10.7.0","description":"Lightweight Vue 3 package that enables a pull-to-refresh experience for touch screens.","directories":{},"_nodeVersion":"20.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vue":"^3.4.0","vite":"^5.0.0","vue-tsc":"^2.0.0","typescript":"^5.5.0","vite-plugin-dts":"^4.0.0","@vitejs/plugin-vue":"^5.0.0","javascript-obfuscator":"^4.1.1","vite-plugin-css-injected-by-js":"^3.5.2"},"peerDependencies":{"vue":"^3.4.0"},"_npmOperationalInternal":{"tmp":"tmp/vue3-pull-to-refresh_1.2.12_1761165557235_0.9870833201761582","host":"s3://npm-registry-packages-npm-production"}},"1.2.13":{"name":"@amirafa/vue3-pull-to-refresh","version":"1.2.13","keywords":["vue","vue3","pull-to-refresh","vue-component","refresh","ui-component"],"author":{"name":"Amirafa","email":"amir.h.rafati@gmail.com"},"license":"MIT","_id":"@amirafa/vue3-pull-to-refresh@1.2.13","maintainers":[{"name":"amirafa","email":"amir.h.rafati@gmail.com"}],"homepage":"https://github.com/amirafa/vue3-pull-to-refresh#readme","bugs":{"url":"https://github.com/amirafa/vue3-pull-to-refresh/issues"},"dist":{"shasum":"03ab3bcab4ed331d6cfbf56d700f743eb8214964","tarball":"https://registry.npmjs.org/@amirafa/vue3-pull-to-refresh/-/vue3-pull-to-refresh-1.2.13.tgz","fileCount":10,"integrity":"sha512-iWOitVQt04n9e4dJ5f2X+KI/DDtDAGdMuXxuj3xrHiNPQoWrOWeeQ9n1AmjQkksWfc5q5hA1PjXsf8w8fHJzug==","signatures":[{"sig":"MEYCIQCZNK3xXK1wZCrvE8ogPyUdBirakI8BS5+U32j82R5Q1gIhALHqb7ILeHVe4rmluj7DPWDRtHq3LrzYp11X6eiCAZcf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34652},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.es.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.es.js","require":"./dist/index.cjs"},"./dist/style.css":"./dist/style.css"},"gitHead":"b527b4a479274e4536f5320db46cc4a0b0f452c1","scripts":{"dev":"vite","build":"vite build && vue-tsc --emitDeclarationOnly","preview":"vite preview"},"_npmUser":{"name":"amirafa","email":"amir.h.rafati@gmail.com"},"repository":{"url":"git+https://github.com/amirafa/vue3-pull-to-refresh.git","type":"git"},"_npmVersion":"10.7.0","description":"Lightweight Vue 3 package that enables a pull-to-refresh experience for touch screens.","directories":{},"_nodeVersion":"20.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vue":"^3.4.0","vite":"^5.0.0","vue-tsc":"^2.0.0","typescript":"^5.5.0","vite-plugin-dts":"^4.0.0","@vitejs/plugin-vue":"^5.0.0","javascript-obfuscator":"^4.1.1","vite-plugin-css-injected-by-js":"^3.5.2"},"peerDependencies":{"vue":"^3.4.0"},"_npmOperationalInternal":{"tmp":"tmp/vue3-pull-to-refresh_1.2.13_1761319535940_0.40731432504682763","host":"s3://npm-registry-packages-npm-production"}},"1.2.16":{"name":"@amirafa/vue3-pull-to-refresh","version":"1.2.16","keywords":["vue","vue3","pull-to-refresh","vue-component","refresh","ui-component"],"author":{"name":"Amirafa","email":"amir.h.rafati@gmail.com"},"license":"MIT","_id":"@amirafa/vue3-pull-to-refresh@1.2.16","maintainers":[{"name":"amirafa","email":"amir.h.rafati@gmail.com"}],"homepage":"https://github.com/amirafa/vue3-pull-to-refresh#readme","bugs":{"url":"https://github.com/amirafa/vue3-pull-to-refresh/issues"},"dist":{"shasum":"42fb7225e097ed034c8f8a417a16e38d466e172a","tarball":"https://registry.npmjs.org/@amirafa/vue3-pull-to-refresh/-/vue3-pull-to-refresh-1.2.16.tgz","fileCount":10,"integrity":"sha512-a6m2lAucm+XL/THp3RiN2Tz9ughGnVkuVb9wZ7yG1X962mUx5T7E6cSPm8UVL1RE+N5/Y9LEMxPMqc+Akxe2fw==","signatures":[{"sig":"MEUCIH//B1OR2Q3k57SLMVmbK3cjc87uMdZ7v8wcJmVI5mApAiEA3gCKzDsPAF8VncKw+j6NLv5pP/5bw0eH+6P3uwvU6eo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34580},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.es.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.es.js","require":"./dist/index.cjs"},"./dist/style.css":"./dist/style.css"},"gitHead":"fe5e780c6fe6f7e2f8b9550a0bedcc39ec1a9ff5","scripts":{"dev":"vite","build":"vite build && vue-tsc --emitDeclarationOnly","preview":"vite preview"},"_npmUser":{"name":"amirafa","email":"amir.h.rafati@gmail.com"},"repository":{"url":"git+https://github.com/amirafa/vue3-pull-to-refresh.git","type":"git"},"_npmVersion":"10.9.4","description":"Lightweight Vue 3 package that enables a pull-to-refresh experience for touch screens.","directories":{},"_nodeVersion":"22.21.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vue":"^3.4.0","vite":"^5.0.0","vue-tsc":"^2.0.0","typescript":"^5.5.0","vite-plugin-dts":"^4.0.0","@vitejs/plugin-vue":"^5.0.0","javascript-obfuscator":"^4.1.1","vite-plugin-css-injected-by-js":"^3.5.2"},"peerDependencies":{"vue":"^3.4.0"},"_npmOperationalInternal":{"tmp":"tmp/vue3-pull-to-refresh_1.2.16_1764492863436_0.06214262480266086","host":"s3://npm-registry-packages-npm-production"}},"1.2.17":{"name":"@amirafa/vue3-pull-to-refresh","description":"Lightweight Vue 3 package that enables a pull-to-refresh experience for touch screens.","version":"1.2.17","type":"module","main":"./dist/index.cjs","module":"./dist/index.es.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.es.js","require":"./dist/index.cjs"},"./dist/style.css":"./dist/style.css"},"scripts":{"dev":"vite","build":"vite build && vue-tsc --emitDeclarationOnly","preview":"vite preview"},"repository":{"type":"git","url":"git+https://github.com/amirafa/vue3-pull-to-refresh.git"},"publishConfig":{"access":"public"},"keywords":["vue","vue3","pull-to-refresh","vue-component","refresh","ui-component"],"author":{"name":"Amirafa","email":"amir.h.rafati@gmail.com"},"license":"MIT","bugs":{"url":"https://github.com/amirafa/vue3-pull-to-refresh/issues"},"homepage":"https://github.com/amirafa/vue3-pull-to-refresh#readme","peerDependencies":{"vue":"^3.4.0"},"devDependencies":{"vite-plugin-css-injected-by-js":"^3.5.2","@vitejs/plugin-vue":"^5.0.0","javascript-obfuscator":"^4.1.1","typescript":"^5.5.0","vite":"^5.0.0","vite-plugin-dts":"^4.0.0","vue":"^3.4.0","vue-tsc":"^2.0.0"},"_id":"@amirafa/vue3-pull-to-refresh@1.2.17","gitHead":"d8352c85b336f49ac172bd5798264f5f3889e37a","_nodeVersion":"22.21.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-9ULw/A61XjqOhU7v9QovmPhb/KMrFmmrnB/A44ubkyTWTjs3kVcyws2dgkyxHsHwuZ5q3gYcvCCaiqIV2swlmg==","shasum":"8428b63589a8541684be2b3583ee36c9b4ecb605","tarball":"https://registry.npmjs.org/@amirafa/vue3-pull-to-refresh/-/vue3-pull-to-refresh-1.2.17.tgz","fileCount":10,"unpackedSize":34679,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHiq4tBJlL/0chhwpEfg2aomtOHvw62ZNoPHckboMYBJAiEAhQVOKry2uXXCGjau+4qzhyGEdSPLu1HzNX7rWsLUOtg="}]},"_npmUser":{"name":"amirafa","email":"amir.h.rafati@gmail.com"},"directories":{},"maintainers":[{"name":"amirafa","email":"amir.h.rafati@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/vue3-pull-to-refresh_1.2.17_1765627355908_0.9109938664810115"},"_hasShrinkwrap":false}},"time":{"created":"2024-11-03T10:12:35.254Z","modified":"2025-12-13T12:02:36.267Z","3.0.0":"2024-11-03T10:12:35.560Z","3.0.1":"2024-11-03T10:23:00.382Z","3.0.2":"2024-11-03T10:25:20.407Z","3.0.3":"2024-11-03T11:12:29.499Z","3.0.4":"2024-11-03T11:57:53.159Z","3.0.5":"2024-11-03T12:00:05.357Z","3.0.6":"2024-11-03T12:01:51.816Z","1.0.0":"2024-11-03T12:16:02.503Z","1.0.1":"2024-11-03T13:31:00.354Z","1.0.2":"2024-11-03T13:37:45.212Z","1.0.4":"2024-11-03T15:30:33.687Z","1.0.5":"2024-11-03T15:40:40.107Z","1.0.6":"2024-11-03T15:45:26.129Z","1.0.7":"2024-11-03T16:29:25.087Z","1.0.8":"2024-11-03T16:31:32.751Z","1.0.9":"2024-11-03T20:22:12.379Z","1.2.0":"2024-11-04T12:02:27.650Z","1.2.1":"2024-11-05T20:50:14.388Z","1.2.2":"2024-11-05T20:56:11.616Z","1.2.4":"2024-11-06T10:08:37.470Z","1.2.5":"2024-12-11T07:55:06.070Z","1.2.6":"2024-12-11T09:09:41.062Z","1.2.7":"2024-12-11T13:13:56.205Z","1.2.8":"2025-10-21T13:01:14.855Z","1.2.9":"2025-10-21T13:04:07.642Z","1.2.10":"2025-10-21T13:10:48.988Z","1.2.11":"2025-10-22T08:19:23.155Z","1.2.12":"2025-10-22T20:39:17.444Z","1.2.13":"2025-10-24T15:25:36.129Z","1.2.14":"2025-11-30T08:25:12.615Z","1.2.15":"2025-11-30T08:44:33.955Z","1.2.16":"2025-11-30T08:54:23.626Z","1.2.17":"2025-12-13T12:02:36.064Z"},"bugs":{"url":"https://github.com/amirafa/vue3-pull-to-refresh/issues"},"author":{"name":"Amirafa","email":"amir.h.rafati@gmail.com"},"license":"MIT","homepage":"https://github.com/amirafa/vue3-pull-to-refresh#readme","keywords":["vue","vue3","pull-to-refresh","vue-component","refresh","ui-component"],"repository":{"type":"git","url":"git+https://github.com/amirafa/vue3-pull-to-refresh.git"},"description":"Lightweight Vue 3 package that enables a pull-to-refresh experience for touch screens.","maintainers":[{"name":"amirafa","email":"amir.h.rafati@gmail.com"}],"readme":"<p align=\"center\">\n <a href=](https://i.postimg.cc/PqqK5WcJ/Vue3-Pull-To-Refresh-logo.png){kind=logo}
\n