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
API not supported, make sure to check for compatibility with different browsers when using this API
import { useDevicePixelRatio } from '@siberiacancode/reactuse';
const getDisplayLabel = (ratio: number) => {
if (ratio < 1) return 'Low DPI';
if (ratio === 1) return 'Standard';
if (ratio <= 2) return 'Retina';
return 'Super Retina';
};
const Demo = () => {
const devicePixelRatio = useDevicePixelRatio();
if (!devicePixelRatio.supported) {
return (
<p>
API not supported, make sure to check for compatibility with different browsers when using
this{' '}
<a
href='https://developer.mozilla.org/en-US/docs/Web/API/Window/devicePixelRatio'
rel='noreferrer'
target='_blank'
>
API
</a>
</p>
);
}
const gridLines = Array.from({ length: 11 }, (_, i) => i * 10);
return (
<section className='flex flex-col items-center gap-4 p-4'>
<div className='border-border bg-card relative flex h-[200px] w-[200px] items-center justify-center overflow-hidden rounded-lg border'>
<svg className='absolute inset-0' height='200' viewBox='0 0 200 200' width='200'>
<g className='text-border' stroke='currentColor' strokeWidth='0.5'>
{gridLines.map((pos) => (
<line key={`v-${pos}`} x1={pos * 2} x2={pos * 2} y1={0} y2={200} />
))}
{gridLines.map((pos) => (
<line key={`h-${pos}`} x1={0} x2={200} y1={pos * 2} y2={pos * 2} />
))}
</g>
</svg>
<div className='relative flex flex-col items-center gap-1'>
<span className='text-foreground font-mono text-5xl font-semibold tabular-nums'>
{devicePixelRatio.value.toFixed(2)}x
</span>
<span className='text-muted-foreground font-mono text-[10px] tracking-[0.15em] uppercase'>
{getDisplayLabel(devicePixelRatio.value)}
</span>
</div>
</div>
<p className='text-muted-foreground text-center text-xs'>Try zooming the page in and out</p>
</section>
);
};
export default Demo;
This hook uses window.devicePixelRatio browser api to provide enhanced functionality. Make sure to check for compatibility with different browsers when using this api
Installation
pnpm add @siberiacancode/reactuseUsage
const { supported, value } = useDevicePixelRatio();Type Declarations
export type UseDevicePixelRatioCallback = (value: number) => void;
export interface UseDevicePixelRatioReturn {
/** Whether the device pixel ratio is supported*/
supported: boolean;
/** The ratio of the resolution in physical pixels to the resolution in CSS pixels */
value: number;
}API
Parameters
| Name | Type | Default | Note |
|---|---|---|---|
| callback | (value: number) => void | - | The callback to execute when the device pixel ratio changes |
Returns
UseDevicePixelRatioReturnContributors
ddebabinAArtem Dereviago
Last updated on