Collection of essential Vue Composition Utilities
ð Features
- ðŠ Interactive docs & demos
- ⥠Fully tree shakeable: Only take what you want, bundle size
- ðĶū Type Strong: Written in TypeScript, with TS Docs
- ð SSR Friendly
- ð No bundler required: Usable via CDN
- ðĐ Flexible: Configurable event filters and targets
- ð Optional Add-ons: Router, Firebase, RxJS, etc.
ðĶ Usage
import { useLocalStorage, useMouse, usePreferredDark } from '@vueuse/core'
const { x, y } = useMouse()
// if user prefers dark theme
const isDark = usePreferredDark()
// persist state in localStorage
const store = useLocalStorage(
'my-storage',
{
name: 'Apple',
color: 'red',
},
)
Refer to functions list or documentations for more details.
ðĶ Install
From v12.0, VueUse no longer supports Vue 2. Please use v11.x for Vue 2 support.
npm i @vueuse/core
Demos
CDN
<script src="https://unpkg.com/@vueuse/shared"></script>
<script src="https://unpkg.com/@vueuse/core"></script>
It will be exposed to global as window.VueUse
ðŠī Project Activity
ð§ą Contribute
See the Contributing Guide
ðļ Thanks
This project is heavily inspired by the following awesome projects.
And thanks to all the contributors on GitHub!
ðĻâð Contributors
Financial Contributors on Open Collective
ð License
MIT License ÂĐ 2019-PRESENT Anthony Fu