前后对比滑杆

用可拖动分割线比较同一画面的前后状态。

预览

实时预览

通过可拖动分割线在两张叠放图片之间擦拭切换,以便对比。

预览
调整前
调整后
权威词义

术语定义与近义词辨析

英文定义逐字保留自 Animation Vocabulary;中文翻译和辨析帮助你选对术语。

核心术语before-after-slider

前后对比滑杆

Before / after slider
权威英文定义

A draggable divider that wipes between two overlaid images to compare them.

中文翻译

通过可拖动分割线在两张叠放图片之间擦拭切换,以便对比。

查看全部 91 个术语
设计规范

使用这段动效前的判断

目的、频率、触发、时序、可打断性和手势规则共同决定实现。

目的

通过可拖动分割线比较同一画面的两个叠加状态。

频率

适合用户主动探索的低频比较任务;默认位置应立即表达差异。

触发

由拖动分割线、点击轨道或键盘方向键触发。

进入 / 离开

组件初始直接显示两个状态,拖动只改变裁切边界,不播放自动入场。

可打断性

输入中断时停在当前位置;新的指针或键盘输入从当前比例继续。

手势与键盘

使用指针捕获、44px 手柄、方向键步进和 Home/End;标签说明两侧含义。

减弱动效策略

保留可操作分割线,取消位置补间;键盘和指针仍即时更新静态裁切。

输出

复制到你的界面

当前参数会同步生成视觉状态 CSS、语义 HTML、所需的原生 JS 运行时和交互提示词。

随参数实时更新
motion.css
.motion-demo.motion-demo--before-after-slider {
  position: relative;
  display: grid;
  place-items: center;
  width: min(100%, 34rem);
  min-height: 15rem;
  padding: 2rem;
  overflow: hidden;
  color: #18181b;
  background: #fafafa;
  border: 1px solid #e4e4e7;
  border-radius: 12px;
  isolation: isolate;
}

.motion-demo.motion-demo--before-after-slider *, .motion-demo.motion-demo--before-after-slider *::before, .motion-demo.motion-demo--before-after-slider *::after {
  box-sizing: border-box;
}

.motion-demo.motion-demo--before-after-slider .motion-surface {
  position: relative;
  display: grid;
  gap: 0.65rem;
  width: min(100%, 18rem);
  padding: 1.25rem;
  background: #ffffff;
  border: 1px solid #e4e4e7;
  border-radius: 8px;
  box-shadow: 0 1px 2px rgb(0 0 0 / 6%), 0 10px 28px rgb(0 0 0 / 7%);
}

.motion-demo.motion-demo--before-after-slider .motion-line {
  display: block;
  width: 100%;
  height: 0.5rem;
  background: #e4e4e7;
  border-radius: 999px;
}

.motion-demo.motion-demo--before-after-slider .motion-line:last-child { width: 62%; }

.motion-demo.motion-demo--before-after-slider .motion-button {
  position: relative;
  min-height: 2.75rem;
  padding: 0.75rem 1.1rem;
  color: white;
  font: inherit;
  font-weight: 700;
  background: #18181b;
  border: 0;
  border-radius: 7px;
  cursor: pointer;
}

.motion-demo.motion-demo--before-after-slider .motion-button:focus-visible { outline: 3px solid rgb(37 99 235 / 32%); outline-offset: 3px; }

.motion-demo.motion-demo--before-after-slider .motion-action-row {
  display: flex;
  justify-content: center;
  gap: 0.5rem;
  margin-top: 0.85rem;
}

.motion-demo.motion-demo--before-after-slider .motion-replay-scene {
  width: min(100%, 22rem);
  display: grid;
  place-items: center;
}

.motion-demo.motion-demo--before-after-slider .motion-pausable-scene {
  width: min(100%, 22rem);
  display: grid;
  place-items: center;
}

.motion-demo.motion-demo--before-after-slider button.motion-surface {
  color: inherit;
  font: inherit;
  text-align: start;
  cursor: pointer;
}

