f5792c40be
Pulled ALL skills from 15 source repositories: - anthropics/skills: 16 (docs, design, MCP, testing) - obra/superpowers: 14 (TDD, debugging, agents, planning) - coreyhaines31/marketingskills: 25 (marketing, CRO, SEO, growth) - better-auth/skills: 5 (auth patterns) - vercel-labs/agent-skills: 5 (React, design, Vercel) - antfu/skills: 16 (Vue, Vite, Vitest, pnpm, Turborepo) - Plus 13 individual skills from various repos Mosaic Stack is not limited to coding — the Orchestrator and subagents serve coding, business, design, marketing, writing, logistics, analysis, and more. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
113 lines
2.5 KiB
Markdown
113 lines
2.5 KiB
Markdown
---
|
|
category: Sensors
|
|
---
|
|
|
|
# useMousePressed
|
|
|
|
Reactive mouse pressing state. Triggered by `mousedown` `touchstart` on target element and released by `mouseup` `mouseleave` `touchend` `touchcancel` on window.
|
|
|
|
## Basic Usage
|
|
|
|
```ts
|
|
import { useMousePressed } from '@vueuse/core'
|
|
|
|
const { pressed } = useMousePressed()
|
|
```
|
|
|
|
Touching is enabled by default. To make it only detects mouse changes, set `touch` to `false`
|
|
|
|
```ts
|
|
import { useMousePressed } from '@vueuse/core'
|
|
// ---cut---
|
|
const { pressed } = useMousePressed({ touch: false })
|
|
```
|
|
|
|
To only capture `mousedown` and `touchstart` on specific element, you can specify `target` by passing a ref of the element.
|
|
|
|
```vue
|
|
<script setup lang="ts">
|
|
import { useMousePressed } from '@vueuse/core'
|
|
// ---cut---
|
|
import { useTemplateRef } from 'vue'
|
|
|
|
const el = useTemplateRef('el')
|
|
|
|
const { pressed } = useMousePressed({ target: el })
|
|
</script>
|
|
|
|
<template>
|
|
<div ref="el">
|
|
Only clicking on this element will trigger the update.
|
|
</div>
|
|
</template>
|
|
```
|
|
|
|
## Component Usage
|
|
|
|
```vue
|
|
<template>
|
|
<UseMousePressed v-slot="{ pressed }">
|
|
Is Pressed: {{ pressed }}
|
|
</UseMousePressed>
|
|
</template>
|
|
```
|
|
|
|
## Type Declarations
|
|
|
|
```ts
|
|
export interface MousePressedOptions extends ConfigurableWindow {
|
|
/**
|
|
* Listen to `touchstart` `touchend` events
|
|
*
|
|
* @default true
|
|
*/
|
|
touch?: boolean
|
|
/**
|
|
* Listen to `dragstart` `drop` and `dragend` events
|
|
*
|
|
* @default true
|
|
*/
|
|
drag?: boolean
|
|
/**
|
|
* Add event listeners with the `capture` option set to `true`
|
|
* (see [MDN](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener#capture))
|
|
*
|
|
* @default false
|
|
*/
|
|
capture?: boolean
|
|
/**
|
|
* Initial values
|
|
*
|
|
* @default false
|
|
*/
|
|
initialValue?: boolean
|
|
/**
|
|
* Element target to be capture the click
|
|
*/
|
|
target?: MaybeComputedElementRef
|
|
/**
|
|
* Callback to be called when the mouse is pressed
|
|
*
|
|
* @param event
|
|
*/
|
|
onPressed?: (event: MouseEvent | TouchEvent | DragEvent) => void
|
|
/**
|
|
* Callback to be called when the mouse is released
|
|
*
|
|
* @param event
|
|
*/
|
|
onReleased?: (event: MouseEvent | TouchEvent | DragEvent) => void
|
|
}
|
|
/**
|
|
* Reactive mouse pressing state.
|
|
*
|
|
* @see https://vueuse.org/useMousePressed
|
|
* @param options
|
|
*/
|
|
export declare function useMousePressed(options?: MousePressedOptions): {
|
|
pressed: ShallowRef<boolean, boolean>
|
|
sourceType: ShallowRef<UseMouseSourceType, UseMouseSourceType>
|
|
}
|
|
export type UseMousePressedReturn = ReturnType<typeof useMousePressed>
|
|
```
|