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

Scroll-Driven Storytelling

Lý tưởng cho trang ra mắt sản phẩm phần cứng hoặc câu chuyện thương hiệu cần đồng bộ vị trí cuộn trực tiếp với chuyển động hình học.

Next.js 16+React 19TypeScriptTailwind CSSZero External Deps
Kéo thanh tua để biến hình liên tục 0 -> 135%
02 · MORPH35%

Kéo thanh trượt tiến trình hoặc bấm trực tiếp từng mốc 01–04.

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 bằng React thuần + CSS Interpolation.

Cách sử dụng

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

<ScrollStorytelling
  beats={[
    { id: '01', label: '01', title: 'Anchor', accent: '#536dfe' },
    { id: '02', label: '02', title: 'Depth', accent: '#8765f7' },
    { id: '03', label: '03', title: 'Scrub', accent: '#30bfef' },
    { id: '04', label: '04', title: 'Settle', accent: '#536dfe' },
  ]}
/>

Bảng Props & Tùy biến

2 props
Tên PropKiểu dữ liệuMặc địnhMô tảTác dụng
beatsStorytellingBeat[](required)Các điểm mốc chia đều hành trình kể chuyện.Đổi sắc độ màu nhấn theo vị trí hiện tại.
progressnumber | nullnullTiến độ điều khiển từ bên ngoài (0–1).Cho phép gắn nối trực tiếp vào scroll listener trang.

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
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.

Scroll Progress Indicator

Thanh tiến độ cuộn ngang kết hợp vòng tròn SVG tính % đọc theo thời gian thực.

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