elements
lifecycle
browser
- useAudio
- useBattery
- useBluetooth
- useBreakpoints
- useBroadcastChannel
- useBrowserLocation
- useClipboard
- useCopy
- useCssVar
- useDisplayMedia
- useDocumentEvent
- useDocumentTitle
- useDocumentVisibility
- useEventListener
- useEventSource
- useEyeDropper
- useFavicon
- useFileSystemAccess
- useFps
- useFullscreen
- useGamepad
- useGeolocation
- useMeasure
- useMediaControls
- useMediaQuery
- useMemory
- useNetwork
- useObjectUrl
- useOnline
- useOtpCredential
- usePermission
- usePictureInPicture
- usePointerLock
- usePostMessage
- useRaf
- useShare
- useSpeechRecognition
- useSpeechSynthesis
- useSticky
- useVibrate
- useVirtualKeyboard
- useWakeLock
- useWebSocket
utilities
state
- useBoolean
- useControllableState
- useCookie
- useCookies
- useCounter
- useCycleList
- useDefault
- useDisclosure
- useField
- useHash
- useList
- useLocalStorage
- useMap
- useMask
- useMergedRef
- useObject
- useOffsetPagination
- useQueue
- useRafState
- useRefState
- useSessionStorage
- useSet
- useStateHistory
- useStep
- useStorage
- useToggle
- useUrlSearchParam
- useUrlSearchParams
- useValidatedState
- useWizard
user
sensors
- useDeviceMotion
- useDeviceOrientation
- useHotkeys
- useIdle
- useInfiniteScroll
- useIntersectionObserver
- useKeyboard
- useKeyPress
- useKeysPressed
- useMouse
- useMutationObserver
- useOrientation
- usePageLeave
- useParallax
- usePerformanceObserver
- useResizeObserver
- useScroll
- useScrollIntoView
- useScrollTo
- useSwipe
- useTextSelection
- useVisibility
- useWindowEvent
- useWindowFocus
- useWindowScroll
- useWindowSize
Contact form
Fill in your details below and we'll get back to you shortly.
import { useActiveElement } from '@siberiacancode/reactuse';
import { AtSignIcon, InfoIcon } from 'lucide-react';
const HINTS = {
name: 'Enter your full name so we know how to address you.',
email: "We'll only use your email to reply — no spam, ever.",
message: 'Describe your question or issue in as much detail as you like.',
cancel: 'This will discard everything you have entered.',
submit: 'Double-check your details, then send the form our way.'
};
const Demo = () => {
const activeElement = useActiveElement<HTMLDivElement>();
const activeId = activeElement?.value?.dataset?.id;
const hint = activeId ? HINTS[activeId] : 'Focus any field to see a helpful tip here.';
return (
<section>
<div ref={activeElement.ref} className='flex max-w-md flex-col gap-6'>
<div className='flex flex-col gap-2'>
<h3>Contact form</h3>
<p className='text-muted-foreground text-xs'>
Fill in your details below and we'll get back to you shortly.
</p>
</div>
<form className='flex flex-col gap-4'>
<div className='grid gap-4 md:grid-cols-2'>
<label className='flex flex-col gap-2 text-sm'>
Name
<input data-id='name' placeholder='John' type='text' />
</label>
<label className='flex flex-col gap-2 text-sm'>
Email
<div className='relative'>
<AtSignIcon className='pointer-events-none absolute top-1/2 left-3 size-4 -translate-y-1/2 opacity-50' />
<input
className='pl-8!'
data-id='email'
placeholder='john@example.com'
type='email'
/>
</div>
</label>
</div>
<label className='flex flex-col gap-2 text-sm'>
Message
<textarea data-id='message' placeholder='Type your message...' rows={5} />
</label>
<div className='border-border bg-muted/40 flex items-start gap-2.5 rounded-lg border p-3'>
<InfoIcon className='text-muted-foreground mt-0.5 size-4 shrink-0' />
<p className='text-muted-foreground text-xs leading-relaxed'>{hint}</p>
</div>
<div className='flex justify-end gap-2'>
<button data-id='cancel' data-variant='outline' type='button'>
Cancel
</button>
<button data-id='submit' type='button'>
Submit
</button>
</div>
</form>
</div>
</section>
);
};
export default Demo;
Installation
pnpm add @siberiacancode/reactuseUsage
const activeElement = useActiveElement(ref);
// or
const { ref, value } = useActiveElement();Type Declarations
import type { HookTarget } from '@/utils/helpers';
import type { StateRef } from '../useRefState/useRefState';
export interface UseActiveElementReturn<ActiveElement extends HTMLElement = HTMLElement> {
value: ActiveElement | null;
}
export interface UseActiveElement {
(): UseActiveElementReturn;
<Target extends Element, ActiveElement extends HTMLElement = HTMLElement>(
target?: never
): {
ref: StateRef<Target>;
} & UseActiveElementReturn<ActiveElement>;
<ActiveElement extends HTMLElement = HTMLElement>(
target: HookTarget
): UseActiveElementReturn<ActiveElement>;
}API
Parameters
| Name | Type | Default | Note |
|---|---|---|---|
| target | HookTarget | window | The target element to observe active element changes |
Returns
ActiveElement | nullReturns
{ ref: StateRef<Element>; activeElement: ActiveElement | null }Contributors
ddebabinbbabin
Last updated on