跳到主要内容

移动商城示例(apps/h5) ​

apps/h5 是一个移动端 H5 商城示例:首页 / 分类列表 / 商品详情 / 购物车 / 我的 / 登录,完整走一遍 ruanno-ui 在移动浏览器(含 App WebView)里的交互与适配实践。建议浏览器开移动视口(DevTools 设备模拟)体验。私有包,不发布到 npm。

bash
pnpm --filter @ruanno-ui/h5 dev

在线预览 ​

独立访问地址:/apps/h5/(建议用浏览器设备模拟器打开手机视口,体验下拉刷新 / 左滑删除等手势)

9:41
移动商城 · 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)