移动商城示例(apps/h5)
apps/h5 是一个移动端 H5 商城示例:首页 / 分类列表 / 商品详情 / 购物车 / 我的 / 登录,完整走一遍 ruanno-ui 在移动浏览器(含 App WebView)里的交互与适配实践。建议浏览器开移动视口(DevTools 设备模拟)体验。私有包,不发布到 npm。
bash
pnpm --filter @ruanno-ui/h5 dev在线预览
独立访问地址:/apps/h5/(建议用浏览器设备模拟器打开手机视口,体验下拉刷新 / 左滑删除等手势)
页面与交互
| 页面 | 交互亮点 | 代表组件 |
|---|---|---|
| 首页 | 下拉刷新、分类横滑、商品瀑布 | PullRefresh、Carousel、Search、TabBar |
| 列表 | v-infinite-scroll 无限加载、排序切换、加购反馈 | vInfiniteScroll、Skeleton、Toast、SwipeCell |
| 详情 | 轮播图、规格选择、图片预览 | Carousel、ImagePreview、ActionSheet、Button |
| 购物车 | 左滑删除、数量步进、全选结算 | SwipeCell、InputNumber、Checkbox |
| 我的 | 订单状态宫格、设置入口 | Cell、Grid、Avatar、Badge |
| 登录 | 表单校验、移动端键盘类型 | Form、Input、Button |





工程要点
- 技术栈:Vue 3 + vue-router + Pinia + axios Mock(与 admin 同构,方便对照桌面 / 移动两种组织方式);
- 按需引入:同样使用
@ruanno-ui/resolver+ unplugin 全家桶; - 安全区适配:布局消费
--rn-safe-area-top / bottom,TabBar 固定底部并让出 home indicator 高度; - 触摸交互:下拉刷新、左滑操作、无限滚动全部使用组件库内置的移动端组件 / 指令,业务代码只写数据逻辑;
- 国际化:内置 zh-CN / en,右上角可切换。
桌面 vs 移动:选哪个模板
| 场景 | 模板 |
|---|---|
| 中后台、运营平台、数据看板 | apps/admin |
| 移动站点、WebView 内嵌页、活动页 | apps/h5(本页) |
| 小程序 / App 原生渲染 | uni-app 快速开始(apps/uniapp-demo) |