గైడ్‌లు · 07

React Native నుండి వస్తున్నవారికి

ఏది అలాగే ఉంటుంది, ఏది మారుతుంది, వెబ్ ఏమి జోడిస్తుంది.

అవే కాల్‌లు

కంట్రోలర్‌లు, గ్రాఫ్‌లు, కాన్ఫిగ్‌లు React Native యొక్క Animated-ను అనుసరిస్తాయి. React Native Animated.View రెండర్ చేసే చోట Animated.div వంటి DOM హోస్ట్‌లను రెండర్ చేయండి. useAnimatedValue React Native-లో లాగే అందుబాటులో ఉంది.

ఉదాహరణ సిద్ధమవుతోంది…

JavaScript ఆఫ్‌లో ఉంది. కింద ఉన్న కోడే పూర్తి ఉదాహరణ.

App.jsx

import { useEffect } from 'react';
import { Animated, Easing, useAnimatedValue } from '@kkwaenggwari/animated';
import './styles.css';

// The same calls as React Native. Animated.View becomes Animated.div.
export default function App({ duration = 1200 }) {
  const spin = useAnimatedValue(0);
  const pulse = useAnimatedValue(0);
  const scrollY = useAnimatedValue(0);

  useEffect(() => {
    const animation = Animated.parallel([
      Animated.loop(
        Animated.timing(spin, {
          toValue: 1,
          duration,
          easing: Easing.linear,
          useNativeDriver: true,
        }),
      ),
      Animated.loop(
        Animated.sequence([
          Animated.timing(pulse, { toValue: 1, duration: duration / 2, useNativeDriver: true }),
          Animated.timing(pulse, { toValue: 0, duration: duration / 2, useNativeDriver: true }),
        ]),
      ),
    ]);
    animation.start();
    return () => animation.stop();
  }, [duration]);

  const rotate = spin.interpolate({ inputRange: [0, 1], outputRange: ['0deg', '360deg'] });
  const scale = pulse.interpolate({ inputRange: [0, 1], outputRange: [1, 1.25] });
  const headerScale = scrollY.interpolate({
    inputRange: [0, 120],
    outputRange: [1, 0.6],
    extrapolate: 'clamp',
  });

  return (
    <div className="stage">
      <div className="row">
        <Animated.div className="spinner" style={{ transform: [{ rotate }] }} />
        <Animated.div className="dot" style={{ transform: [{ scale }] }} />
      </div>
      <div
        className="scroll"
        onScroll={Animated.event([{ nativeEvent: { contentOffset: { y: scrollY } } }], {
          useNativeDriver: false,
        })}
      >
        <Animated.div className="header" style={{ transform: [{ scale: headerScale }] }}>
          Scroll this list
        </Animated.div>
        {Array.from({ length: 12 }, (_, index) => (
          <div key={index} className="item">
            Row {index + 1}
          </div>
        ))}
      </div>
    </div>
  );
}

styles.css

.stage {
  display: grid;
  gap: 18px;
  padding: 28px;
}

.row {
  display: flex;
  align-items: center;
  gap: 28px;
}

.spinner {
  width: 56px;
  height: 56px;
  border: 6px solid #eef2ff;
  border-top-color: #2854ff;
  border-radius: 50%;
}

.dot {
  width: 40px;
  height: 40px;
  border-radius: 50%;
  background: #5c7cff;
}

.scroll {
  height: 220px;
  max-width: 420px;
  border: 1px solid #e4e6ef;
  border-radius: 16px;
  overflow-y: auto;
}

.header {
  position: sticky;
  top: 0;
  padding: 18px;
  background: #2854ff;
  color: #fff;
  font-weight: 700;
  transform-origin: left top;
}

.item {
  padding: 14px 18px;
  border-top: 1px solid #f0f1f7;
}

తెలుసుకోవాల్సిన తేడాలు

ఈ వివరాలు తీసుకొచ్చిన కోడ్ పరికరంలో ఎలా ప్రవర్తించిందో అలాగే ప్రవర్తించేలా చేస్తాయి.

useNativeDriver, isInteraction స్వీకరించబడతాయి. ప్లేబ్యాక్ బదులుగా ప్రతి అవుట్‌పుట్‌కు ఎంచుకోబడుతుంది: అర్హమైన అవుట్‌పుట్‌లు బ్రౌజర్‌లో, మిగతావి JavaScript-లో.
spring stiffness/damping/mass, bounciness/speed లేదా tension/friction-ను స్వీకరిస్తుంది; ఏదీ ఇవ్వకపోతే React Native డిఫాల్ట్.
interpolate easing-కు, మూడు extrapolation మోడ్‌లకు మద్దతు ఇస్తుంది.
Easing React Native‌తో, elastic‌తో సహా, సరిపోలుతుంది. Easing.exp సరిగ్గా 0 వద్ద ప్రారంభం కావడానికి 0.1% మళ్లీ స్కేల్ చేయబడుతుంది; అందువల్ల బ్రౌజర్ ప్లేబ్యాక్ వాడగలదు.
React Native లాగే, decay వేగం మిల్లీసెకనుకు యూనిట్‌లలో, spring వేగం సెకనుకు యూనిట్‌లలో ఉంటుంది.
Animated.createAnimatedComponent ref-ఫార్వర్డింగ్ కాంపోనెంట్‌ను చుడుతుంది.

Spinner.jsx

// React Native
<Animated.View style={{ transform: [{ rotate }] }} />

// React DOM with @kkwaenggwari/animated — the rest is identical
<Animated.div style={{ transform: [{ rotate }] }} />

const spin = useAnimatedValue(0);
const rotate = spin.interpolate({ inputRange: [0, 1], outputRange: ['0deg', '360deg'] });

Animated.loop(
  Animated.timing(spin, { toValue: 1, duration: 900, easing: Easing.linear, useNativeDriver: true }),
).start();

వెబ్ ఏమి జోడిస్తుంది

సాధారణ React style హుక్ విలువలను నేరుగా స్వీకరిస్తుంది, seed/pose/respond గమ్యాలను, సంజ్ఞలను వివరిస్తాయి, Animated.Keep, Animated.Scene నిష్క్రమణలను, లేఅవుట్‌ను నిర్వహిస్తాయి.