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

Horizontal Scroll Gallery

HorizontalScrollGallery giải quyết lỗi phổ biến là khóa cứng cuộn trang web: nó chỉ chuyển đổi deltaY sang scrollLeft ở đoạn giữa và nhả cuộn dọc trang ngay tại 2 đầu mút.

Next.js 16+React 19TypeScriptTailwind CSSZero External Deps
Lăn chuột hoặc kéo ngang qua dải thẻ0%
01 / FRAME
Khung dải ngang
Snap-x rail track
02 / SKEW
Nghiêng theo vận tốc
±6deg inertia
03 / WHEEL
Chuyển con lăn chuột
Auto edge release
04 / MOBILE
Vuốt cảm ứng mượt
Mandatory scroll snap
skewStrength: 6deg

Cuộn con lăn chuột trên dải thẻ, vuốt ngang hoặc dùng thanh kéo.

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 trên Native Scroll & CSS skewX.

Cách sử dụng

import { HorizontalScrollGallery } from '@/components/effects/library/layout/HorizontalScrollGallery'

<HorizontalScrollGallery
  skewStrength={6}
  slides={[
    { id: '01', indexLabel: '01', title: 'Motion Frame', caption: 'Snapped modular rail', accent: '#536dfe' },
    { id: '02', indexLabel: '02', title: 'Inertia Skew', caption: 'Velocity-driven tilt', accent: '#8765f7' },
    { id: '03', indexLabel: '03', title: 'Rail Track', caption: 'Zero scrollbar clutter', accent: '#30bfef' },
  ]}
/>

Bảng Props & Tùy biến

3 props
Tên PropKiểu dữ liệuMặc địnhMô tảTác dụng
slidesHorizontalGallerySlide[](required)Mảng các thẻ trình diễn theo chiều ngang.Mỗi thẻ nằm gọn trong snap-x scroll track.
skewStrengthnumber6Góc nghiêng tối đa theo vận tốc cuộn (độ).Tạo cảm giác quán tính khi vuốt hoặc lăn chuột nhanh.
progressnumber | nullnullTiến độ cuộn điều khiển từ bên ngoài (0–1).Cho phép kéo vị trí track bằng slider hoặc nút.

Cùng nhóm Layout & Gallery

Xem đủ 24 Component →
Bấm vào từng ô để thay đổi tỷ lệ Bento
stiffness: 340 · damping: 28

Expandable Grid

Bố cục lưới Bento có phản hồi tương tác: bấm từng ô để mở rộng tràn hàng có nhịp lò xo.

Xem chi tiết
Rê chuột hoặc bấm chọn từng thẻ để tách tiêu điểm
01 · OPTIC
Thẻ tiêu điểm

Rõ nét khi di chuột hoặc chọn.

02 · DEPTH
Làm dịu xung quanh

Các thẻ lân cận mờ dịu đồng đều.

03 · PURE CSS
Thuần CSS & React

Hỗ trợ chuột, chạm và phím Tab.

blur 2.5px · dim 0.42 · scale 1.03

Focus Gallery

Khi chọn một thẻ, thẻ đó phóng nét nổi bật trong khi các thẻ lân cận mờ dịu xuống có chủ đích.

Xem chi tiết
Lướt ngang hoặc kéo thanh chiều sâu
01 · Foreground
Lớp tiền cảnh
02 · Midground
Lớp trung cảnh
03 · Horizon
Trục hậu cảnh

Depth Parallax Gallery

Thư viện thẻ đa lớp (Foreground - Midground - Horizon) dịch chuyển lệch tốc độ theo trỏ chuột.

Xem chi tiết