শুরু · ৪টি ধাপ

শুরু করুন

প্যাকেজ ইনস্টল করুন, প্রথম কম্পোনেন্ট রেন্ডার করুন, কম্পোনেন্টকে নিজের ডেটা দিন আর বাছুন সেটি কীভাবে চলবে। কোনো ধাপেই provider বা সেটআপ নেই।

  1. ইনস্টল করুন

    Chorus-এর React 19.2 বা নতুন সংস্করণ দরকার। React Native অ্যাপে React Native ঐচ্ছিক peer নির্ভরতা, আর একই প্যাকেজ নিজের নেটিভ বিল্ড নিজে বেছে নেয়।

    npm install @kkwaenggwari/animated-chorus

    আর কিছু কনফিগার করতে হয় না: কোনো provider, প্লাগইন বা স্টাইলশিট যোগ করতে হয় না।

  2. আপনার প্রথম কম্পোনেন্ট

    স্টেটের মান দিয়ে MotionNumber রেন্ডার করুন। স্টেট বদলালে সংখ্যা ঘোরে। +1 চাপুন, তারপর ×10 চেপে নতুন অঙ্ক ঘুরে আসতে দেখুন।

    App.jsx
    import { useState } from 'react';
    import { MotionNumber } from '@kkwaenggwari/animated-chorus';
    
    export default function App() {
      const [count, setCount] = useState(9);
      return (
        <button onClick={() => setCount(count + 1)}>
          <MotionNumber value={count} />
        </button>
      );
    }

    উদাহরণ প্রস্তুত হচ্ছে…

    সেটিংসে mode-কে roll করুন: বদলানো অঙ্কগুলো মাঝের অঙ্ক পেরিয়ে যায়।

  3. নিজের ডেটা দিন

    একাধিক জিনিস দেখানো কম্পোনেন্ট অ্যারে নেয়। items আপনার ডেটা, getKey স্থির key ফেরত দেয় (ডিফল্ট item.id, বা স্ট্রিং ও সংখ্যার জন্য আইটেম নিজেই), আর renderItem প্রতিটি আইটেম আঁকে। কম্পোনেন্ট আপনার হয়ে আইটেম এলিমেন্ট রেন্ডার করে আর মাপে।

    Tabs.jsx
    import { MotionHighlight } from '@kkwaenggwari/animated-chorus';
    
    const tabs = [
      { id: 'overview', label: 'Overview' },
      { id: 'activity', label: 'Activity' },
    ];
    
    export function Tabs({ tab, setTab }) {
      // Keys come from item.id; labels from item.label, or renderItem.
      return <MotionHighlight items={tabs} value={tab} onValueChange={setTab} />;
    }

    key অনন্য হতে হবে। অ্যারে বদলালে শুধু আসা, যাওয়া বা সরে যাওয়া আইটেম অ্যানিমেট হয়।

  4. বাছুন কীভাবে চলবে

    প্রতিটি কম্পোনেন্ট একটি transition নেয়: timing বক্ররেখা বা স্প্রিং। motionTokens কয়েকটি প্রিসেট দেয়, আর duration-সহ স্প্রিং ঠিক তখনই শেষ হতে সমন্বিত।

    Panel.jsx
    import { MotionHeight, motionTokens } from '@kkwaenggwari/animated-chorus';
    
    <MotionHeight open={open} transition={motionTokens.spring.gentle}>…</MotionHeight>
    <MotionHeight open={open} transition={{ duration: 300, easing: 'easeOut' }}>…</MotionHeight>
    <MotionHeight open={open} transition={{ tempo: 'spring', spring: { stiffness: 300, damping: 30 }, duration: 500 }}>…</MotionHeight>

    React Native একই ইমপোর্ট আর একই props ব্যবহার করে।

খুঁজুন

ডকুমেন্টেশনে খুঁজতে টাইপ করুন।