Компоненты/Поворотная ручка

Поворотная ручка

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
НазадБарабанный счётчикДалееКарусель-поворот

Ручка вращается жестом вокруг центра: угол считается через atan2, приращения копятся, у крайних упоров включается резиновое сопротивление. Между делениями ручку слегка притягивает к ближайшему упору, быстрый бросок докручивается по инерции и оседает на делении. На iOS и Android каждый пройденный упор отдаёт лёгкую вибрацию, в вебе вместо неё только вспышка деления. Ручка, насечки и шкала рисуются в Skia.

Вручную

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

npm install expo-status-bar react-native-gesture-handler react-native-reanimated @shopify/react-native-skia expo-haptics react-native-worklets
pnpm add expo-status-bar react-native-gesture-handler react-native-reanimated @shopify/react-native-skia expo-haptics react-native-worklets
yarn add expo-status-bar react-native-gesture-handler react-native-reanimated @shopify/react-native-skia expo-haptics react-native-worklets
bun add expo-status-bar react-native-gesture-handler react-native-reanimated @shopify/react-native-skia expo-haptics react-native-worklets

Скопируйте эти файлы в src/shared/components/organisms/rotary-knob/:

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

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

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

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

Пропсы

Пропс
Описание
value?

Тип number

defaultValue?

Тип number

onValueChange?

Тип (value: number) => void

min?

Тип number

max?

Тип number

steps?

Тип number

size?

Тип number

sweep?

Тип number

accent?

Тип string

label?

Тип string

formatValue?

Тип (value: number) => string

haptics?

Тип boolean

disabled?

Тип boolean

theme?

Тип TRotaryKnobTheme

style?

Тип StyleProp<ViewStyle>