.motion-demo.motion-demo--before-after-slider .motion-replay-button,
.motion-demo.motion-demo--before-after-slider .motion-undo-button,
.motion-demo.motion-demo--before-after-slider .motion-dismiss-button,
.motion-demo.motion-demo--before-after-slider .motion-pause-button {
  min-height: 2.75rem;
  padding: 0.65rem 0.9rem;
  color: #18181b;
  font: 650 0.78rem/1 ui-sans-serif, system-ui, sans-serif;
  background: #ffffff;
  border: 1px solid #d4d4d8;
  border-radius: 7px;
  cursor: pointer;
}

.motion-demo.motion-demo--before-after-slider .motion-replay-button:focus-visible,
.motion-demo.motion-demo--before-after-slider .motion-undo-button:focus-visible,
.motion-demo.motion-demo--before-after-slider .motion-dismiss-button:focus-visible,
.motion-demo.motion-demo--before-after-slider .motion-pause-button:focus-visible,
.motion-demo.motion-demo--before-after-slider [data-reorder-item]:focus-visible,
.motion-demo.motion-demo--before-after-slider [data-swipe-target]:focus-visible {
  outline: 3px solid rgb(37 99 235 / 32%);
  outline-offset: 3px;
}

.motion-demo.motion-demo--before-after-slider .motion-status {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

.motion-demo.motion-demo--before-after-slider .motion-ripple-ink {
  position: absolute;
  width: 12px;
  height: 12px;
  pointer-events: none;
  background: rgb(255 255 255 / 72%);
  border-radius: 50%;
  transform: translate(-50%, -50%) scale(0.95);
  opacity: 0;
}

.motion-demo.motion-demo--before-after-slider .motion-state-stack { position: relative; width: min(100%, 18rem); height: 9rem; }
.motion-demo.motion-demo--before-after-slider .motion-state { position: absolute; inset: 0; display: grid; place-items: center; padding: 1rem; background: #ffffff; border: 1px solid #e4e4e7; border-radius: 8px; }
.motion-demo.motion-demo--before-after-slider .motion-state--to { background: #18181b; color: white; }

.motion-demo.motion-demo--before-after-slider .motion-scroll-track > span { color: #71717a; font: 600 0.72rem/1.2 ui-monospace, monospace; letter-spacing: 0.08em; text-transform: uppercase; }
.motion-demo.motion-demo--before-after-slider .motion-orbit-item { display: grid; place-items: center; width: 2.5rem; height: 2.5rem; color: white; background: #2563eb; border-radius: 50%; }
.motion-demo.motion-demo--before-after-slider .motion-text-stack { position: relative; width: min(100%, 18rem); min-height: 4rem; }
.motion-demo.motion-demo--before-after-slider svg { width: min(100%, 20rem); height: auto; }

.motion-demo.motion-demo--before-after-slider .motion-comparison { position: relative; width: min(100%, 22rem); aspect-ratio: 16 / 9; overflow: hidden; border-radius: 8px; background: #52525b; }
.motion-demo.motion-demo--before-after-slider .motion-before, .motion-demo.motion-demo--before-after-slider .motion-after { position: absolute; inset: 0; display: grid; place-items: center; color: white; }
.motion-demo.motion-demo--before-after-slider .motion-after { overflow: hidden; background: #2563eb; clip-path: inset(0 50% 0 0); }
.motion-demo.motion-demo--before-after-slider .motion-divider { position: absolute; inset: 0 auto 0 0; width: 2px; pointer-events: none; background: white; box-shadow: 0 0 0 1px rgb(0 0 0 / 18%); transform: translate3d(0, 0, 0); }
.motion-demo.motion-demo--before-after-slider .motion-divider::after { content: "↔"; position: absolute; top: 50%; left: 50%; width: 2.25rem; height: 2.25rem; display: grid; place-items: center; color: #18181b; background: white; border-radius: 50%; transform: translate(-50%, -50%); box-shadow: 0 2px 8px rgb(0 0 0 / 18%); }
.motion-demo.motion-demo--before-after-slider .motion-comparison-control { position: absolute; inset: 0; z-index: 2; width: 100%; height: 100%; margin: 0; cursor: ew-resize; opacity: 0; }

@keyframes motion-before-after-slider-reduced-fade {
  from { opacity: 0.84; }
  to { opacity: 1; }
}

.force-reduced-motion .motion-demo.motion-demo--before-after-slider {
  animation: motion-before-after-slider-reduced-fade 160ms cubic-bezier(0.23, 1, 0.32, 1) both !important;
}

.force-reduced-motion .motion-demo.motion-demo--before-after-slider *,
.force-reduced-motion .motion-demo.motion-demo--before-after-slider *::before,
.force-reduced-motion .motion-demo.motion-demo--before-after-slider *::after {
  animation: none !important;
  animation-delay: 0ms !important;
  animation-iteration-count: 1 !important;
  transition-property: opacity, color, background-color, border-color !important;
  transition-duration: 160ms !important;
  transition-delay: 0ms !important;
  scroll-behavior: auto !important;
}

.force-reduced-motion .motion-demo.motion-demo--before-after-slider .motion-button,
.force-reduced-motion .motion-demo.motion-demo--before-after-slider [data-reorder-item],
.force-reduced-motion .motion-demo.motion-demo--before-after-slider [data-swipe-target],
.force-reduced-motion .motion-demo.motion-demo--before-after-slider [data-spring-target] {
  transform: none !important;
}

.force-reduced-motion .motion-demo.motion-demo--before-after-slider .motion-path { stroke-dashoffset: 0 !important; }
.force-reduced-motion .motion-demo.motion-demo--before-after-slider .motion-word--from { opacity: 0 !important; visibility: hidden; }
.force-reduced-motion .motion-demo.motion-demo--before-after-slider .motion-word:not(.motion-word--from) { opacity: 1 !important; filter: none !important; transform: none !important; }

@media (prefers-reduced-motion: reduce) {
  .motion-demo.motion-demo--before-after-slider {
    animation: motion-before-after-slider-reduced-fade 160ms cubic-bezier(0.23, 1, 0.32, 1) both !important;
  }

  .motion-demo.motion-demo--before-after-slider *, .motion-demo.motion-demo--before-after-slider *::before, .motion-demo.motion-demo--before-after-slider *::after {
    animation: none !important;
    animation-delay: 0ms !important;
    animation-iteration-count: 1 !important;
    transition-property: opacity, color, background-color, border-color !important;
    transition-duration: 160ms !important;
    transition-delay: 0ms !important;
    scroll-behavior: auto !important;
  }

  .motion-demo.motion-demo--before-after-slider .motion-button,
  .motion-demo.motion-demo--before-after-slider [data-reorder-item],
  .motion-demo.motion-demo--before-after-slider [data-swipe-target],
  .motion-demo.motion-demo--before-after-slider [data-spring-target] {
    transform: none !important;
  }

  .motion-demo.motion-demo--before-after-slider .motion-path { stroke-dashoffset: 0 !important; }
  .motion-demo.motion-demo--before-after-slider .motion-word--from { opacity: 0 !important; visibility: hidden; }
  .motion-demo.motion-demo--before-after-slider .motion-word:not(.motion-word--from) { opacity: 1 !important; filter: none !important; transform: none !important; }
}
检查要点

交付前检查

  • 两张图片保持相同尺寸、构图和替代文本策略。
  • 检查最小与最大位置仍可看清手柄。
无障碍

保持信息可达

减弱动效

保留可操作分割线,取消位置补间;键盘和指针仍即时更新静态裁切。

参数

参数参考

参数范围 / 选项默认值作用
position10%–90%50%调节分割位置。
duration80ms–1200ms180ms控制一次动效完成所需的时间。