Skip to content

useMouseInElement

Category
Export Size
1.12 kB
Last Changed
15 minutes ago

与元素相关的鼠标位置的响应式状态

Demo

Hover me
x: 0
y: 0
sourceType: null
elementX: 0
elementY: 0
elementPositionX: 0
elementPositionY: 0
elementHeight: 0
elementWidth: 0
isOutside: true

用法

vue
<script setup>
import { useMouseInElement } from '@vueuse/core'
import { ref } from 'vue'

const target = ref(null)

const { x, y, isOutside } = useMouseInElement(target)
</script>

<template>
  <div ref="target">
    <h1>Hello world</h1>
  </div>
</template>

组件用法

vue
<template>
  <UseMouseInElement v-slot="{ elementX, elementY, isOutside }">
    x: {{ elementX }}
    y: {{ elementY }}
    是否在外部: {{ isOutside }}
  </UseMouseInElement>
</template>

类型声明

typescript
export interface MouseInElementOptions extends UseMouseOptions {
  handleOutside?: boolean
}
/**
 * 与元素相关的响应式鼠标位置
 *
 * @see https://vueuse.org/useMouseInElement
 * @param target
 * @param options
 */
export declare function useMouseInElement(
  target?: MaybeElementRef,
  options?: MouseInElementOptions,
): {
  x: Ref<number, number>
  y: Ref<number, number>
  sourceType: Ref<UseMouseSourceType, UseMouseSourceType>
  elementX: Ref<number, number>
  elementY: Ref<number, number>
  elementPositionX: Ref<number, number>
  elementPositionY: Ref<number, number>
  elementHeight: Ref<number, number>
  elementWidth: Ref<number, number>
  isOutside: Ref<boolean, boolean>
  stop: () => void
}
export type UseMouseInElementReturn = ReturnType<typeof useMouseInElement>

Source

SourceDemoDocs

贡献者

Anthony Fu
丶远方
wheat
Anthony Fu
Jakub Freisler
Coder Poet
Aymoc
Mikhailov Nikita
vaakian X
Jelf
Ivan Agafonov
Shinigami
Alex Kozack
ctholho
Nurettin Kaya
Antério Vieira

变更日志

v11.1.0 on 9/16/2024
4dcc2 - fix: allow el to be instanceof Element (#4189)
v11.0.0-beta.2 on 7/17/2024
efe4d - fix: el.getBoundingClientRect is not a function (#4056)
v10.7.0 on 12/5/2023
fccf2 - feat: upgrade deps (#3614)
v10.6.0 on 11/9/2023
7c88d - fix: optimize outside computation (#3380)
v9.12.0 on 1/29/2023
54f4e - fix: check if mouse out of window (#2458)
v9.11.0 on 1/17/2023
d5321 - fix(components): mark defineComponent as pure (#2623)

Released under the MIT License.