MotionPresence

在进场和离场动画期间保持内容挂载。

WebReact Native内容与尺寸

动手试试

正在准备示例…

JavaScript 已关闭。下面的代码就是完整的示例。

App.jsx

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

const exits = {
  rise: { opacity: 0, translateY: -16 },
  fall: { opacity: 0, translateY: 16 },
  shrink: { opacity: 0, scale: 0.9 },
};

export default function App({ exit = 'rise', duration = 320 }) {
  const [visible, setVisible] = useState(true);
  const [saved, setSaved] = useState(1);

  const save = () => {
    setSaved(saved + 1);
    setVisible(true);
  };

  return (
    <div className="stage">
      <div className="slot">
        <MotionPresence
          present={visible}
          exit={exits[exit]}
          transition={{ duration, easing: 'easeOut' }}
          className="notice"
        >
          <span>Draft {saved} saved</span>
          <button onClick={() => setVisible(false)}>Dismiss</button>
        </MotionPresence>
      </div>
      <div className="buttons">
        <button onClick={save}>Save draft</button>
        <button onClick={() => setVisible(!visible)}>{visible ? 'Hide' : 'Show'} notice</button>
      </div>
    </div>
  );
}

styles.css

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

.slot {
  display: grid;
  place-items: center;
  min-height: 64px;
  width: min(100%, 420px);
}

.notice {
  display: flex;
  width: 100%;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  padding: 12px 12px 12px 18px;
  border-radius: 14px;
  background: #0e2e24;
  color: #fff;
}

.notice button {
  min-height: 36px;
  padding: 0 14px;
  border: 1px solid rgba(255, 255, 255, 0.3);
  border-radius: 999px;
  background: none;
  color: #fff;
  font:
    600 14px system-ui,
    sans-serif;
  cursor: pointer;
}

.buttons {
  display: flex;
  flex-wrap: wrap;
  justify-content: center;
  gap: 8px;
}

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

.buttons button:first-child {
  border-color: #176b52;
  background: #176b52;
  color: #fff;
}

最简用法

Notice.jsx

<MotionPresence present={visible} exit={{ opacity: 0, translateY: -12 }}>
  Draft saved
</MotionPresence>;

它替你处理的事

改变 present 而不是卸载；内容会先离场再被移除。
离场途中恢复显示，会从当前值继续。
再次出现的内容从 exit 姿态进场。
首次渲染时直接显示静止状态，已有的内容不会闪烁。

适用场景

草稿已保存的提示。
结账页的优惠券消息。
输入框下方的错误信息。

Props

Prop	类型	默认值	说明
`present`	`boolean`	`—`必需	显示或隐藏内容。用它代替卸载。
`enter`	`Pose`	`{ opacity: 1, translateY: 0 }`	静止时的姿态。
`exit`	`Pose`	`{ opacity: 0, translateY: -12 }`	内容离场以及进场时使用的姿态。
`as`	`element`	`'div'`	要渲染的元素。
`transition`	`Transition`	`spring`	时间曲线 `{ duration, easing }` 或弹簧 `{ tempo: 'spring', spring }`。弹簧被打断时会保留动量。
`onExitComplete`	`() => void`		内容离场并被移除后运行。

其他 props 会传给渲染的元素，所以 className、style 和事件处理函数照常可用。

Web 与 React Native

姿态可使用 opacity、translateX、translateY、scale、scaleX、scaleY、rotate、width 和 height。onExitComplete 在内容离场后运行。

同样的姿态和 props 在 React Native 上也能用。

用到它的示例

结账摘要购物车变化时，数量、小计和总额都会滚动；优惠券提示会进出场；付款需要刻意长按。MotionListMotionNumberMotionPresenceMotionHold