MotionList

ডেটা থেকে তালিকা যা শুধু বদলানোটুকু অ্যানিমেট করে।

ওয়েবReact Nativeতালিকা

চালিয়ে দেখুন

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

JavaScript বন্ধ আছে। নিচের কোডই পুরো উদাহরণ।

App.jsx

import { useState } from 'react';
import { MotionList } from '@kkwaenggwari/animated-chorus';
import './styles.css';

const ideas = [
  'Plan the launch',
  'Write release notes',
  'Record a demo',
  'Update the docs',
  'Reply to issues',
  'Tag the release',
];

export default function App({ effect = 'rise', stagger = 40, distance = 18 }) {
  const [tasks, setTasks] = useState([
    { id: 1, title: 'Review the design' },
    { id: 2, title: 'Fix the flaky test' },
    { id: 3, title: 'Ship the changelog' },
  ]);
  const [next, setNext] = useState(4);

  const add = () => {
    setTasks([{ id: next, title: ideas[next % ideas.length] }, ...tasks]);
    setNext(next + 1);
  };
  const remove = (id) => setTasks(tasks.filter((task) => task.id !== id));
  const shuffle = () => setTasks([...tasks.slice(1), tasks[0]].filter(Boolean));
  const sort = () => setTasks([...tasks].sort((a, b) => a.title.localeCompare(b.title)));

  return (
    <div className="stage">
      <div className="buttons">
        <button className="primary" onClick={add}>
          Add task
        </button>
        <button onClick={shuffle}>Move first to end</button>
        <button onClick={sort}>Sort A–Z</button>
      </div>
      <MotionList
        as="ul"
        className="tasks"
        items={tasks}
        effect={effect}
        stagger={stagger}
        distance={distance}
        renderItem={(task) => (
          <div className="task">
            <span>{task.title}</span>
            <button onClick={() => remove(task.id)}>Done</button>
          </div>
        )}
      />
    </div>
  );
}

styles.css

.stage {
  display: grid;
  gap: 16px;
  max-width: 520px;
  min-height: 360px;
  margin: 0 auto;
  padding: 24px 20px;
  align-content: start;
}

.buttons {
  display: flex;
  flex-wrap: wrap;
  gap: 8px;
}

.buttons button {
  min-height: 44px;
  padding: 0 16px;
  border: 1px solid #cfe8dc;
  border-radius: 999px;
  background: #fff;
  font:
    600 14px system-ui,
    sans-serif;
  cursor: pointer;
}

.buttons .primary {
  border-color: #176b52;
  background: #176b52;
  color: #fff;
}

.tasks {
  display: grid;
  gap: 8px;
  margin: 0;
  padding: 0;
  list-style: none;
}

.task {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  padding: 10px 10px 10px 16px;
  border: 1px solid #cfe8dc;
  border-radius: 12px;
  background: #fff;
}

.task button {
  min-height: 36px;
  padding: 0 14px;
  border: 0;
  border-radius: 999px;
  background: #eaf6f0;
  color: #176b52;
  font:
    650 13px system-ui,
    sans-serif;
  cursor: pointer;
}

সবচেয়ে ছোট ব্যবহার

Todos.jsx

<MotionList as="ul" items={todos} renderItem={(todo) => <TodoRow todo={todo} />} />;

এটি আপনার হয়ে যা সামলায়

নতুন আইটেম সীমিত ক্যাসকেডে আসে আর না-ছোঁয়া আইটেম স্থির থাকে।
সরানো আইটেম প্রবাহ ছেড়ে নিজের জায়গায় বাইরে অ্যানিমেট হয়, আর বাকিরা ফাঁকে সরে আসে।
ক্রম বদলানো আইটেম নতুন জায়গায় পিছলে যায়।
অন্য পরিবর্তনে বাধা পাওয়া নড়াচড়া নিজের বেগ ধরে রাখে।
present={false} প্রতিটি আইটেম বাইরে অ্যানিমেট করে, আর playKey প্রবেশ আবার চালায়।

যেখানে ব্যবহার করবেন

টুডু তালিকা।
ফিল্টার করা সার্চের ফলাফল।
শপিং কার্ট।

Props

Prop	টাইপ	ডিফল্ট	বিবরণ
`items`	`readonly T[]`	`—`আবশ্যক	আপনার ডেটা অ্যারে।
`getKey`	`(item) => string \| number`	`item.id`	আইটেমের জন্য অনন্য, স্থির key ফেরত দেয়। ডিফল্ট `item.id`, বা স্ট্রিং ও সংখ্যার জন্য আইটেম নিজেই।
`renderItem`	`(item, index) => ReactNode`	`item.label`	আইটেম আঁকে।
`as`	`element`	`'div'`	রেন্ডার করার এলিমেন্ট।
`itemAs`	`element`	`'li' \| 'div'`	প্রতিটি আইটেমের এলিমেন্ট।
`itemClassName`	`string`		প্রতিটি আইটেম এলিমেন্টের class; `itemStyle` তার inline স্টাইল ঠিক করে।
`effect`	`'rise' \| 'fade' \| 'scale' \| 'slide'`	`'rise'`	আইটেম কীভাবে আসে আর যায়।
`distance`	`number`	`16`	পিক্সেলে `rise` আর `slide`-এর দূরত্ব।
`stagger`	`number`	`40`	আসা আইটেমের মধ্যে মিলিসেকেন্ড।
`order`	`'forward' \| 'reverse'`	`'forward'`	ক্যাসকেডের দিক।
`present`	`boolean`	`true`	`false` লেআউট রেখে প্রতিটি আইটেম বাইরে অ্যানিমেট করে; `true` ফিরিয়ে আনে।
`initial`	`boolean`	`true`	তালিকা মাউন্ট হলে প্রবেশ চালান।
`playKey`	`string \| number`		এটি বদলালে প্রবেশ আবার চলে।
`transition`	`Transition`	`spring`	আসা আর যাওয়া আইটেমের transition।
`layoutTransition`	`Transition`	`spring`	নতুন জায়গায় পিছলে যাওয়া আইটেমের transition।

অন্য props রেন্ডার হওয়া এলিমেন্টে যায়, তাই className, style আর ইভেন্ট হ্যান্ডলার স্বাভাবিকভাবে কাজ করে।

ওয়েব আর React Native

প্রতিটি আইটেম একটি র‍্যাপার এলিমেন্ট পায় (ul বা ol-এর ভেতরে li, নাহলে div; itemAs বদলায়), যা itemClassName দিয়ে স্টাইল হয়।

key অনন্য হতে হবে। মোট উচ্চতাও অ্যানিমেট করতে তালিকাটি MotionHeight-এ মুড়ুন।