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} />} />;

तुमच्यासाठी काय हाताळतो

नवीन वस्तू मर्यादित stagger सह प्रवेश करतात आणि न बदललेल्या स्थिर राहतात.
काढलेल्या वस्तू प्रवाहातून बाहेर पडून जिथे होत्या तिथेच ॲनिमेट होत जातात, आणि बाकीच्या रिकाम्या जागेत सरकतात.
क्रम बदललेल्या वस्तू नवीन जागी सरकतात.
दुसऱ्या बदलाने व्यत्यय आलेल्या हालचाली त्यांचा वेग राखतात.
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 style सेट करते.
`effect`	`'rise' \| 'fade' \| 'scale' \| 'slide'`	`'rise'`	वस्तू कशा येतात आणि जातात.
`distance`	`number`	`16`	`rise` आणि `slide` चे प्रवास अंतर, पिक्सेलमध्ये.
`stagger`	`number`	`40`	प्रवेश करणाऱ्या वस्तूंमधील मिलिसेकंद.
`order`	`'forward' \| 'reverse'`	`'forward'`	Stagger ची दिशा.
`present`	`boolean`	`true`	`false` लेआउट राखून प्रत्येक वस्तू ॲनिमेट करून बाहेर काढते; `true` त्यांना परत आणते.
`initial`	`boolean`	`true`	सूची माउंट झाल्यावर प्रवेश चालवा.
`playKey`	`string \| number`		हे बदलल्यास प्रवेश पुन्हा चालतो.
`transition`	`Transition`	`spring`	प्रवेश करणाऱ्या आणि बाहेर पडणाऱ्या वस्तूंसाठी ट्रान्झिशन.
`layoutTransition`	`Transition`	`spring`	नवीन जागी सरकणाऱ्या वस्तूंसाठी ट्रान्झिशन.

इतर props रेंडर होणाऱ्या एलिमेंटकडे जातात, त्यामुळे className, style आणि इव्हेंट हँडलर नेहमीप्रमाणे चालतात.

वेब आणि React Native

प्रत्येक वस्तूला itemClassName ने शैली दिलेला रॅपर एलिमेंट मिळतो (ul किंवा ol मध्ये li, अन्यथा div; itemAs ते बदलते).

key अद्वितीय असणे आवश्यक. एकूण उंचीही ॲनिमेट करण्यासाठी सूची MotionHeight मध्ये गुंडाळा.