Quay lại thư viện AIX EffectsĐã QA · Code Đồng Bộ
Scroll & Motion/<ScrollProgressIndicator />·Beginner

Scroll Progress Indicator

Nhẹ gọn tuyệt đối không cần Framer Motion, tự cập nhật với passive listener hoặc nhận prop progress điều khiển trực tiếp.

Next.js 16+React 19TypeScriptTailwind CSSZero External Deps
Cuộn vùng tài liệu bên dưới để xem đồng hồ %
0%
0%

01. Passive Listener Architecture: Measures container scrollTop ratio without layout polling.

02. Top Hairline Track: Maps progress cleanly across hardware scaleX transform.

03. SVG Dashoffset Geometry: Computes stroke circumference accurately from ring diameter.

04. Tabular Clarity: Prevents horizontal numeric wobble as percentages cross two digits.

05. End Checkpoint: Settles crisp at 100% upon reaching footer boundary.

Cuộn văn bản mẫu trong hộp bên cạnh để đồng hồ SVG xoay theo.

Cài đặt

Không cần cài đặt package ngoài

Không cần thư viện ngoài — hoạt động hoàn toàn với React + SVG chuẩn.

Cách sử dụng

import { ScrollProgressIndicator } from '@/components/effects/library/scroll/ScrollProgressIndicator'

<ScrollProgressIndicator
  accentColor="#536dfe"
  ringSize={56}
  showLinearBar
/>

Bảng Props & Tùy biến

3 props
Tên PropKiểu dữ liệuMặc địnhMô tảTác dụng
accentColorstring'#536dfe'Màu sắc của vạch ngang và đường tròn SVG.Đồng bộ theme chủ đạo trang đọc.
ringSizenumber52Đường kính khung đồng hồ tròn SVG (px).Phóng to hoặc thu gọn kích thước huy hiệu đọc.
showLinearBarbooleantrueBật hoặc tắt thanh ngang đi kèm phía trên.Linh hoạt hiện 1 hoặc cả 2 chế độ báo tiến độ.

Cùng nhóm Scroll & Motion

Xem đủ 24 Component →
Atelier
CUỘN TRONG KHUNG ĐỂ QUAN SÁT

Thanh điều hướng tự thu gọn mượt từ 76px xuống 56px.

01 · Threshold 18px: Bật nền kính mờ frosted 72px kèm đường viền mảnh.
02 · Threshold 165px: Thu gọn 56px tăng độ nổi shadow và chuyển CTA xanh.
03 · Smart Hide 240px: Tự ẩn khi cuộn xuống sâu và hiện ngay khi cuộn ngược.

Sticky Navbar Scroll Behavior

Thanh menu đổi hình thái mượt từ trong suốt 76px sang kính mờ 72px và thu gọn 56px khi cuộn sâu.

Xem chi tiết
01 · PINNED SHELL
RENDER
Pinned Visual

Sticky Scroll Reveal

Bố cục 2 cột chia đoạn văn cuộn bên trái và bảng minh họa ghim cố định tự đổi trạng thái bên phải.

Xem chi tiết
Kéo thanh tua để biến hình liên tục 0 -> 135%
02 · MORPH35%

Scroll-Driven Storytelling

Biến đổi hình khối, góc xoay và bo góc liên tục dọc trục tiến độ 0% đến 100%.

Xem chi tiết