Skip to content
Docs
컴포넌트로 돌아가기

ScrollProgress

@hua-labs/ui
v1.1.0

페이지 스크롤 위치를 표시하는 고정 진행률 바입니다. 그라디언트, 단색, 퍼센트 표시를 지원합니다.

설치

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

@hua-labs/ui의 UI 컴포넌트를 @hua-labs/hua에서 통합 제공합니다.

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

라이브 데모

이 페이지 상단에 진행률 바가 표시됩니다. 스크롤해보세요!

색상:
gradient
primary

참고

ScrollProgress는 fixed 위치로 렌더링되어 페이지 상단/하단에 고정됩니다.

Props

이름타입기본값설명
heightnumber2Progress bar height (px)
color"default" | "primary" | "secondary" | "gradient""gradient"Progress bar color
position"top" | "bottom""top"Display position
showPercentagebooleanfalseShow percentage badge
animatedbooleantrueEnable smooth animation

Code Examples

docs:common.basicUsagetsx
1import { ScrollProgress } from '@hua-labs/ui';
2 
3// 페이지 상단에 그라디언트 진행률 바
4<ScrollProgress />
docs:components.scrollProgress.examples.customizationtsx
1<ScrollProgress
2 position="bottom"
3 color="primary"
4 height={4}
5 showPercentage
6/>

접근성

  • 비인터랙티브: 순수 시각적 표시, 콘텐츠와 간섭 없음