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`		ปรากฏที่ต้นบรรทัดเมื่อแถวถูกลากไปทางปลาย
`endActions`	`ReactNode`		ปรากฏที่ปลายบรรทัดเมื่อแถวถูกลากไปทางต้น
`dismiss`	`'start' \| 'end' \| 'both'`		ด้านที่การปัดยาวหรือการเหวี่ยงจะลบแถว
`onDismiss`	`(side) => void`		ทำงานหลังแถวเลื่อนออกและยุบแล้ว ให้ลบรายการออกจากข้อมูลของคุณที่นี่
`onOpenChange`	`(side \| null) => void`		ทำงานพร้อมด้านที่เปิด หรือ `null` เมื่อแถวปิด
`disabled`	`boolean`	`false`	ปิดการปัด
`contentClassName`	`string`		คลาสของเนื้อหาแถว `contentStyle` กำหนดสไตล์ inline ของมัน
`transition`	`Transition`	`spring`	เส้นโค้ง timing `{ duration, easing }` หรือสปริง `{ tempo: 'spring', spring }` สปริงรักษาโมเมนตัมไว้เมื่อถูกขัดจังหวะ

props อื่นจะส่งต่อไปยังองค์ประกอบที่เรนเดอร์ className, style และตัวจัดการเหตุการณ์จึงทำงานตามปกติ

เว็บและ React Native

startActions ปรากฏเมื่อลากไปทางปลายบรรทัด endActions ปรากฏเมื่อลากไปทางต้นบรรทัด ให้พื้นหลังแก่เนื้อหาแถวด้วย contentClassName

React Native ใช้ props และท่าทางเดียวกัน

ใช้ในตัวอย่างเหล่านี้

กล่องจดหมายแท็บตัวกรองพร้อมจำนวนแบบสด แถวที่ปัดทิ้งได้ และรายการที่ปิดช่องว่างเองMotionHighlightMotionListMotionSwipeMotionNumber