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