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 में लपेटें।