Компоненты/Лайтбокс

Лайтбокс

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
НазадПерспективная лента фотоДалееФото-лайтбокс

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

Нажатие на превью переводит фото из его места в сетке на весь экран: рамка превью плавно превращается в рамку всего снимка с исходными пропорциями. Внутри — щипок с фокусом между пальцами, двойной тап для приближения в точку, перетаскивание приближенного снимка с границами.

Без зума фото можно утянуть вверх или вниз: фон гаснет, снимок уменьшается, а за порогом dismissDistance возвращается в свою ячейку. Одиночный тап тоже закрывает. Просмотр открывается в Modal, так что перекрывает навигацию и вкладки.

Вручную

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

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/organisms/photo-lightbox/:

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

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

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

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

Пропсы

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

Тип readonly PhotoLightboxImage[]

columns?

Тип number

gap?

Тип number

radius?

Тип number

thumbAspect?

Тип number

backdropColor?

Тип string

maxZoom?

Тип number

doubleTapZoom?

Тип number

dismissDistance?

Тип number

onOpen?

Тип (index: number) => void

onClose?

Тип (index: number) => void

style?

Тип StyleProp<ViewStyle>

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

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

Тип (index: number) => void

close

Тип () => void