usePointer

分类

传感器

导出大小

1.03 kB

上次更改

2 个月前

响应式的指针状态。

演示

源代码演练场（测试版）

{
  "x": 0,
  "y": 0,
  "pointerId": 0,
  "pressure": 0,
  "tiltX": 0,
  "tiltY": 0,
  "width": 0,
  "height": 0,
  "twist": 0,
  "pointerType": null,
  "isInside": false
}

基本用法

import { usePointer
 } from '@vueuse/core'

const { x
, y
, pressure
, pointerType
 } = usePointer
()

组件用法

此函数还通过 @vueuse/components 包提供了一个无渲染组件版本。了解更多用法。

默认情况下，组件将在 window 上跟踪指针。

vue

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

要在元素中跟踪本地位置，请设置 target="self"。

vue

<template>
  <UsePointer v-slot="{ x
, y
 }" target
="self">
    x: {{ x
 }} y: {{ y
 }}
  </UsePointer>
</template>

类型声明

显示类型声明

export interface UsePointerState extends Position {
  pressure
: number
  pointerId
: number
  tiltX
: number
  tiltY
: number
  width
: number
  height
: number
  twist
: number
  pointerType
: PointerType
 | null
}
export interface UsePointerOptions extends ConfigurableWindow {
  /**
   * Pointer types that listen to.
   *
   * @default ['mouse', 'touch', 'pen']
   */
  pointerTypes
?: PointerType
[]
  /**
   * Initial values
   */
  initialValue
?: MaybeRef
<Partial
<UsePointerState>>
  /**
   * @default window
   */
  target
?: MaybeRef
<EventTarget | null | undefined> | Document | Window
}
/**
 * Reactive pointer state.
 *
 * @see https://vueuse.org.cn/usePointer
 * @param options
 */
export declare function usePointer
(options
?: UsePointerOptions): {
  isInside
: ShallowRef
<boolean, boolean>
  pressure
: Ref
<number, number>
  pointerId
: Ref
<number, number>
  tiltX
: Ref
<number, number>
  tiltY
: Ref
<number, number>
  width
: Ref
<number, number>
  height
: Ref
<number, number>
  twist
: Ref
<number, number>
  pointerType
: Ref
<PointerType
 | null, PointerType
 | null>
  x
: Ref
<number, number>
  y
: Ref
<number, number>
}
export type UsePointerReturn
 = ReturnType
<typeof usePointer
>