v12.4.0

Compare Source

   🚀 Features

• Use passive event handlers everywhere is possible  -  by @​ferferga and @​antfu in https://github.com/vueuse/vueuse/issues/4477 (dd316)
• useCloned: Return isModified  -  by @​pkc918 and @​antfu in https://github.com/vueuse/vueuse/issues/4470 (6018c)
• useStorage: Make storage key reactive  -  by @​EvgenyWas and @​antfu in https://github.com/vueuse/vueuse/issues/4464 (eb679)

   🐞 Bug Fixes

• useBluetooth: IsConnected state not changed when disconnected  -  by @​ilyaliao, @​antfu and @​ferferga in https://github.com/vueuse/vueuse/issues/4460 (fcc6e)

    View changes on GitHub

v12.3.0

Compare Source

   🚀 Features

• onElementRemoval: New function, refactor useActiveElement useElementHover  -  by @​ben-lau and @​antfu in https://github.com/vueuse/vueuse/issues/4410 (08cf5)
• router: Support partial transform  -  by @​alexchexes and @​antfu in https://github.com/vueuse/vueuse/issues/4426 (bba3f)
• toArray: New utility function  -  by @​coderwhytop and @​antfu in https://github.com/vueuse/vueuse/issues/4432 (021d0)
• toValue: Deprecate toValue from @vueuse/shared in favor of Vue's native  -  by @​antfu (59f75)
• useElementBounding: Added directive for vElementBounding  -  by @​pkc918 in https://github.com/vueuse/vueuse/issues/4436 (67a9c)
• useMouseInElement: Added directive for vMouseInElement  -  by @​pkc918 in https://github.com/vueuse/vueuse/issues/4438 (34be5)
• useMousePressed: Add onPressed and onReleased as options  -  by @​OrbisK in https://github.com/vueuse/vueuse/issues/4425 (a123a)
• useToNumber: method support custom function  -  by @​btea and @​antfu in https://github.com/vueuse/vueuse/issues/4441 (635bb)
• useWindowScroll: Use useScroll under the hood  -  by @​OrbisK and @​antfu in https://github.com/vueuse/vueuse/issues/4424 (a033e)

   🐞 Bug Fixes

• useAxios: Narrow type of data when initialValue is provided  -  by @​huang-julien and @​antfu in https://github.com/vueuse/vueuse/issues/4419 (8502f)
• useClipboard,useClipboardItems: Avoid running "copied" timeout during initialization  -  by @​Ingramz in https://github.com/vueuse/vueuse/issues/4299 (6860f)
• useDropZone: Validate all file types individually when dropping multiple files  -  by @​LouisMazel in https://github.com/vueuse/vueuse/issues/4325 (b01cf)
• useFocusWithin: Correctly track the state when switching the focus of elements in the same container  -  by @​ben-lau in https://github.com/vueuse/vueuse/issues/4394 (3ca0d)
• useRouteQuery: Differentiate undefined and null when writing value  -  by @​aa-ndrej and @​antfu in https://github.com/vueuse/vueuse/issues/4382 (0cc45)
• useSpeechRecognition: Execute 'start' when not ended  -  by @​byronogis and @​antfu in https://github.com/vueuse/vueuse/issues/4119 (890ab)
• useStorageAsync: Correct initialization when initialValue is getter  -  by @​Mini-ghost and @​antfu in https://github.com/vueuse/vueuse/issues/4452 (e6a17)
• useTimeoutPoll: immediate default value should be true  -  by @​phk422 and @​antfu in https://github.com/vueuse/vueuse/issues/4232 (0450d)
• useTimeoutPoll: Only start by default at client  -  by @​antfu (a5fb0)

    View changes on GitHub

v12.2.0

Compare Source

   🚀 Features

• useArrayDifference: New symmetric option  -  by @​wangliangxin, wangliangxin3 and @​antfu in https://github.com/vueuse/vueuse/issues/4146 (46fdc)
• useEventSource: New autoConnect option to align with useWebSocket  -  by @​ferferga and @​antfu in https://github.com/vueuse/vueuse/issues/4204 (230f8)
• useImage: Support more native option  -  by @​btea and @​antfu in https://github.com/vueuse/vueuse/issues/4173 (4ca72)
• usePreferredReducedTransparency: Add new function  -  by @​huiliangShen and @​antfu in https://github.com/vueuse/vueuse/issues/4201 (34cd7)

   🐞 Bug Fixes

• useWebSocket: Clear retryTimer when connected  -  by @​ilyaliao and @​antfu in https://github.com/vueuse/vueuse/issues/4383 (ffa00)

    View changes on GitHub

v12.1.0

Compare Source

   🚀 Features

