useMouse

類別

感測器

匯出大小

1 kB

上次變更

5 天前

響應式滑鼠位置

示範

原始碼

基本用法

x: 0
y: 0
sourceType: null

提取器用法

x: 0
y: 0
sourceType: null

基本用法

import { useMouse
 } from '@vueuse/core'

const { x
, y
, sourceType
 } = useMouse
()

預設啟用觸控。若僅偵測滑鼠變更，請將 touch 設定為 false。dragover 事件用於在拖曳時追蹤滑鼠位置。

const { x
, y
 } = useMouse
({ touch
: false })

自訂提取器

也可以提供自訂提取器函式，以從事件中取得位置。

TypeScript

import type { UseMouseEventExtractor
 } from '@vueuse/core'
import { useMouse
, useParentElement
 } from '@vueuse/core'

const parentEl
 = useParentElement
()

const extractor
: UseMouseEventExtractor
 = event
 => (
  event
 instanceof MouseEvent

    ? [event
.offsetX
, event
.offsetY
]
    : null
)

const { x
, y
, sourceType
 } = useMouse
({ target
: parentEl
, type
: extractor
 })

import { useMouse, useParentElement } from '@vueuse/core'
const parentEl = useParentElement()
const extractor = (event) =>
  event instanceof MouseEvent ? [event.offsetX, event.offsetY] : null
const { x, y, sourceType } = useMouse({ target: parentEl, type: extractor })

元件用法

此函式也透過 @vueuse/components 套件提供無渲染元件版本。瞭解更多關於用法的資訊。

vue

<template>
  <UseMouse v-slot="{ x, y }">
    x: {{ x }}
    y: {{ y }}
  </UseMouse>
</template>

類型宣告

顯示類型宣告

typescript

export type UseMouseCoordType = "page" | "client" | "screen" | "movement"
export type UseMouseSourceType = "mouse" | "touch" | null
export type UseMouseEventExtractor = (
  event: MouseEvent | Touch,
) => [x: number, y: number] | null | undefined
export interface UseMouseOptions
  extends ConfigurableWindow,
    ConfigurableEventFilter {
  /**
   * Mouse position based by page, client, screen, or relative to previous position
   *
   * @default 'page'
   */
  type?: UseMouseCoordType | UseMouseEventExtractor
  /**
   * Listen events on `target` element
   *
   * @default 'Window'
   */
  target?: MaybeRefOrGetter<Window | EventTarget | null | undefined>
  /**
   * Listen to `touchmove` events
   *
   * @default true
   */
  touch?: boolean
  /**
   * Listen to `scroll` events on window, only effective on type `page`
   *
   * @default true
   */
  scroll?: boolean
  /**
   * Reset to initial value when `touchend` event fired
   *
   * @default false
   */
  resetOnTouchEnds?: boolean
  /**
   * Initial values
   */
  initialValue?: Position
}
/**
 * Reactive mouse position.
 *
 * @see https://vueuse.dev.org.tw/useMouse
 * @param options
 */
export declare function useMouse(options?: UseMouseOptions): {
  x: ShallowRef<number, number>
  y: ShallowRef<number, number>
  sourceType: ShallowRef<UseMouseSourceType, UseMouseSourceType>
}
export type UseMouseReturn = ReturnType<typeof useMouse>