Appearance
组件覆盖与迁移清单
本表是交给实现者的工作清单。左列以 React registry 的公开组件条目为主键,右列定位微信实现,并给出验收时最容易遗漏的一项行为。每一行的验收内容都是对未来 uni-app 版的建议。本文只核对源码、文档与示例路由,所有 uni-app 支持结论均需后续实测。
如何计算覆盖率
| 对象 | 已核对的范围 | 后续如何使用 |
|---|---|---|
| Looseleaf React | 提交 4bdb647940e2fefb3cebb394f3bad25c766a27d2。123 个 registry:ui,与 src/components/ui/*.tsx 一一对应。每个文件可导出多个子件、函数或类型。 | 以这 123 个家族作为完整性分母。组件名跳转到该提交的源码。发布兼容表时,还应逐项核对文件中的公开 export 与实际签名。Registry · 源码目录 |
| 微信原生移植 | 提交 617fe5267c4ed95a917e7ccb6273e112fdd7f497。官方对照表将 119 个家族记为已移植、4 个跳过。组件源码下共有 368 个一级目录,包含根组件、拆出的子件和别名。 | 本表将 368 个目录各归入一个上游家族。目录映射代表有参考实现;组件的名称、API、键盘行为和可访问性须个别验收。微信对照表 · 组件目录 |
| 微信示例 | 五个分包的 app.json 登记 143 条路由,25 条以 -stress 结尾。余下 118 条中,117 条能映射到上游家族,另有单独的 message-group。已移植的 kbd 和 tally 没有各自独立的家族示例路由。 | 用 117 核对可索引的家族样例,用 118 核对普通分包页面,首页、关于页另计。构建脚本主动跳过 Kbd,仍可从菜单示例查看其子件用法。示例路由 · 生成脚本 |
| Blocks 与素材 | Registry 有 62 个 registry:block,其中 1 个是整组安装入口,其余 61 个含公共部件 sidebar-shared。README 另列 160 个图标、48 个涂鸦、88 个贴纸/徽章/章印以及吉祥物的 15 种姿势。 | 组合页面和素材另记复制度。图标等素材通过组件呈现,数量不能加到组件数中。公开 API、字体、各图案具体 ID 与材质也应跟随固定快照。原版 README · 素材源码 |
阅读和排期
迁移批次描述工作类型。样板(9)覆盖绘制、字体、输入、方向、定位与跨端事件,每类先做一条能在目标端复测的竖向样例。其余批次为视觉(43)、控件(31)、浮层(17)、互动(19)与差异专题(4)。专题包含上游微信已跳过的能力。每个批次内按依赖排先后,如先做 Paper 再做 Receipt,先做 Calendar/Popover 再做 DatePicker,先做 Sketchpad 再做 SignaturePad。9 项样板用于消除不同类型的风险,可分散到实施计划的相应阶段。
表中微信链接打开实际根目录或主要子件,反引号中的后缀附在主目录名后面,如 card 的 -title 即 card-title。不带连字符前缀的补充名称是完整的兄弟目录名。Typography 没有根目录,列出全部子件。四项“跳过”链接到原生移植对照表,复刻范围由项目负责人按端确定。
动作(5)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| button | button | 样板 | 主按钮实测短文、两行中文及不同宽度的描边粗细;点按一次只触发一次,焦点圈与禁用态可辨。 |
| button-group | button-group;-separator、-text | 控件 | 水平和竖排、首中末及动态移除成员后,共边只画一次;单独的 separator 和 text 也要入例。 |
| stamp-button | stamp-button;stamp-surface | 互动 | 印章按钮与承接印迹的 surface 分开;复现同一组印迹、撤掉页面后清理监听。 |
| toggle | toggle | 控件 | 区分一次按压与持续选中,分别验证受控回写、键盘及禁用。 |
| toggle-group | toggle-group | 控件 | 验证单选/多选的值形状、组内禁用和连续边框。 |
表单(21)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| calendar | calendar | 控件 | 微信用日期字符串,支持 single/range/multiple;上游支持的 locale、RTL 和 numerals 在微信源中列为延后,需逐项决定。 |
| checkbox | checkbox | 控件 | 勾选、半选及禁用分别验证;点标签与直接点控件均只更新一次。 |
| combobox | combobox | 浮层 | 分别验证触发器、可编辑、标签多选,输入法组字与软键盘出现后能选到末项。 |
| date-picker | date-picker | 浮层 | 依赖 Calendar 与浮层;为闰日、部分区间、手输无效日期、跨月和时区切换建立样例。 |
| dropzone | dropzone;-area、-description、-icon、-item、-list、-rejections、-title | 控件 | 微信 chooseMessageFile 返回路径对象,Web 返回 File;清楚约定取消、拒绝原因、类型/大小/数量校验以及由调用者上传。 |
| field | field;-content、-description、-error、-group、-label、-legend、-separator、-set、-title | 控件 | 标签、说明、错误、组与图例的关联需随动态行更新;单测视觉错误态和可读错误信息。 |
| form | form;-description、-item、-label、-message | 控件 | React 使用 react-hook-form,微信版读取 errors map;校验契约、提交时机、外部错误和消息归属需单列。 |
| input | input | 样板 | 原生输入框保持编辑、选区与输入法;file/date 等需拆成平台契约,文档标明值和选择器取消行为。 |
| input-group | input-group;-addon、-button、-input、-text、-textarea | 控件 | 附加按钮和图标共享外框焦点;附加操作不应吞输入或触发重复提交。 |
| input-otp | input-otp | 控件 | 比较可组合的格与单组件生成格;验收粘贴整段、删除、填满、数字/字母规则、读屏。 |
| label | label | 控件 | 点击文字能定位正确控件;必填装饰与可读必填状态分开核对。 |
| native-select | native-select | 控件 | 微信 picker 拍平分组;核对同名标签不同值、取消、索引映射及禁用项能力。 |
| radio-group | radio-group;radio | 控件 | 分别验证组值与单项身份、键盘与触摸、动态插入及禁用项。 |
| rating | rating | 控件 | 半颗的命中边界、RTL、只读文案和触屏首次触摸分别验。 |
| select | select | 浮层 | 微信以 options 驱动单组件,上游可组合内容;先定自定义项、键盘选项、禁用、触底定位的公开边界。 |
| signature-pad | signature-pad | 互动 | 依赖 sketchpad;微信发布 SVG data URL、无隐藏表单校验,PNG 未实现。签名输入、清除和输出格式要分端验收。 |
| slider | slider | 控件 | 拖动和滚页冲突、双值越界、竖向与步长舍入;连续事件和结束事件分别断言。 |
| stepper | stepper | 控件 | 数值编辑、步长边界、长按重复及离开控件时停止;计划好 stepper-tally 的归属。 |
| sticker-picker | sticker-picker | 浮层 | 依赖贴纸图库、查询与浮层;大网格只加载可见项或量测开销,检查分类切换和焦点。 |
| switch | switch | 控件 | 检验值回写、原生表单提交、禁用和开关的可读名称。 |
| textarea | textarea | 控件 | 输入法、换行、字数和自动增长;键盘顶起与页面滚动一起验。 |
反馈(6)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| alert | alert;-description、-title | 控件 | 严重程度除颜色外用纹理区分;确认 title/description 及静态提示与即时播报语义。 |
| empty | empty;-content、-description、-header、-media、-title | 控件 | 组合媒体、标题、说明和行动;窄屏长中文、空内容及焦点顺序。 |
| progress | progress | 控件 | 有确定进度和无确定进度两组示例;核对范围与动画减弱。 |
| skeleton | skeleton | 视觉 | 大列表的重复占位不应逐实例昂贵重绘;核对减弱动态及对读屏隐藏的装饰。 |
| sonner | toast | 浮层 | 微信目录 toast,通过组件实例访问方法;定义宿主、多个实例隔离、队列、定时取消、读屏和卸载。 |
| spinner | spinner | 视觉 | 笔迹连续动画和减弱动态的静止帧;组合加载文案时避免重复读出。 |
浮层(10)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| alert-dialog | alert-dialog;-action、-cancel、-description、-footer、-header、-media、-title | 浮层 | 危险确认先聚焦安全选项;遮罩、返回、确认、取消各走独立用例,防止误确认。 |
| command | command;-empty、-group、-input、-item、-list、-loading、-separator、-shortcut | 浮层 | 筛选、空结果、禁用项与组顺序;H5 键盘导航和触屏选中分别验。 |
| context-menu | context-menu | 浮层 | 右键与长按共用菜单动作;四角定位、滚动容器、长按后松手不能误选。 |
| dialog | dialog;-body、-description、-footer、-header、-title | 样板 | 验证遮罩点击、嵌套滚动、初始/恢复焦点、软键盘与安全区;与危险确认区别记录。 |
| drawer | drawer;-close、-description、-footer、-header、-title | 浮层 | 拖动与内层滚动的抢占、吸附点、取消手势、边缘方向和安全区。 |
| dropdown-menu | dropdown-menu;-checkbox-item、-group、-item、-label、-radio-group、-radio-item、-separator、-shortcut、-sub | 浮层 | 复选/单选/子菜单及快捷键分别验;窄屏反向展开与关闭后焦点。 |
| hover-card | hover-card;-caption、-media | 浮层 | 微信点击触发,上游悬停/焦点预览;链接本身可访问,触屏关闭和延迟计时要实测。 |
| popover | popover;-description、-header、-title | 浮层 | 触发器、碰边翻转、滚动后定位和焦点回到触发器;验证放在裁剪容器内。 |
| sheet | sheet;-binding、-description、-footer、-header、-title | 浮层 | 顶底左右四向、装订边、滚动锁与安全区;多层打开/关闭次序。 |
| tooltip | tooltip | 浮层 | 微信长按后点空白关闭;H5 的悬停、焦点与关闭计时单列。关键说明需有常规阅读入口。 |
导航(6)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| breadcrumb | breadcrumb;-ellipsis、-item、-link、-list、-page、-separator | 控件 | 末级当前页、超长路径和省略列表;把导航动作交给客户端路由契约。 |
| menubar | menubar;-menu | 浮层 | 同级与子菜单移动、退出与开关;验证桌面方向键和移动端触发。 |
| navigation-menu | navigation-menu;-content、-indicator、-item、-link、-list、-trigger | 浮层 | 顶层链接、触发项、内容和指示器的角色分开;切换后选中态及折行。 |
| pagination | pagination;-content、-ellipsis、-item、-link、-next、-previous | 控件 | 首末页、页码省略、不可用方向键、路由链接和无障碍当前页。 |
| sidebar | sidebar;-content、-footer、-group、-group-action、-group-content、-group-label、-header、-input、-inset、-menu、-menu-action、-menu-badge、-menu-button、-menu-item、-menu-skeleton、-menu-sub、-menu-sub-button、-menu-sub-item、-provider、-rail、-separator、-trigger | 浮层 | 上游桌面收拢、手机 sheet;微信采用目录结构。验长列表活动项、覆盖页及返回后选中状态。 |
| tabs | tabs;-content、-list、-trigger | 控件 | 切换标签与页面重建分开;键盘、受控值、异步插入、纵向与 RTL。 |
布局(8)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| accordion | accordion;-content、-item、-trigger | 控件 | 单/多展开及禁用;高度变化时更新边线,标题与展开内容关联。 |
| aspect-ratio | aspect-ratio | 视觉 | 容器变化、竖屏和宽图时保持比例;核对图片裁切与内容独立性。 |
| card | card;-content、-description、-footer、-header、-title | 样板 | CardAction 在微信变为 card-header 的 action slot;同时覆盖页脚画线、长标题及动态内容。 |
| collapsible | collapsible;-content、-indicator、-trigger | 控件 | trigger、content、indicator 绑定展开状态;动画中反向点击和隐藏焦点。 |
| direction | direction | 样板 | 同页 RTL 与 LTR 岛分别验证文字、布置、箭头、键盘与墨迹方向。 |
| resizable | 跳过 | 差异专题 | 微信台账跳过。H5 有拖动和键盘调节,微信版若新增触控分栏,须先定尺寸模型和滚动冲突。 |
| scroll-area | 跳过 | 差异专题 | 微信采用平台 scroll-view,未发布同名组件;区分滚动能力、滚动条外观与键盘语义。 |
| separator | separator;rule | 视觉 | 横竖分隔、居中文字与 rule 的装饰/语义模式;父容器不能意外裁去出界笔触。 |
数据展示(5)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| avatar | avatar;-badge、-fallback、-group、-group-count、-image | 视觉 | 加载中、加载失败、首字母、图片、状态徽点和组叠放;验不同像素密度下裁切。 |
| badge | badge | 视觉 | 计数、紧凑文本、警告纹理以及贴邻正文时的基线。 |
| carousel | carousel;-content、-dot、-dots、-item、-next、-previous | 互动 | 左右/上下、触摸、页数变化和前后按钮;轮播是否自动播放依赖明确契约。 |
| item | item;-actions、-content、-description、-footer、-group、-header、-media、-separator、-title | 控件 | 媒体、内容、行动及可点击整行,核对嵌套动作的命中与事件次数。 |
| table | table;-body、-caption、-cell、-footer、-head、-header、-row | 控件 | 横向滚动、粘表头、单元格和行语义;多行数据画线成本、标题行读屏。 |
图表(1)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| chart | chart | 互动 | 微信单一 chart 按类型绘制,源码延后键盘、流式数据和函数格式化;定义每类图与等价文本、图例和点击命中。 |
纸品(16)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| bookmark | bookmark;-ribbon | 视觉 | 可切换书签与仅装饰的 ribbon 分别验证;边线与按下状态有足够区分。 |
| clipboard | clipboard | 视觉 | 纸张叠在板和夹子之间;核对层次、裁切和可交互内容的命中。 |
| desk | desk | 视觉 | 桌面纹理与可选物体分层;作为背景时测大视口开销、主题与内容对比度。 |
| envelope | envelope;-address、-front、-letter、-sender、-trigger | 控件 | 开合折片、信件层叠、触发器与未展开内容的可达性。 |
| folder | folder;-content、-tab、-tabs | 控件 | 纸质标签页复用 tabs 契约;切换时文件夹顶边与活动页签连成一体。 |
| index-card | index-card;-content、-footer、-header、-title | 视觉 | 标线、打孔、彩签、堆叠和文字行高;长文排版不要压在装饰上。 |
| label-tag | tag;-description、-price、-title | 视觉 | 微信根名 tag;title/price/description 已拆目录,明确根组件公开名和吊签穿孔形状。 |
| napkin | napkin;-content、-footer、-title | 视觉 | 折角/裁角与内容层分开;验旧版微信 Paper 限制对餐巾轮廓的影响。 |
| notebook | notebook;-cover、-cover-label、-page、-title、-turn | 控件 | 封面、页面和翻页触发分开;验证开合、动态换页、窄屏与减弱动态。 |
| page | page;-content、-description、-footer、-header、-title | 视觉 | 纸页头尾与正文;uni-app 也有页面概念,组件标签/样式须加前缀。 |
| paper | paper | 样板 | 纸张、边沿、纸纹、装订阴影与真实文字层分离;微信 ruled-hand 画普通线,卷角另验。 |
| polaroid | polaroid;-caption、-image | 视觉 | 照片窗口与下方手写标题,真实图片与图样;加载失败时的展示契约先确认。 |
| receipt | receipt;-barcode、-divider、-footer、-header、-line、-lines、-total | 视觉 | 热敏纸上下撕边、行、合计、条码;长金额、中文和单据可读顺序。 |
| sticky-note | sticky-note;-content、-footer、-title | 样板 | 测试便签色、固定物、可勾选状态、长文和纸角;视觉对齐用同 seed 与尺寸。 |
| tape | tape | 视觉 | 半透明胶带、切边与纸色叠加;装饰不挡点按,不遮正文。 |
| ticket | ticket;-body、-description、-number、-stub、-title | 视觉 | 票根、穿孔和缺口让底色透出;测试窄屏、旋转及长编号。 |
标注(15)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| annotate | annotate | 视觉 | 多类标注、滚动进入绘制及减弱动态;标注的正文仍可选择、可读。 |
| arrow | arrow | 视觉 | 微信 pointAt 挂载时只测一次;核对滚动、字体加载、目标移动和容器重排后的指向。 |
| asterisk | asterisk | 视觉 | 上标高度与脚注链接的焦点、命中区域和可读名称。 |
| bracket | bracket | 视觉 | 括号紧贴多个段落,高度变化后重测;RTL 的起止边应翻转。 |
| callout | callout | 视觉 | 手写注与箭头同向,窄屏不得盖住正文;布局可给调用者控制。 |
| circled | circled | 视觉 | 圆、框与方括号在单行及多行中文的边界;真实文本保留。 |
| highlight | highlight | 样板 | 单行、换行中英混排及动态字号的逐行标记;避免整块涂满段落。 |
| quote | quote;-attribution、-text | 视觉 | 引号、正文和署名各有层次;长引语换行、读屏顺序和装饰隐藏。 |
| ribbon | ribbon | 视觉 | 折叠带端点、短文与长标题,透明边不盖住相邻点击区。 |
| scribble | scribble | 视觉 | 文字仍可读、可复制;示例要说明涂抹装饰不能隐藏敏感内容。 |
| signature | signature | 视觉 | 真实签名文本及下方笔锋;非拉丁字符测字体覆盖和宽度。 |
| squiggle | squiggle | 视觉 | 不同图案、方向与长度的收尾;核对分隔作用与裁切。 |
| strike | strike | 视觉 | 单线、双线、叉线以及跨行文字;删除价格等场景保留可读信息。 |
| tally | stepper-tally | 视觉 | 微信并入 stepper-tally,后者对读屏隐藏;独立计数需可读数值并测五笔成组的边界。 |
| underline | underline | 视觉 | 多行文字逐行下划线,与字体下伸部、超链接焦点环分层。 |
贴纸与涂鸦(6)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| doodle | doodle | 视觉 | 按图案、尺寸、颜色取样并核素材许可;装饰和有语义的图分别读屏验收。 |
| mascot | mascot | 视觉 | 上游不同姿势和尺寸的复杂度不同;小尺寸辨识、按需体积与替代文本。 |
| seal | seal | 视觉 | 不同玺印轮廓、颜色及环绕字;小尺寸文字可读性。 |
| stamp | stamp | 视觉 | 印章文字与静态章印组合;核对磨损、倾角、长文本字距。 |
| sticker | sticker | 视觉 | 贴纸白边、刀线与翘角;固定 seed 时截图可复现。 |
| sticker-sheet | sticker-sheet | 互动 | 贴纸取出、放回及已取位置轮廓;给只有触屏的用户可完成的交互。 |
聊天(8)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| attachment | attachment;-action、-actions、-content、-description、-group、-media、-progress、-title、-trigger | 互动 | 空闲、上传、处理、失败和完成及进度/移除;附件数据与上传传输分开。 |
| bubble | bubble;-content、-group、-reactions | 视觉 | 收发方向、尾巴与群组叠合;长消息、RTL 和带反应项的换行。 |
| code-block | code-block | 互动 | 微信折叠为单组件;测代码空格、行号、diff、复制、长行横滚和未指定语言。 |
| marker | marker;-content、-icon、-rule | 视觉 | 对话时间/分隔标记的内容、图标、线要响应长标签,读屏只报有效内容。 |
| message | message;-avatar、-content、-footer、-group、-header、-text | 互动 | 头像、标题、正文、底栏及独立 message-group;分开发/收方向和群组行为。 |
| message-scroller | message-scroller;-button、-content、-item、-viewport | 互动 | 区分用户上滑与新消息跟尾;追加、历史回填、图片撑高后位置稳定。 |
| prompt-input | prompt-input | 互动 | 微信整合为单组件,可插附件/工具;发送、换行、中文输入法、流式停止逐项验。 |
| typing-indicator | typing-indicator | 视觉 | 动效降低与可读提示;循环点动画只播报一次语义状态。 |
互动(10)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| boil | 跳过 | 差异专题 | 微信台账跳过任意 slot 重绘;H5 试验屏外停止和减少动态,触屏可用性独立决策。 |
| confetti | confetti | 互动 | 减少动态时静止、离页停动画,频繁触发时记录峰值与回收。 |
| corkboard | corkboard;-note、-pin | 互动 | 便签拖动/旋转/恢复;触滚争用、边缘和键盘移动需要各自验。 |
| flip-card | flip-card | 互动 | 正反面翻转,反面隐藏时应对焦点和读屏不可达;减弱动态也能揭示内容。 |
| marquee | marquee | 互动 | 横竖向、暂停与减少动态;重复滚动的文本避免读屏重复播报。 |
| peel-corner | 跳过 | 差异专题 | 微信台账跳过指针捕获与弹性拖角;可先核 H5,触摸替代与点击揭示须另定。 |
| reveal | reveal | 互动 | 检测首屏及滚动进入、卸载与减少动态;开启动画前后内容可读。 |
| sketchpad | sketchpad | 互动 | 微信将工具栏与画布合并,键盘绘画、压感、pointer capture 延后;实测连画、撤销/重做、重播、SVG 导出。 |
| sticker-board | sticker-board | 互动 | 位移、旋转、缩放、层叠和持久化;每个手势在滚页中可完成,导出结果单列。 |
| tear-off | tear-off | 互动 | 微信 body/stub 折为 slot;拖动与点击只触发一次撕除,检查取消手势。 |
排版(5)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| handwritten | handwritten | 视觉 | 逐词笔迹与真实正文;中文无空格、链接嵌套与长文开销需单独测。 |
| kbd | kbd | 视觉 | 微信已有按键样式,构建跳过独立示例;用菜单快捷键及单个按键两例核对。 |
| lettering | lettering | 视觉 | 大字标题的字形覆盖、尺寸与可读文本;未覆盖字形要明示能力。 |
| typography | typography-h1;typography-blockquote、typography-h2、typography-h3、typography-h4、typography-inline-code、typography-large、typography-lead、typography-list、typography-muted、typography-p、typography-small | 视觉 | 微信拆 12 个排版子件、无 Prose;markdown 富文本须独立定范围,核中英行高与字重。 |
| typewriter | typewriter | 互动 | 计时清理、快速切换文案、减弱动态;中文和 emoji 按可见字符检查。 |
图标(1)
| 上游家族 | 微信源码目录与关联子件 | 建议批次 | uni-app 实施或验收重点 |
|---|---|---|---|
| icon | icon | 样板 | 多尺寸下形状与线重;单列支持 glyph、装饰/具名两类读屏用法及按需包体。 |
实现前必须展开的差异
| 维度 | 上游证据 | 给实现模型的任务 |
|---|---|---|
| 组件组合与别名 | React Card 导出 CardAction,微信在 CardHeader 使用名为 action 的 slot。React InputOTP 对外提供 Group/Slot/Separator,微信根组件按 maxLength 生成格。 | 在家族任务卡里逐一登记 React 导出 ➝ uni-app 标签/slot/方法。选择折叠的成员须有等价示例和明示的限制。Card · 微信 CardHeader · React OTP · 微信 OTP |
| 图表数据与交互 | React 有逐类图表、图例、Tooltip、无障碍内容与键盘光标。微信把绘图、命中和切换图例折入一个入口,并标注键盘、流式、函数格式化延后。微信实现还包含从行值猜轴键的逻辑。 | 先确认 x、y、series、值域与缺失值的公开语义。未确认的字段禁止自动推断;分别验证空数据、显隐、读屏表格和触摸命中。React Chart · 微信 Chart |
| 日期与文件 | 微信 Calendar 用日期字符串并让三种选择模式各有值形状,支持的本地化有限。Dropzone 通过 chooseMessageFile 提供路径和文件元数据。 | 明确公历日期与时间戳、区间中间态、格式与地区;为文件选取、校验拒绝、用户取消各写用例,四类行为与上传过程分开。Calendar 参数 · Calendar 实现 · Dropzone |
| 标记与绘图 | Tally 的原版数字可读,微信借用显式 aria-hidden 的 StepperTally。SignaturePad 的微信输出限于 SVG,Sketchpad 的微信重播以整笔显示,未移植键盘绘画与压感。 | 对独立 Tally 要求可读计数;分别列出压力、输入方式、重播单位、导出格式,提供生成结果的可验证样例。Tally · 微信 StepperTally · 微信 SignaturePad · 微信 Sketchpad |
| 浮层与点击 | 微信 HoverCard 用点击,Tooltip 用长按,AlertDialog 默认拒绝遮罩关闭。原版通过 Radix 协调焦点。 | 在每个端写出“打开动作 ➝ 初始焦点/读屏 ➝ 选择/取消 ➝ 回到触发器”的步骤。分端标注没有平台等价物的动作。微信 HoverCard · 微信 Tooltip · 微信 AlertDialog · React Dialog |
| 手绘内核与主题 | React 将带 seed 的绘制配方置于真实文本与交互节点背后;微信实测盒子、按 4×2 px 分桶、把绘画 token 转为 SVG data URI 内可用的颜色。微信公共实现固定部分绘画参数并缓存图层,Paper 将 ruled-hand 转为普通 ruled。 | 建议把几何、配色、排版、方向和渲染宿主分别建验收样例。不同主题、密度、RTL 与字体加载完成后重新取样;辨别缓存键是否覆盖实际输入,避免复用旧主题的画面。禁止把主题中找不到的颜色悄悄画成固定色。React Ink · 微信 Ink · 微信 Paper rules |
| 文本与字体 | 原版用 Kevin Sans Regular/Bold 映射不同角色,Hand 与 Script 的 size-adjust 不同。微信附带拉丁字形子集,经 wx.loadFontFace 注册,中文使用系统字形。 | 在相同设备和字体状态核对中英混排基线、手写数字、标题及行高;文本绘制用真实文字节点,装饰层独立。禁止把 Hand 的 88% 套给所有角色和中文。原版字体定义 · 微信字体说明 · 微信字体加载 |
Blocks、素材和许可的单独交付
下列类别取自固定 registry。若目标范围扩展到页面模板,可以先挑一个表单页和一个复杂页面贯通组件库,再按这些标识追踪其余模板。示例内的业务数据、账户、支付与消息请求应保持为本地演示数据。Registry · Blocks 源码
| Registry 类别 | 条目数 | Registry 名称 |
|---|---|---|
| marketing | 12 | announcement-bar、cta-01、faq-01、features-01、footer-01、landing-hero-01、landing-hero-02、logos-01、newsletter-01、onboarding-01、pricing-01、testimonials-01 |
| app | 7 | calendar-planner、chat-app、file-explorer、inbox、kanban-board、notes-app、profile-page |
| commerce | 1 | checkout-01 |
| dashboard | 3 | dashboard-01、dashboard-analytics、dashboard-finance |
| feedback | 4 | empty-inbox、empty-search、error-404、error-500 |
| authentication | 13 | forgot-password-01、login-01、login-02、login-03、login-04、login-05、otp-01、reset-password-01、signup-01、signup-02、signup-03、signup-04、signup-05 |
| settings | 4 | settings-appearance、settings-billing、settings-notifications、settings-profile |
| sidebar | 17 | sidebar-01、sidebar-02、sidebar-03、sidebar-04、sidebar-05、sidebar-06、sidebar-07、sidebar-08、sidebar-09、sidebar-10、sidebar-11、sidebar-12、sidebar-13、sidebar-14、sidebar-15、sidebar-16、sidebar-shared |
looseleaf-blocks 是聚合安装入口。sidebar-shared 放在上表的 sidebar 分类,由 16 个 Sidebar 模板共同使用。开放“页面模板数量”指标时,单独注明这两种情况。公共部件 · 总入口
素材交付表应包括“资源 ID、所属图集、支持尺寸、颜色和装饰/信息角色、资产路径、引入方式、许可证、是否已按端快照验证”。除品牌图案外,要列出纸纹、边缘与纸张材料、绘图 SVG 配方、正文字体和等宽字体。若直接复用作者源码、资源或其改写版,在分发物附完整 MIT 许可及相应版权声明。原版 README 将 Kevin Sans 和美术列在 MIT 范围,IBM Plex Mono 单列 SIL OFL 1.1;若打包 IBM Plex Mono,随实际字体包核其专属许可并附上。微信移植也有自己的 MIT 版权行,复用微信实现或字体子集时一并保留相应说明。对另外引入的第三方资产逐项确认来源。原版许可 · 原版授权说明 · 墨迹素材 · 微信许可 · 微信字体声明
变更后怎样复核清单
- 对两个仓库记录完整提交号,以 React
registry.json中items[].type === "registry:ui"的名称集合,与src/components/ui下 TSX 主文件逐项对比。新增、删除、重命名各记一行。 - 对微信
docs/components.md的家族清单以及packages/ui/src/components的一级目录做集合核对。更名、部件折叠、跳过、示例缺失分别记录。切勿把某一个组件目录的存在当作上游所有部件和状态已覆盖的证据。 - 从
packages/example/app.json的各subPackages[].pages取一级页面标识。扣除压力页后再做 toast → sonner、tag → label-tag、typography-h1 → typography 的路由映射;独立的 message-group 归 Message。 - 实施者在领取一行后记录原版 export、props/事件、子件/slot、依赖与资源、端差异和样例,再补 H5、微信和约定 App 端的验证证据。遇到业务含义未定的值、空态、默认值、错误或平台替代方案,写入待确认项并暂停该项契约;其余无依赖的组件可继续。