• createEventHook: Add clear function  -  by @​ilyaliao in https://github.com/vueuse/vueuse/issues/4378 (40265)
• useBase64: Add options for Data URL output control  -  by @​ilyaliao and Jelf in https://github.com/vueuse/vueuse/issues/4316 (4b4bd)
• useDeviceMotion: Add permission controls, improve destructure  -  by @​thefeymesaleng and @​antfu in https://github.com/vueuse/vueuse/issues/4127 (cf729)
• useElementVisibility: Add rootMargin option  -  by @​dritter and @​antfu in https://github.com/vueuse/vueuse/issues/4100 (3a928)
• useMediaControls: Add 'media' option to define media query for resources  -  by @​aaronLejeune in https://github.com/vueuse/vueuse/issues/4344 (209de)
• useRafFn: Allow framerate to be a reactive value  -  by @​OrbisK and Anthony Fu in https://github.com/vueuse/vueuse/issues/4409 (4759f)
• useSSRWidth: Add optional support for SSR in useMediaQuery and useBreakpoints  -  by @​Tofandel, Anthony Fu and @​antfu in https://github.com/vueuse/vueuse/issues/4317 (55965)
• useUrlSearchParams: Add writeMode options  -  by @​ishakhorski, Ivan Shakhorski and @​antfu in https://github.com/vueuse/vueuse/issues/4392 (2c972)
• useWebSocket: Introduce autoConnect options to control auto connections on url changes  -  by @​ilyaliao and @​antfu in https://github.com/vueuse/vueuse/issues/4417 (05e75)
• useWebsocket: Support ref or getter as message  -  by @​SnowGuest, Anthony Fu and @​antfu in https://github.com/vueuse/vueuse/issues/4116 (a72c0)
• useWindowSize: Add type: visual option that leverage visualViewport  -  by @​huiliangShen and @​antfu in https://github.com/vueuse/vueuse/issues/4395 (e78ef)

   🐞 Bug Fixes

• injectLocal: Allow inject to app context  -  by @​antfu (b08a9)
• useAsyncState: Use ShallowRef instead of Ref type  -  by @​joris-gallot and Anthony Fu in https://github.com/vueuse/vueuse/issues/4294 (4d0a7)
• useDropZone: Update type to allow readonly array param  -  by @​briankchan in https://github.com/vueuse/vueuse/issues/4319 (df363)
• useFetch: Handle empty payload  -  by @​ilyaliao in https://github.com/vueuse/vueuse/issues/4366 (8a89d)
• useMediaQuery: The return value should be computed  -  by @​alexzhang1030 and @​antfu in https://github.com/vueuse/vueuse/issues/4403 (3af75)
• useRouteParams,useRouteQuery: Set route param/query to undefined when defaultValue is ref or getter  -  by @​vojvodics and Anthony Fu in https://github.com/vueuse/vueuse/issues/3977 (23fdb)
• useScroll: To properly report arriveState for elastic scroll  -  by @​719media and Anthony Fu in https://github.com/vueuse/vueuse/issues/4133 (90ff4)
• useTextareaAutosize: Make input required  -  by @​axuj, @​antfu and Anthony Fu in https://github.com/vueuse/vueuse/issues/4129 (25ed2)
• useWebNotification: Prevent notifications when checking for support  -  by @​9romise in https://github.com/vueuse/vueuse/issues/4019 (01f92)
• useWebSocket: Close socket connection inside WebWorker fix  -  by @​catz in https://github.com/vueuse/vueuse/issues/4229 (ece6a)

    View changes on GitHub

v12.0.0

Compare Source

   🚨 Breaking Changes

• Drop Vue 2 support, optimize bundles and clean up  -  by @​antfu in https://github.com/vueuse/vueuse/issues/4349 (0a9ed)

[!NOTE]
To Vue 3 users, v12.0.0 is equivalent to v11.3.0 on behaviors, only to remove some Vue 2 specific handling and will be slightly lighter. We expect future development to contain on v12.x and forward, and only backport if there are security issues. This means that VueUse would no longer be active on Vue 2 support.

    View changes on GitHub

v11.3.0

Compare Source

   🚀 Features

• OnClickOutside: Support component with fragments  -  by @​ilyaliao in https://github.com/vueuse/vueuse/issues/4313 (fe322)
• router: Transform get / set  -  by @​Akryum, Anthony Fu and @​antfu in https://github.com/vueuse/vueuse/issues/4326 (65aa0)
• useFetch: Infer 'json' type for array payloads  -  by @​WingSMC, Gergely Dremak and @​antfu in https://github.com/vueuse/vueuse/issues/4329 (3d29c)

   🐞 Bug Fixes

• useFetch: Ensure single slash  -  by @​mrchar and @​antfu in https://github.com/vueuse/vueuse/issues/4296 (3de68)
• useMouse: Record the previous scroll value  -  by @​pkc918 and Anthony Fu in https://github.com/vueuse/vueuse/issues/4244 (e8d11)
• useMouse: Correct spelling error  -  by @​pkc918 in https://github.com/vueuse/vueuse/issues/4348 (cceeb)
• useRouteParams, useRouteQuery: Effect triggers twice with object getter as watch source  -  by @​jack-allocate and Anthony Fu in https://github.com/vueuse/vueuse/issues/4283 (44772)
• useSortable: Wrong order of elements  -  by @​ilyaliao in https://github.com/vueuse/vueuse/issues/4332 (9e78e)
• useSwipe: Allow vertical scrolling during swipe  -  by @​ilyaliao in https://github.com/vueuse/vueuse/issues/4323 (1bb54)
• useUrlSearchParams: hash mode missing location.search  -  by @​Huodoo, 霍冬冬 and @​antfu in https://github.com/vueuse/vueuse/issues/4340 (e77ca)

    View changes on GitHub

