MotionSwipe

स्वाइप से दिखने वाले एक्शन और वैकल्पिक स्वाइप से हटाने वाली पंक्ति।

वेबReact Nativeजेस्चर

आज़माएँ

उदाहरण तैयार हो रहा है…

JavaScript बंद है। नीचे का कोड पूरा उदाहरण है।

App.jsx

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

const inbox = [
  { id: 1, from: 'Design team', subject: 'New motion tokens are ready' },
  { id: 2, from: 'Build bot', subject: 'All checks passed on main' },
  { id: 3, from: 'Hana', subject: 'Lunch on Friday?' },
  { id: 4, from: 'Support', subject: 'Your export is complete' },
];

export default function App({ dismiss = 'end', spring = 'default' }) {
  const [messages, setMessages] = useState(inbox);
  const [pinned, setPinned] = useState([]);
  const remove = (id) => setMessages(messages.filter((message) => message.id !== id));
  const pin = (id) =>
    setPinned(pinned.includes(id) ? pinned.filter((item) => item !== id) : [...pinned, id]);

  return (
    <div className="stage">
      {/* The list animates rows that leave by a button and rows that come back. */}
      <MotionList
        className="rows"
        items={messages}
        renderItem={(message) => (
          <MotionSwipe
            className="row"
            contentClassName="content"
            dismiss={dismiss === 'none' ? undefined : dismiss}
            onDismiss={() => remove(message.id)}
            transition={motionTokens.spring[spring]}
            startActions={
              <button className="action pin" onClick={() => pin(message.id)}>
                {pinned.includes(message.id) ? 'Unpin' : 'Pin'}
              </button>
            }
            endActions={
              <button className="action archive" onClick={() => remove(message.id)}>
                Archive
              </button>
            }
          >
            <strong>
              {pinned.includes(message.id) ? '● ' : ''}
              {message.from}
            </strong>
            <span>{message.subject}</span>
          </MotionSwipe>
        )}
      />
      {messages.length === 0 && <p className="empty">Inbox zero.</p>}
      <button className="restore" onClick={() => setMessages(inbox)}>
        Restore messages
      </button>
    </div>
  );
}

styles.css

.stage {
  display: grid;
  gap: 8px;
  max-width: 520px;
  margin: 0 auto;
  padding: 24px 20px;
}

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

.row {
  border-radius: 14px;
  background: #eaf6f0;
}

.content {
  display: grid;
  gap: 2px;
  padding: 14px 18px;
  border: 1px solid #cfe8dc;
  border-radius: 14px;
  background: #fff;
  user-select: none;
}

.content strong {
  color: #0e2e24;
}

.content span {
  color: #5b616b;
}

.action {
  height: 100%;
  min-width: 88px;
  padding: 0 18px;
  border: 0;
  font:
    650 14px system-ui,
    sans-serif;
  color: #fff;
  cursor: pointer;
}

.archive {
  border-radius: 0 14px 14px 0;
  background: #176b52;
}

.pin {
  border-radius: 14px 0 0 14px;
  background: #2e8f6d;
}

.empty {
  margin: 12px 0;
  color: #5b616b;
  text-align: center;
}

.restore {
  justify-self: center;
  min-height: 40px;
  margin-top: 8px;
  padding: 0 16px;
  border: 1px solid #cfe8dc;
  border-radius: 999px;
  background: #fff;
  font:
    600 14px system-ui,
    sans-serif;
  cursor: pointer;
}

सबसे छोटा इस्तेमाल

Row.jsx

<MotionSwipe
  endActions={<button onClick={() => archive(id)}>Archive</button>}
  dismiss="end"
  onDismiss={() => remove(id)}
>
  <MessagePreview />
</MotionSwipe>;

यह आपके लिए क्या संभालता है

पंक्ति क्षैतिज खिंचाव के साथ चलती है, अपने एक्शन के पार प्रतिरोध करती है और आपके छोड़ने की गति से ठहरती है।
dismiss के साथ लंबा स्वाइप या फेंकना पंक्ति को बाहर खिसकाता है, उसकी ऊँचाई समेटता है और फिर onDismiss(side) कॉल करता है।
लंबवत स्क्रॉल चलता रहता है, और सिर्फ़ एक पंक्ति खुली रहती है।
खुली पंक्ति पर टैप उसे बंद करता है, और किसी एक्शन पर कीबोर्ड फ़ोकस उसे दिखाता है।

इसके लिए इस्तेमाल करें

इनबॉक्स में आर्काइव या डिलीट।
बातचीत पिन करें।
सूची से आइटम हटाएँ।

Props

Prop	टाइप	डिफ़ॉल्ट	विवरण
`children`	`ReactNode`		पंक्ति की सामग्री।
`startActions`	`ReactNode`		पंक्ति को अंत की ओर खींचने पर inline शुरुआत में दिखते हैं।
`endActions`	`ReactNode`		पंक्ति को शुरुआत की ओर खींचने पर inline अंत में दिखते हैं।
`dismiss`	`'start' \| 'end' \| 'both'`		वे दिशाएँ जहाँ लंबा स्वाइप या फेंकना पंक्ति हटाता है।
`onDismiss`	`(side) => void`		पंक्ति के बाहर खिसकने और सिमटने के बाद चलता है; यहाँ आइटम अपने डेटा से हटाएँ।
`onOpenChange`	`(side \| null) => void`		खुली दिशा के साथ चलता है, या पंक्ति बंद होने पर `null` के साथ।
`disabled`	`boolean`	`false`	स्वाइप बंद करता है।
`contentClassName`	`string`		पंक्ति की सामग्री की class; `contentStyle` उसकी inline स्टाइल तय करता है।
`transition`	`Transition`	`spring`	timing वक्र `{ duration, easing }` या स्प्रिंग `{ tempo: 'spring', spring }`। रुकने पर स्प्रिंग अपनी गति बनाए रखते हैं।

बाक़ी props रेंडर होने वाले एलिमेंट को जाते हैं, इसलिए className, style और इवेंट हैंडलर सामान्य रूप से काम करते हैं।

वेब और React Native

inline अंत की ओर खींचने पर startActions दिखते हैं, शुरुआत की ओर खींचने पर endActions। पंक्ति की सामग्री को contentClassName से बैकग्राउंड दें।

React Native वही props और जेस्चर इस्तेमाल करता है।

इन उदाहरणों में इस्तेमाल

इनबॉक्सलाइव गिनती वाले फ़िल्टर टैब, स्वाइप से हटने वाली पंक्तियाँ और ख़ाली जगह भरने वाली सूची।MotionHighlightMotionListMotionSwipeMotionNumber