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>
58 lines
1.4 KiB
Markdown
58 lines
1.4 KiB
Markdown
---
|
|
category: Sensors
|
|
---
|
|
|
|
# useFocusWithin
|
|
|
|
Reactive utility to track if an element or one of its decendants has focus. It is meant to match the behavior of the `:focus-within` CSS pseudo-class. A common use case would be on a form element to see if any of its inputs currently have focus.
|
|
|
|
## Basic Usage
|
|
|
|
```vue
|
|
<script setup lang="ts">
|
|
import { useFocusWithin } from '@vueuse/core'
|
|
import { ref, watch } from 'vue'
|
|
|
|
const target = ref()
|
|
const { focused } = useFocusWithin(target)
|
|
|
|
watch(focused, (focused) => {
|
|
if (focused)
|
|
console.log('Target contains the focused element')
|
|
else
|
|
console.log('Target does NOT contain the focused element')
|
|
})
|
|
</script>
|
|
|
|
<template>
|
|
<form ref="target">
|
|
<input type="text" placeholder="First Name">
|
|
<input type="text" placeholder="Last Name">
|
|
<input type="text" placeholder="Email">
|
|
<input type="text" placeholder="Password">
|
|
</form>
|
|
</template>
|
|
```
|
|
|
|
## Type Declarations
|
|
|
|
```ts
|
|
export interface UseFocusWithinReturn {
|
|
/**
|
|
* True if the element or any of its descendants are focused
|
|
*/
|
|
focused: ComputedRef<boolean>
|
|
}
|
|
/**
|
|
* Track if focus is contained within the target element
|
|
*
|
|
* @see https://vueuse.org/useFocusWithin
|
|
* @param target The target element to track
|
|
* @param options Focus within options
|
|
*/
|
|
export declare function useFocusWithin(
|
|
target: MaybeElementRef,
|
|
options?: ConfigurableWindow,
|
|
): UseFocusWithinReturn
|
|
```
|