useMouse
响应式获取鼠标位置
Reactive mouse position
例子
x: 0
y: 0
sourceType: null
Basic Usage
js
import { useMouse } from '@vueuse/core'
const { x, y, sourceType } = useMouse()
import { useMouse } from '@vueuse/core'
const { x, y, sourceType } = useMouse()
默认情况下启用 Touch。要仅检测鼠标变化,请设置 touch
为 false
。 dragover
事件用于在拖动时跟踪鼠标位置。
Touch is enabled by default. To only detect mouse changes, set touch
to false
. The dragover
event is used to track mouse position while dragging.
js
const { x, y } = useMouse({ touch: false })
const { x, y } = useMouse({ touch: false })
Component Usage
该函数还通过
@vueuse/components
提供了一个无渲染的组件版本。了解更多.
This function also provides a renderless component version via the
@vueuse/components
package. Learn more about the usage.
html
<UseMouse v-slot="{ x, y }">
x: {{ x }}
y: {{ y }}
</UseMouse>
<UseMouse v-slot="{ x, y }">
x: {{ x }}
y: {{ y }}
</UseMouse>
Type Declarations
typescript
export interface UseMouseOptions
extends ConfigurableWindow,
ConfigurableEventFilter {
/**
* Mouse position based by page, client, or relative to previous position
*
* @default 'page'
*/
type?: "page" | "client" | "movement"
/**
* Listen to `touchmove` events
*
* @default true
*/
touch?: boolean
/**
* Reset to initial value when `touchend` event fired
*
* @default false
*/
resetOnTouchEnds?: boolean
/**
* Initial values
*/
initialValue?: Position
}
export type MouseSourceType = "mouse" | "touch" | null
/**
* Reactive mouse position.
*
* @see https://vueuse.org/useMouse
* @param options
*/
export declare function useMouse(options?: UseMouseOptions): {
x: Ref<number>
y: Ref<number>
sourceType: Ref<MouseSourceType>
}
export type UseMouseReturn = ReturnType<typeof useMouse>
export interface UseMouseOptions
extends ConfigurableWindow,
ConfigurableEventFilter {
/**
* Mouse position based by page, client, or relative to previous position
*
* @default 'page'
*/
type?: "page" | "client" | "movement"
/**
* Listen to `touchmove` events
*
* @default true
*/
touch?: boolean
/**
* Reset to initial value when `touchend` event fired
*
* @default false
*/
resetOnTouchEnds?: boolean
/**
* Initial values
*/
initialValue?: Position
}
export type MouseSourceType = "mouse" | "touch" | null
/**
* Reactive mouse position.
*
* @see https://vueuse.org/useMouse
* @param options
*/
export declare function useMouse(options?: UseMouseOptions): {
x: Ref<number>
y: Ref<number>
sourceType: Ref<MouseSourceType>
}
export type UseMouseReturn = ReturnType<typeof useMouse>