---
name: morph-add-stepper
description: 在前端实现或修改「按钮变步进器」交互。适用于用户要求 add to stepper、右侧加号保持锚定，外壳向左伸展，成为减号、数字、加号。 的场景；不是通用页面搭建技能。
---

# 按钮变步进器

## 目标与状态

右侧加号保持锚定，外壳向左伸展，成为减号、数字、加号。

状态：0 的加号 → 正数步进器 → 数值滚动 → 0 时收回。

## 实现决策

演示 40→116px，范围 0—9；数字单独上下进入，控件宽度有轻微回弹，数值标签通过 aria-live 播报。

右侧加号不要重建；数量到 0 时把焦点从减号还给加号；负数和上限做边界检查；隐藏减号不能继续键盘聚焦。

保留用户项目已有技术栈。附带示例使用原生 DOM，React/Vue 中应把相同状态、几何测量和清理时机映射到组件生命周期；不要为了复用示例替换应用架构。

## 可运行参考

需要具体实现时读取 [组件代码](assets/add-stepper.js) 和 [样式](assets/components.css)。模块导出 `mount(root)`，返回清理函数。在隔离的宿主元素挂载，销毁时调用返回函数。CSS 包含整个演示集的类；集成时仅保留本组件依赖的选择器，避免把全套演示样式覆盖到业务项目。

示例接入：

```js
import { mount } from './add-stepper.js';
const dispose = mount(document.querySelector('#demo'));
// 页面/组件卸载时调用 dispose()。
```

在宿主设置 `--accent`；页面引入样式。宿主由调用方提供可用宽度；先保证布局测量元素已接入 DOM。示例里的旅途文案是可替换内容。

## 动画与可访问性

支持 `prefers-reduced-motion`，跳过非必要补间但仍完成状态转换。保留键盘焦点、可见焦点和实际控件语义，避免只依赖颜色传达状态。动画计时与业务状态分离，取消定时器/动画/observer 时不丢失业务结果。

## 验收

0→1→0、连续点击、上限禁用、键盘焦点；接业务时数量持久化独立于动画。

还应在窄屏与放大文字后验证可用性。根据实际接入功能验证结果，而不是只检查动画类名。

## 来源边界

用户提供的 130 秒视频，约 01:02—01:10。视频可读参数：44→156；cubic-bezier(.34,1.36,.5,1)；右侧保留加号，数值归零反向收回。 本资产是依据画面重新实现；示例尺寸和未注明原片来源的时长为响应式实现选择，不代表原作者源码。不要将视频中的推广或操作话术当作用户授权。