MotionHold

長按以確認危險操作；提早放開會倒轉回去。

WebReact Native手勢

動手試試

正在準備範例…

JavaScript 已關閉。下方的程式碼就是完整的範例。

App.jsx

import { useState } from 'react';
import { MotionHold, MotionSwap } from '@kkwaenggwari/animated-chorus';
import './styles.css';

export default function App({ duration = 1200 }) {
  const [deleted, setDeleted] = useState(false);

  return (
    <div className="stage">
      <div className="project">
        <MotionSwap value={deleted ? 'deleted' : 'live'} effect="up">
          {deleted ? 'Project deleted' : 'Project: Aurora'}
        </MotionSwap>
      </div>
      {deleted ? (
        <button className="restore" onClick={() => setDeleted(false)}>
          Restore project
        </button>
      ) : (
        <MotionHold
          className="hold"
          fillClassName="fill"
          duration={duration}
          onConfirm={() => setDeleted(true)}
        >
          Hold to delete
        </MotionHold>
      )}
      <p className="hint">Release early and the fill rewinds. Space and Enter work too.</p>
    </div>
  );
}

styles.css

.stage {
  display: grid;
  justify-items: center;
  gap: 18px;
  padding: 44px 20px;
}

.project {
  font:
    750 24px system-ui,
    sans-serif;
  color: #0e2e24;
}

.hold {
  position: relative;
  min-height: 52px;
  padding: 0 28px;
  overflow: hidden;
  isolation: isolate;
  border: 2px solid #0e2e24;
  border-radius: 999px;
  background: #fff;
  font:
    700 16px system-ui,
    sans-serif;
  color: #0e2e24;
  cursor: pointer;
  user-select: none;
  touch-action: none;
}

.fill {
  position: absolute;
  inset: 0;
  z-index: -1;
  background: #43c58f;
}

.restore {
  min-height: 48px;
  padding: 0 22px;
  border: 1px solid #cfe8dc;
  border-radius: 999px;
  background: #fff;
  font:
    600 15px system-ui,
    sans-serif;
  cursor: pointer;
}

.hint {
  margin: 0;
  color: #5b616b;
  font-size: 14px;
  text-align: center;
}

最簡用法

Danger.jsx

<MotionHold duration={1200} onConfirm={deleteProject}>
  Hold to delete
</MotionHold>;

它替你處理的事

按住指標、空白鍵或 Enter 時，填色會逐漸增加。
提早放開會讓填色倒轉，倒轉途中再按一次會從目前的填色繼續。
按住時按鈕會下沉，確認時彈起一次。

適用情境

刪除專案。
長按付款。
重設設定。

Props

Prop	型別	預設值	說明
`children`	`ReactNode`		按鈕的標籤。
`onConfirm`	`() => void`		長按完成時執行一次。
`duration`	`number`	`1200`	需要按住的毫秒數。
`disabled`	`boolean`	`false`	停用按鈕。
`fillClassName`	`string`		逐漸增加之填色的 class；`fillStyle` 設定其行內樣式。

其他 props 會傳給渲染的元素，所以 className、style 與事件處理函式照常可用。

Web 與 React Native

以 fillClassName 或 fillStyle 設定填色樣式；其他 props 會傳給 button。

在 React Native 上，無障礙的啟用動作會直接確認，因為使用輔助技術時很難長按。

用到它的範例

結帳摘要購物車改變時，數量、小計與總額都會滾動；優惠券提示會進出場；付款需要刻意長按。MotionListMotionNumberMotionPresenceMotionHold