ZHPREFIX

__PURPOSE__

__CATEGORY__ 规格 __SPEC_SECTION__ 6 端实现触摸优先

引入（H5 原生；其余 5 端见「快速开始」）

__IMPORT_CODE__

演示

每个演示都是真实渲染：预览帧加载 frameworks-mobile/__PREFIX__.html?demo=<id>（只显示该演示块），代码是该演示块在演示页里的原文，可复制。全部演示同屏可看演示页 ↗。

__DEMO_BLOCKS__

API

__API_NOTE__

Props

__API_PROPS__

名称	类型	默认值	说明	必传

__API_REQUIRED_NOTE__

事件

__API_EVENTS__

名称	参数	说明

插槽

__API_SLOTS__

名称	说明

CSS 变量

组件级变量（在组件样式表里定义）。业务侧可在自己的作用域内覆盖，不必改组件源码。

__CSS_VARS__

名称	默认值	说明

何时使用

__USAGE__

交互与触控

__INTERACTION__

__A11Y__

从「该用哪一个」的角度区分；PC 端的对应实现见 PC 文档站。

__RELATED_ROWS__

组件	何时用它而不是本组件

规格未定 / 禁止发明

__GAPS__

类别	条目

结构（anatomy）

__ANATOMY__

字段	说明

变体维度与类名映射

类名映射由构建脚本从契约 variantClasses 生成，并被 verify:mobile-docs 逐条对照组件 CSS 校验（类/变量必须真实存在）。

__VARIANT_ROWS__

维度	取值	对应类名 / 变量

代表变体

__REP_ROWS__

变体	标签

用到的令牌

构建时从本组件样式表扫描得出。蓝色为移动端自有令牌，绿色为继承的 PC 令牌（改一处两端生效）。

__TOKEN_CHIPS__

6 端源码

同一组件的六份实现（生产环境的类名与结构一致，差异只在技术栈写法与单位）。点开查看，右侧可复制。

__SOURCE_BLOCKS__

测试与回归

断言在真实的 375×640 设备帧里跑（引擎与 PC 侧共用 tests/_runtime.js，触控行为动词来自移动端 tests/mobile/_behaviors.js）。

__TEST_TEXT__ 报告 __REPORT_DATE__

复现命令

node site/dev-server.js &
REG_BASE=http://127.0.0.1:3311 node tools/run-mobile-regression.mjs   # 全量 5 个组件
npm run verify:mobile-docs                                           # 本页内容完整性 + API 与源码一致性

设计契约

__CONTRACT__（点击展开原始 JSON）

__CONTRACT_JSON__

__ZH____PREFIX__

演示

API