Skip to content
Docs
훅으로 돌아가기

useWindowSize

@hua-labs/hua/motion

윈도우 크기 추적 — 반응형 레이아웃 감지용

설치

bash
npm install @hua-labs/hua
Import
tsx
import { useWindowSize } from "@hua-labs/hua/framework";

@hua-labs/motion-core의 모션 훅을 @hua-labs/hua/framework에서 통합 제공합니다.

UI 컴포넌트, 모션 훅, i18n을 하나의 패키지로 사용할 수 있습니다.

기본 사용법

tsx
const { width, height, isMounted } = useWindowSize();

if (!isMounted) return null;

return (
  <p>Window: {width} x {height}</p>
);

API 레퍼런스

옵션

이름타입기본값설명
debouncenumber100docs:hooks.use-window-size.options.debounce
initialWidthnumber0docs:hooks.use-window-size.options.initialWidth
initialHeightnumber0docs:hooks.use-window-size.options.initialHeight

반환값

이름타입설명
widthnumberdocs:hooks.use-window-size.returns.width
heightnumberdocs:hooks.use-window-size.returns.height
isMountedbooleandocs:hooks.use-window-size.returns.isMounted

사용 사례

반응형 레이아웃

화면 크기 변화 감지 및 대응

조건부 렌더링

화면 크기 기반 컴포넌트 표시

캔버스 리사이징

캔버스/SVG 크기 동적 조정

브레이크포인트 감지

모바일/태블릿/데스크탑 분기