v11.2.0

Compare Source

   🚀 Features

• useBreakpoints: Add breakpoints for ElementUI/ElementPlus  -  by @​AAABingBing and Anthony Fu in https://github.com/vueuse/vueuse/issues/4238 (f71e5)
• useMediaControls: Add playback error event  -  by @​DarrenSG and Anthony Fu in https://github.com/vueuse/vueuse/issues/4253 (e1169)

   🐞 Bug Fixes

• useArrayReduce: InitialValue can be a function  -  by @​Mutter45 and Anthony Fu in https://github.com/vueuse/vueuse/issues/4243 (ae542)
• useDevicesList: Handle NotAllowedError on reject/close  -  by @​espensgr and Anthony Fu in https://github.com/vueuse/vueuse/issues/4246 (bf0f2)
• useDropZone: Remove file kind restriction  -  by @​jackcodetw in https://github.com/vueuse/vueuse/issues/4305 (1d661)
• useIntervalFn: Prevent timer being set after pause is called in cb  -  by @​laporchen and Anthony Fu in https://github.com/vueuse/vueuse/issues/4258 (59f8c)
• useManualRefHistory: canUndo and canRedo typing to be computed ref  -  by @​roydukkey and Anthony Fu in https://github.com/vueuse/vueuse/issues/4261 (b46d2)
• useWebSocket: Autoreconnect when ws close  -  by @​jackcodetw in https://github.com/vueuse/vueuse/issues/4314 (08412)

    View changes on GitHub

v11.1.0

Compare Source

   🚀 Features

• useCurrentElement: Try to infer type from $el  -  by @​KazariEX in https://github.com/vueuse/vueuse/issues/4202 (8e141)
• useDropZone: Add multiple prop to control multi-file drop  -  by @​danngossinga and Dan T. Ngossinga in https://github.com/vueuse/vueuse/issues/4227 (3b94d)
• useFileDialog: Return onCancel handler  -  by @​AndreyYolkin in https://github.com/vueuse/vueuse/issues/4184 (30452)

   🐞 Bug Fixes

• computedAsync: Type signature  -  by @​ferferga in https://github.com/vueuse/vueuse/issues/4207 (45b18)
• onClickOutside: Make ignore accept reactive values  -  by @​CernyMatej in https://github.com/vueuse/vueuse/issues/4211 (aa5e3)
• onClickOutside: Improve cross-browser compatibility  -  by @​Onion-L and @​antfu in https://github.com/vueuse/vueuse/issues/4185 (9e598)
• useArrayFilter: Match type to Array.prototype.filter  -  by @​Jesse205 in https://github.com/vueuse/vueuse/issues/4175 (71fd1)
• useDraggable: Draggable component not work with container  -  by @​huiliangShen in https://github.com/vueuse/vueuse/issues/4192 (7f25b)
• useFocusWithin: Make useFocusWhithin match the behavior of the :focus-within  -  by @​ben-lau in https://github.com/vueuse/vueuse/issues/4134 (c5407)
• useInfiniteScroll: Stop watch when unmounted  -  by @​zyyv in https://github.com/vueuse/vueuse/issues/4110 (f30cc)
• useIntersectionObserver: Add Document type for root  -  by @​phk422 in https://github.com/vueuse/vueuse/issues/4210 (6b584)
• useMouseInElement: Allow el to be instanceof Element  -  by @​FRSgit in https://github.com/vueuse/vueuse/issues/4189 (4dcc2)
• useNetwork: Return immutable values  -  by @​rudnovd in https://github.com/vueuse/vueuse/issues/4187 (99179)
• useResizeObserver: Update type  -  by @​phk422 in https://github.com/vueuse/vueuse/issues/4218 (044dd)

    View changes on GitHub

v11.0.3

Compare Source

   🚀 Features

• templateRef: Support specifying allowed keys via generic argument  -  by @​zhiyuanzmj in https://github.com/vueuse/vueuse/issues/4162 (acce3)

   🐞 Bug Fixes

• createSharedComposable: Handle the case where the return value of composable function is empty  -  by @​XinXiaoIsMe in https://github.com/vueuse/vueuse/issues/4151 (a2441)
• useCssVar: Replace getComputedStyle with direct style property access  -  by @​babu-ch in https://github.com/vueuse/vueuse/issues/4166 (d0523)
• useDropZone: Ensure files ref is updated even without onDrop callback  -  by @​babu-ch in https://github.com/vueuse/vueuse/issues/4168 (1c849)
• usePermission: State setting  -  by @​ferferga in https://github.com/vueuse/vueuse/issues/4167 (2aaa1)
• useWebSocket: Only reconnect if is the current ws socket  -  by @​freakbite in https://github.com/vueuse/vueuse/issues/4161 (e0e99)
• useWebSocket: Should reset retry count when connection is established  -  by @​freakbite in https://github.com/vueuse/vueuse/issues/4164 (3c2fc)

    View changes on GitHub

v11.0.1

Compare Source