Компоненты/Резиновая карусель

Резиновая карусель

Pro
27 сентября 2026

Карусель с резиновым оттягиванием на краях и пружинным возвратом

Установка

import { useEffect, useMemo } from "react";
import Animated, { useSharedValue } from "react-native-reanimated";
import { StyleSheet, View } from "react-native";

Установка через CLIPro

Команда станет доступна после оформления Pro.

Оформить ProВойти

Файлы

index.tsx
НазадЗатмениеДалееЭластичная карусель

Как это работает

За первой и последней карточкой лента тянется с нарастающим сопротивлением (resistance), а зазоры между карточками растягиваются, как резинка (stretch): ближняя к краю карточка уходит дальше всех. Отпустили — всё пружиной собирается обратно.

С snap карусель прилипает к карточкам с учётом скорости броска; без него катится по инерции. Прокрутка своя, на жесте Pan, поэтому резинка одинакова на iOS, Android и в вебе. ref.current?.tug(px) оттягивает ленту и отпускает — подсказка жеста для онбординга.

Вручную

Поставьте зависимости:

npm install react-native-gesture-handler react-native-reanimated react-native-worklets
pnpm add react-native-gesture-handler react-native-reanimated react-native-worklets
yarn add react-native-gesture-handler react-native-reanimated react-native-worklets
bun add react-native-gesture-handler react-native-reanimated react-native-worklets

Скопируйте эти файлы в src/shared/components/molecules/elastic-carousel/:

index.tsx
import { useEffect, useMemo } from "react";
import Animated, { useSharedValue } from "react-native-reanimated";
import { StyleSheet, View } from "react-native";
 
// Полный исходник открывается с подпиской Pro
export interface ElasticCarouselProps {
  speed?: number;
  intensity?: number;
  palette?: "aurora" | "mono";
  interactive?: boolean;
}
 
export function ElasticCarousel({
  speed = 1,
  intensity = 0.6,
  interactive = true,
}: ElasticCarouselProps) {
  const progress = useSharedValue(0);
  const frame = useMemo(() => createFrame(speed), [speed]);
 
  useEffect(() => {
    // …

Код доступен по подпискеPro

Исходник «Резиновая карусель» открывается с подпиской Pro. Уже оформили? Войдите в аккаунт.

Оформить ProВойти

Проверьте алиас путей. Импорты в коде выше записаны так, как их пишет astra-rn add: @/shared/components, @/shared/utils и @/shared/hooks. Нужен алиас "@/*": ["./src/*"] в tsconfig.json — или поправьте импорты под свои пути.

Использование

usage.tsx
import { useEffect, useMemo } from "react";
import Animated, { useSharedValue } from "react-native-reanimated";
import { StyleSheet, View } from "react-native";
 
// Полный исходник открывается с подпиской Pro
export interface ElasticCarouselProps {
  speed?: number;
  intensity?: number;
  palette?: "aurora" | "mono";
  interactive?: boolean;
}
 
export function ElasticCarousel({
  speed = 1,
  intensity = 0.6,
  interactive = true,
}: ElasticCarouselProps) {
  const progress = useSharedValue(0);
  const frame = useMemo(() => createFrame(speed), [speed]);
 
  useEffect(() => {
    // …

Код доступен по подпискеPro

Исходник «Резиновая карусель» открывается с подпиской Pro. Уже оформили? Войдите в аккаунт.

Оформить ProВойти

Пропсы

Пропс
Описание
data

Тип readonly T[]

renderItem

Тип (info: ElasticCarouselItemInfo<T>) => ReactNode

keyExtractor?

Тип (item: T, index: number) => string

itemWidth?

Тип number

itemHeight?

Тип number

gap?

Тип number

snap?

Тип boolean

resistance?

Тип number

stretch?

Тип number

initialIndex?

Тип number

onIndexChange?

Тип (index: number) => void

style?

Тип StyleProp<ViewStyle>

Что получает renderItem

Пропс
Описание
item

Тип T

index

Тип number

position

Тип SharedValue<number>

step

Тип number

Методы через ref

Пропс
Описание
scrollTo

Тип (index: number) => void

tug

Тип (offset: number) => void