๐ ๏ธ Vue kit of useful Vue Composition API functions.
npm install vue-use-kit
Since Vue 3.0 has not yet been released, you must also install @vue/composition-api library, which will enable the composition API in Vue 2.0.
npm install @vue/composition-api
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)
<template>
<div>isDesktop: {{ isDesktop ? 'Yes' : 'No' }}</div>
</template>
<script lang="ts">
import Vue from 'vue'
import { useMedia } from 'vue-use-kit'
export default Vue.extend({
name: 'UseMedia',
setup() {
const query = '(min-width: 1024px)'
const isDesktop = useMedia(query)
return { isDesktop }
}
})
</script>
- Sensors
useGeolocation
โ tracks geolocation state of user's device.useHover
โ tracks mouse hover state of a given element.useIdle
โ tracks whether user is being inactive.useIntersection
โ tracks intersection of target element with an ancestor element.useLocation
โ tracks bar navigation location state.useMedia
โ tracks state of a CSS media query.useMediaDevices
โ tracks connected hardware devices.useMouse
โ tracks the mouse position.useMouseElement
โ tracks the mouse position relative to given element.useMouseLeavePage
โ tracks when mouse leaves page boundaries.useOrientation
โ tracks state of device's screen orientation.useSize
โ tracks size of an HTML element.useScroll
โ tracks an HTML element's scroll position.useScrollbarWidth
โ gets current browser's scrollbar width.useSearchParams
โ tracks browser's location search params.useWindowSize
โ tracksWindow
scroll position.
- Animations
useInterval
โ updatescounter
value repeatedly on a fixed time delay.useIntervalFn
โ calls function repeatedly on a fixed time delay.useRaf
โ returnselapsedTime
with requestAnimationFrame.useRafFn
โ calls function with requestAnimationFrame.useTimeout
โ returnsisReady
true when timer is completed.useTimeoutFn
โ calls function when timer is completed.
- Side Effects
useBeforeUnload
โ shows browser alert when user try to reload or close the page.useCookie
โ provides way to read, update and delete a cookie.useLocalStorage
โ provides way to read, update and delete a localStorage key.useSessionStorage
โ provides way to read, update and delete a sessionStorage key.
- UI
useClickAway
โ triggers callback when user clicks outside target area.useFullscreen
โ display an element in full-screen mode
- Utils
getQuery
โ get a CSS media query string.