컴포넌트로 돌아가기
커스텀 스크롤바를 가진 스크롤 영역 컴포넌트입니다. 호버 시 스크롤바를 표시하거나 항상 표시할 수 있습니다.
설치
Import
@hua-labs/ui의 UI 컴포넌트를 @hua-labs/hua에서 통합 제공합니다.
UI 컴포넌트, 모션 훅, i18n을 하나의 패키지로 사용할 수 있습니다.
라이브 데모
세로 스크롤 (기본)
가로 스크롤
스크롤바 타입
마우스 호버 시 스크롤바 표시
Props
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
orientation | "vertical" | "horizontal" | "both" | "vertical" | Scroll direction |
type | "auto" | "always" | "scroll" | "hover" | "hover" | Scrollbar visibility behavior |
scrollHideDelay | number | 600 | 스크롤바가 숨겨지기까지의 지연 시간 (ms) |
className | string | - | 추가 CSS 클래스 |
children* | ReactNode | - | 스크롤할 콘텐츠 |
타입 옵션
hover마우스 오버 시 스크롤바 표시 (기본값)always스크롤바 항상 표시auto콘텐츠가 넘칠 때만 스크롤바 표시scroll스크롤 중에만 스크롤바 표시코드 예시
관련 컴포넌트
- •
ScrollBar- 커스텀 스크롤바 (고급 사용)
접근성
- •키보드 탐색: 화살표 키 및 Page Up/Down으로 스크롤
- •터치 지원: 모바일 기기에서 네이티브 터치 스크롤 지원
- •포커스 관리: 포커스 가능한 콘텐츠가 스크롤 영역 안에서도 접근 가능