07.2.4.5 组件与 API 多端差异
所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.2 跨平台移动开发 / 07.2.4 uni-app
本节要解决的问题
- uni-app 内置组件(view/scroll-view/swiper/picker/map/video/canvas)在各端支持情况如何?
- 同一组件在不同端的属性、事件、样式有哪些关键差异?
- 平台专有组件怎么用条件编译接入?
- 同一
uni.xxxAPI 在各端的返回值、错误码、能力边界有什么不同? - 权限与授权(App 权限、小程序授权、隐私协议)在各端怎么处理?
- 网络、文件、存储 API 的多端差异在哪,怎么封装?
- 原生插件(uts、nvue 原生模块、原生组件)的接入代价是什么?
- uni-ui 与自定义组件怎么跨端复用,事件冒泡与样式隔离有什么差异?
版本前提:本页组件与 API 的平台支持情况以官方文档(uniapp.dcloud.net.cn/component/ 与 /api/)为基线;具体属性名、事件名、错误码随版本变化,标注待确认处需按项目实际版本核对。
覆盖范围
| 知识域 | 关键内容 |
|---|---|
| 内置组件 | view/scroll-view/swiper/picker/map/video/canvas 的各端支持与差异 |
| 平台专有组件 | 条件编译接入、降级方案 |
| API 差异 | 返回值、错误码、能力边界、兜底 |
| 权限与授权 | App 权限、小程序授权、隐私协议 |
| 核心 API | 网络、文件、存储的多端差异与封装 |
| 原生插件 | uts 插件、nvue 原生模块、原生组件的接入代价 |
| 组件复用 | uni-ui、自定义组件、事件冒泡、样式隔离 |
题号索引
| 题号区间 | 主题 |
|---|---|
| 001-004 | 内置组件矩阵:基础组件、滚动/轮播、交互组件、原生组件 |
| 005 | 平台专有组件与条件编译 |
| 006-007 | API 兼容性、返回值与错误码差异、能力兜底 |
| 008 | 权限与授权(App 权限、小程序授权、隐私协议) |
| 009-011 | 网络、文件、存储 API 的多端差异 |
| 012-013 | 原生插件(uts、nvue、原生组件)接入与代价 |
| 014-015 | uni-ui 与自定义组件复用、事件冒泡与样式隔离 |
| 016 | 综合:某 API 某端不支持的兜底方案 |
07.2.4.5-001 内置组件矩阵在各端的支持情况如何?
一句话结论
uni-app 内置组件分三类:基础组件(view/text/image/scroll-view/swiper)在各端基本支持;交互组件(picker/action-sheet/modal)各端支持但样式有差异;原生组件(map/video/canvas)在 App/小程序支持,H5 支持程度不同。
概念解释
基础组件(view、text、image、scroll-view、swiper、switch、input)是跨端通用的,在 H5/App/各小程序都能用,但属性与样式在各端有差异。交互组件(picker、action-sheet、modal、toast)在各端都有,但原生组件的样式由平台决定,无法完全自定义。
原生组件(map、video、canvas、live-player)在 App 与小程序端是原生渲染(性能好但样式受限),在 H5 端是 HTML5 对应实现(性能与能力不同)。关键认知:内置组件不是"一套代码完全一致",而是"同一套标签,各端实现不同"。
原理流程
内置组件
├─ 基础组件:view/text/image/scroll-view/swiper → 各端通用
├─ 交互组件:picker/modal/toast → 各端支持,样式不同
└─ 原生组件:map/video/canvas → App/小程序原生,H5 HTML5
代码或图示
| 组件类型 | 代表 | 各端支持 | 差异点 |
|---|---|---|---|
| 基础组件 | view/text/image | 全端 | 样式细节 |
| 滚动/轮播 | scroll-view/swiper | 全端 | 滚动条、样式 |
| 交互组件 | picker/modal/toast | 全端 | 原生样式 |
| 原生组件 | map/video/canvas | App/小程序为主 | H5 能力受限 |
常见误区
- 误区:内置组件在所有端表现一致;正解:同一组件在各端实现不同,样式与属性有差异。
- 误区:H5 端 map/video 与 App 端一样;正解:H5 端是 HTML5 实现,能力与性能不同。
追问
- Q:如何查某组件的平台支持?A:官方文档每个组件页都有平台支持表,标注待确认的以文档为准。
- Q:原生组件为什么样式受限?A:原生组件由平台渲染,WebView/CSS 无法完全控制其样式。
07.2.4.5-002 view、text、image 等基础组件有什么差异?
一句话结论
view 是容器组件(对应 div),text 是文本组件(对应 span),image 是图片组件;三者在各端基本通用,但 image 的裁剪模式、加载失败占位、text 的多行省略在各端有差异。
概念解释
view 是最基础的容器,对应 HTML 的 div,没有默认样式。text 是文本组件,在 nvue 下必须用 text 包裹文本,在 vue 下可以直接在 view 里写文字。image 是图片组件,支持 mode 属性(scaleToFill/aspectFit/aspectFill 等),在各端裁剪行为略有差异。
常见差异:image 的 lazy-load 属性只在 App/小程序端支持,H5 端不支持;text 的 number-of-lines 多行省略在各端行为不同;image 的默认宽高(320x240)在各端一致,但需要显式设置。
原理流程
<view>:容器,对应 div
<text>:文本,对应 span
<image mode="aspectFill">:图片裁剪
代码或图示
| 组件 | 对应 HTML | 关键属性 |
|---|---|---|
| view | div | 容器 |
| text | span | 文本 |
| image | img | mode、lazy-load |
常见误区
- 误区:image 不需要设宽高;正解:image 有默认宽高(320x240),需要显式设置。
- 误区:lazy-load 所有端都支持;正解:H5 端不支持 lazy-load,需用其他方案。
追问
- Q:image 的 mode 有哪些?A:scaleToFill、aspectFit、aspectFill、top、bottom、center 等,具体以官方文档为准。
- Q:nvue 下能直接在 view 里写文字吗?A:不能,必须用 text 包裹。
07.2.4.5-003 scroll-view 与 swiper 有什么差异?
一句话结论
scroll-view 是可滚动容器(纵向/横向),swiper 是轮播容器;两者在各端都支持,但滚动条样式、滚动事件、性能表现有差异;长列表应优先用 scroll-view 的优化方案,不要用普通 view 模拟滚动。
概念解释
scroll-view 提供纵向或横向滚动,支持 scroll-top、scroll-left、scroll-into-view 等属性,绑定 scroll 事件。swiper 是轮播容器,支持自动播放、循环、指示点,常用于 banner 轮播。
差异:scroll-view 的滚动条在各端样式不同(H5 可自定义 CSS,App/小程序原生样式);scroll-view 在小程序端有性能优化(长列表优化),App vue 页需自行处理;swiper 的指示点样式在各端不同。
还有一个常见坑是 scroll-view 的高度:scroll-view 需要显式设置高度才能滚动,否则内容撑开后整个页面滚动,不是 scroll-view 内部滚动。纵向滚动用 scroll-y,横向滚动用 scroll-x,不要同时开。
原理流程
<scroll-view scroll-y>:纵向滚动容器
<swiper :autoplay="true">:轮播容器
代码或图示
| 组件 | 用途 | 关键属性 |
|---|---|---|
| scroll-view | 滚动容器 | scroll-y、scroll-top、scroll-into-view |
| swiper | 轮播 | autoplay、circular、indicator-dots |
常见误区
- 误区:用普通 view + CSS overflow 实现滚动;正解:用 scroll-view,它是原生组件,性能更好。
- 误区:scroll-view 能滚动整个页面;正解:页面滚动用页面原生滚动,scroll-view 是局部滚动容器。
追问
- Q:scroll-view 长列表怎么优化?A:用 uni-app 提供的长列表优化方案,具体以官方文档为准。
- Q:swiper 的指示点能自定义吗?A:用 indicator-dots 与 indicator-color 等属性,自定义样式有限。
07.2.4.5-004 picker、map、video、canvas 等原生组件有什么差异?
一句话结论
picker 是选择器(原生样式,不可完全自定义);map/video/canvas 是原生组件,在 App/小程序端是原生渲染(性能好但样式受限),H5 端是 HTML5 实现(能力不同)。
概念解释
picker 是底部选择器,在各端是原生组件,样式由平台决定,只能改部分文字颜色。map 是地图组件,在 App/小程序端是原生地图(需要配置地图 SDK key),在 H5 端是 HTML5 地图(需要第三方地图 JS)。video 是视频播放组件,在各端是原生播放器,H5 端是 HTML5 video。canvas 是画布,在各端是原生画布,API 与 HTML5 canvas 有差异。
关键认知:原生组件在 z-index 层级上高于普通组件(原生组件层级问题),在 App/小程序端会出现"原生组件盖住其他组件"的情况,需要用 cover-view 等方案解决。
原理流程
原生组件(map/video/canvas)
↓
App/小程序:原生渲染,层级高
↓
H5:HTML5 实现,能力不同
代码或图示
| 组件 | App/小程序 | H5 | 关键差异 |
|---|---|---|---|
| picker | 原生选择器 | 原生选择器 | 样式不可自定义 |
| map | 原生地图 | HTML5 地图 | SDK key 配置 |
| video | 原生播放器 | HTML5 video | 控件样式 |
| canvas | 原生画布 | HTML5 canvas | API 差异 |
常见误区
- 误区:原生组件能用 CSS 完全控制样式;正解:原生组件样式受限,层级高于普通组件。
- 误区:map 在 H5 端直接可用;正解:H5 端需要第三方地图 JS 与 key 配置。
追问
- Q:原生组件层级问题怎么解决?A:用 cover-view/cover-image 覆盖在原生组件上,具体以官方文档为准。
- Q:canvas 在各端 API 一样吗?A:基本一致,但部分 API 行为有差异,需真机核对。
07.2.4.5-005 平台专有组件怎么用条件编译接入?
一句话结论
平台专有组件(如微信小程序的开放组件、App 端的原生组件)用条件编译包裹:只在目标端渲染,其他端不渲染或用替代组件。
概念解释
典型场景:微信小程序需要用微信开放组件(如 open-data 获取用户信息),H5/App 端不支持;用 <!-- #ifdef MP-WEIXIN --> 包裹,其他端用替代组件。
另一个场景:某端需要自定义原生组件(如 App 端的自定义导航),用条件编译只在 App 端渲染,其他端用默认导航。
原则:平台专有组件不要"假装跨端",而是明确用条件编译区分,其他端提供合理替代。
原理流程
<template>
<!-- #ifdef MP-WEIXIN -->
<open-data type="userAvatarUrl" />
<!-- #endif -->
<!-- #ifndef MP-WEIXIN -->
<image :src="defaultAvatar" />
<!-- #endif -->
</template>
代码或图示
| 场景 | 条件编译 | 替代方案 |
|---|---|---|
| 微信开放组件 | #ifdef MP-WEIXIN | 其他端用默认 |
| App 原生组件 | #ifdef APP-PLUS | 其他端用 vue 组件 |
| 平台特有能力 | #ifdef 平台 | 降级或隐藏 |
常见误区
- 误区:平台专有组件不处理直接用;正解:其他端会报错或不渲染,必须用条件编译。
- 误区:其他端不渲染就行;正解:其他端要提供合理替代或隐藏入口。
追问
- Q:如何判断某组件是否平台专有?A:查官方文档平台支持表,只在某端支持的就是专有组件。
- Q:专有组件的替代方案怎么选?A:用跨端通用组件替代,或隐藏对应功能入口。
07.2.4.5-006 同一 API 在各端的返回值与错误码有什么差异?
一句话结论
同一 uni.xxx API 在各端的 success/fail 回调参数结构基本一致,但错误码(errCode)与错误信息(errMsg)在各端不同;业务侧不要硬编码错误码,用 fail 回调统一处理。
概念解释
uni-app 对 API 做了统一封装,success 回调的参数结构在各端基本一致(如 uni.request 的 res.statusCode、res.data)。但错误码是平台原生的:微信小程序用自己的 errCode,App 端用自己的错误码,H5 端可能是 HTTP 状态码。
硬编码错误码的问题:微信端错误码 10001 与 App 端错误码 10001 含义可能不同,业务侧写 if (err.errCode == 10001) 在不同端含义不同。正确做法是用 fail 回调统一处理,或封装错误码映射表。
原理流程
uni.request({ url, success: (res) => {}, fail: (err) => {} })
↓
各端 fail 回调结构:err.errMsg / err.errCode
↓
错误码:各端不同,不要硬编码
代码或图示
| 维度 | 统一点 | 差异点 |
|---|---|---|
| success 回调 | 参数结构基本一致 | 部分字段不同 |
| fail 回调 | 有 errMsg | errCode 各端不同 |
| 错误码 | 不统一 | 不要硬编码 |
常见误区
- 误区:错误码各端一致;正解:错误码是平台原生的,各端不同。
- 误区:只处理 success 不处理 fail;正解:每个 API 都要处理 fail,给用户友好提示。
追问
- Q:如何统一错误码?A:在封装层把各端错误码映射为业务错误码,业务侧只认业务码。
- Q:uni.canIUse 怎么用?A:
uni.canIUse('getSystemInfoSync')判断 API 是否可用,不可用则降级。
07.2.4.5-007 能力缺失的兜底方案怎么做?
一句话结论
能力缺失分三层兜底:编译期条件编译(不支持的端不调用)、运行时 uni.canIUse 判断(同端不同版本差异)、fail 回调与 try-catch(调用失败兜底);不支持时降级或隐藏入口。
概念解释
第一层:条件编译,编译期把不支持的端代码裁掉,避免调用。第二层:uni.canIUse,运行时判断 API 是否可用(同端不同版本差异)。第三层:fail 回调与 try-catch,调用失败时给用户友好提示或降级。
典型场景:某端不支持扫码 API,编译期条件编译不调用,或运行时 canIUse 判断不可用则隐藏扫码按钮;调用失败时 fail 回调提示"暂不支持"。
原理流程
调用 uni.xxx
↓
1. 编译期条件编译:不支持的端不调用
2. 运行时 canIUse:同端版本差异
3. fail 回调 / try-catch:调用失败
↓
降级或隐藏入口
代码或图示
| 兜底层 | 时机 | 适用 |
|---|---|---|
| 条件编译 | 编译期 | 端完全不支持 |
| uni.canIUse | 运行时 | 同端版本差异 |
| fail 回调 | 运行时 | 调用失败 |
| try-catch | 运行时 | 同步 API 异常 |
常见误区
- 误区:不支持的端调用会自动报错;正解:调用不支持的 API 可能静默失败或崩溃,必须兜底。
- 误区:fail 回调就够了;正解:编译期条件编译是第一道防线,避免不支持的端有调用代码。
追问
- Q:如何判断某端是否支持某 API?A:查官方平台支持表,或用 uni.canIUse 运行时判断。
- Q:降级方案怎么选?A:提供替代功能或隐藏入口,不要让用户点击无响应。
07.2.4.5-008 权限与授权在各端怎么处理?
一句话结论
App 端权限在 manifest.json 声明并在运行时申请(如相机、定位);小程序端授权在用户触发时弹窗(如获取用户信息、手机号);隐私协议需要按平台要求配置;业务侧要统一封装授权流程。
概念解释
App 端:权限在 manifest.json 的 app-plus.permissions 声明(Android 权限、iOS UsageDescription),运行时调用 API 时系统弹窗申请(如 uni.getLocation 触发定位权限弹窗)。
小程序端:授权在用户触发时弹窗(如 wx.getUserProfile 弹用户授权框),部分能力需要在小程序后台配置(如获取手机号需要认证)。隐私协议:各平台要求在首次启动时展示隐私政策,用户同意后才能收集数据。
原理流程
App 端:
manifest.json 声明权限 → 运行时调用 API → 系统弹窗申请
小程序端:
用户触发 → 平台授权弹窗 → 同意后调用 API
隐私协议:
首次启动 → 展示隐私政策 → 用户同意后收集数据
代码或图示
| 端 | 权限方式 | 关键点 |
|---|---|---|
| App | manifest 声明 + 运行时弹窗 | iOS UsageDescription 必填 |
| 小程序 | 用户触发时弹窗 | 部分能力需后台配置 |
| 隐私协议 | 首次启动展示 | 用户同意后收集数据 |
常见误区
- 误区:iOS 权限文案不填也能上架;正解:缺少 NSxxxUsageDescription 会被 Apple 拒绝。
- 误区:小程序授权自动弹窗;正解:授权在用户触发时弹窗,不能静默获取。
追问
- Q:如何封装授权流程?A:在适配层定义统一的 authorize 方法,内部按端条件编译调对应 API。
- Q:用户拒绝授权怎么办?A:提示用户去设置开启,或降级功能。
07.2.4.5-009 网络 API(uni.request)有什么多端差异?
一句话结论
uni.request 是统一的网络请求 API,各端基本一致,但 H5 受浏览器跨域限制、小程序端受域名白名单限制、App 端无跨域限制;业务侧要封装 baseURL、token、超时与错误处理。
概念解释
uni.request 统一封装了 HTTP 请求:H5 端用 XMLHttpRequest/fetch,受浏览器同源策略限制(跨域需要后端 CORS 或代理);小程序端用平台网络 API,受域名白名单限制(请求域名必须在小程序后台配置);App 端无跨域限制,可以请求任意域名。
封装要点:统一 baseURL(按环境变量区分)、注入 token、超时设置、错误码统一处理、loading 状态管理。
实际项目里通常还需要:请求拦截(注入 token、加公共参数)、响应拦截(统一错误码处理、token 过期刷新)、请求取消(页面卸载时取消未完成请求)、重试策略(网络错误重试)。这些都封装在 request 层,业务侧只调 request({ url, method, data })。
原理流程
业务调用 request({ url, method, data })
↓
封装层:注入 baseURL + token + header
↓
uni.request({ url, method, data, header })
↓
各端:H5 跨域 / 小程序域名白名单 / App 无限制
代码或图示
| 端 | 网络限制 | 处理 |
|---|---|---|
| H5 | 浏览器跨域 | 后端 CORS 或代理 |
| 小程序 | 域名白名单 | 后台配置域名 |
| App | 无限制 | 直接请求 |
常见误区
- 误区:uni.request 在所有端行为一致;正解:H5 跨域与小程序域名白名单是额外约束。
- 误区:业务代码直接调 uni.request;正解:统一封装,处理 baseURL/token/错误。
追问
- Q:H5 跨域怎么解决?A:后端配 CORS 或开发环境代理,生产用同源部署。
- Q:小程序域名白名单怎么配?A:在小程序后台配置 request 合法域名,必须 HTTPS。
07.2.4.5-010 文件 API(chooseImage/uploadFile/downloadFile)有什么多端差异?
一句话结论
uni.chooseImage 选图、uni.uploadFile 上传、uni.downloadFile 下载在各端基本一致,但 H5 端是浏览器文件选择、App 端是系统相册、小程序端是平台文件选择;上传文件在各端的 header 与 formData 有差异。
概念解释
uni.chooseImage 选图:H5 端弹浏览器文件选择框,App 端弹系统相册/相机,小程序端弹平台相册。uni.uploadFile 上传:各端都支持,但 H5 端受跨域限制,小程序端受域名白名单限制。uni.downloadFile 下载:H5 端是浏览器下载,App 端下载到本地,小程序端下载到临时文件。
差异点:chooseImage 的 count(最多选几张)、sizeType(原图/压缩)在各端支持不同;uploadFile 的 header 与 formData 格式在各端略有差异。
原理流程
uni.chooseImage({ count: 1 }) → 选图
↓
uni.uploadFile({ url, filePath, name }) → 上传
↓
uni.downloadFile({ url }) → 下载
代码或图示
| API | 用途 | 各端差异 |
|---|---|---|
| chooseImage | 选图 | 相册/相机选择方式 |
| uploadFile | 上传 | header/formData 差异 |
| downloadFile | 下载 | 存储位置不同 |
常见误区
- 误区:chooseImage 在所有端都支持相机;正解:H5 端通过 input capture 触发,App/小程序直接调系统相机。
- 误区:uploadFile 与 uni.request 一样;正解:uploadFile 是 multipart/form-data 上传,不是 JSON。
追问
- Q:如何封装上传?A:封装 chooseImage + uploadFile,处理进度与错误。
- Q:小程序上传域名也要白名单吗?A:是,uploadFile 合法域名要在小程序后台配置。
07.2.4.5-011 存储 API(setStorage/getStorage)有什么多端差异?
一句话结论
uni.setStorage/getStorage 是键值存储,各端基本一致,但底层实现不同(H5 是 localStorage、App 是原生存储、小程序是平台存储);容量限制与过期策略各端不同。
概念解释
uni.setStorageSync 同步写、uni.getStorageSync 同步读:H5 底层是 localStorage,App 底层是原生存储(SQLite/文件),小程序底层是平台存储。容量限制:H5 通常 5-10MB,小程序通常 10MB,App 通常更大(具体以各端为准)。
差异点:存储的数据是键值对,值会被序列化为字符串;敏感信息(token)不要明文长期存储;过期策略需要业务自己实现(存时间戳,读取时判断)。
原理流程
uni.setStorageSync('token', 'xxx')
↓
uni.getStorageSync('token')
↓
各端底层:H5 localStorage / App 原生 / 小程序平台
代码或图示
| 端 | 底层 | 容量 |
|---|---|---|
| H5 | localStorage | 5-10MB |
| App | 原生存储 | 较大 |
| 小程序 | 平台存储 | 10MB |
常见误区
- 误区:存储容量无限;正解:各端有容量限制,大数据要走云端。
- 误区:token 明文存本地;正解:按合规要求控制敏感信息存储。
追问
- Q:如何实现过期策略?A:存时间戳,读取时判断是否过期,过期则删除。
- Q:存储与内存状态如何配合?A:内存状态用于运行时,存储用于重启恢复。
07.2.4.5-012 uts 插件、nvue 原生模块、原生组件的接入代价是什么?
一句话结论
uts 插件用 UTS 语言写,编译为 Android/iOS 原生代码,接入成本中等;nvue 原生模块用原生语言写(Kotlin/Swift),接入成本高;原生组件把原生 View 包装为 vue 组件,成本最高。
概念解释
uts 插件:用 UTS 语言(类 Kotlin/Swift)写,uni-app x 的核心技术,编译为 Kotlin(Android)与 Swift(iOS),接入方式是放进 uni_modules/,业务直接 import。成本中等,因为 UTS 是跨端语言,一套代码编译双端。
nvue 原生模块:用 Kotlin(Android)与 Swift(iOS)分别写,通过 weex 引擎暴露给 JS 层。成本高,因为要写双端原生代码。
原生组件:把原生 View 包装为 vue 组件,让业务像用普通组件一样用。成本最高,因为要处理组件生命周期、属性同步、事件回调。
接入原生插件的评估要点:一是插件是否有维护(下载量、最近更新、issue 响应);二是包体影响(原生插件会增加 App 体积);三是版本兼容(是否支持 Vue3、是否支持 App 双端);四是授权成本(商业插件是否收费)。优先用插件市场成熟插件,自研原生插件成本高。
原理流程
uts 插件:UTS 代码 → 编译 Kotlin/Swift → uni_modules 引入
nvue 原生模块:Kotlin/Swift → weex 暴露 → JS 调用
原生组件:原生 View → 包装为组件 → vue 模板使用
代码或图示
| 类型 | 语言 | 成本 | 适用 |
|---|---|---|---|
| uts 插件 | UTS | 中 | 跨端原生能力 |
| nvue 原生模块 | Kotlin/Swift | 高 | nvue 页面能力 |
| 原生组件 | Kotlin/Swift | 最高 | 自定义原生 View |
常见误区
- 误区:原生插件一次接入三端通用;正解:uts 插件编译双端,nvue 原生模块要分别写双端。
- 误区:原生插件接入很简单;正解:原生代码调试、签名、版本维护成本高。
追问
- Q:什么场景需要原生插件?A:统一 API 与条件编译覆盖不了的能力(如特定硬件、原生 SDK)。
- Q:uts 插件与 nvue 原生模块选哪个?A:优先 uts 插件,跨端一套代码;nvue 原生模块用于 nvue 页特殊需求。
07.2.4.5-013 uni-ui 与自定义组件怎么跨端复用?
一句话结论
uni-ui 是官方跨端组件库,基于 easycom 自动引入;自定义组件放在 components/ 目录,通过 easycom 或手动引入;跨端复用要注意组件内部样式与 API 在各端的兼容。
概念解释
uni-ui 提供跨端一致的组件(如 uni-badge、uni-card、uni-list),安装后通过 easycom 自动引入,业务直接用 <uni-badge />。自定义组件放在 components/组件名/组件名.vue,通过 easycom 自动引入或手动 import。
跨端复用的注意点:组件内部不要用平台专有组件(用条件编译处理);样式要兼容 nvue 限制(text 包裹、flex 布局);组件 props 与 events 要跨端一致。
原理流程
uni-ui:安装 → easycom 自动引入 → <uni-badge />
自定义组件:components/组件名/组件名.vue → easycom 自动引入
代码或图示
| 组件来源 | 引入方式 | 注意 |
|---|---|---|
| uni-ui | easycom 自动 | 官方维护 |
| 自定义组件 | easycom 或手动 | 样式兼容 nvue |
常见误区
- 误区:自定义组件跨端复用不用考虑样式;正解:nvue 样式受限,组件内部要兼容。
- 误区:uni-ui 所有端表现一致;正解:uni-ui 尽量跨端一致,但部分组件样式仍有差异。
追问
- Q:如何封装跨端业务组件?A:组件内部用条件编译处理端差异,对外暴露统一 props/events。
- Q:uni-ui 不满足需求怎么办?A:基于 uni-ui 二次封装或自己写组件。
07.2.4.5-014 事件冒泡与组件样式隔离有什么差异?
一句话结论
uni-app 组件事件冒泡遵循 Vue 标准(子组件 emit,父组件监听),但小程序端有自己的冒泡机制(如 catch 阻止冒泡);样式隔离在小程序端默认隔离(scoped),App/H5 端默认样式穿透。
概念解释
事件冒泡:Vue 标准是子组件 this.$emit('event', data),父组件 @event="handler"。小程序端有 catchtap 阻止冒泡(对应 Vue 的 .stop 修饰符)。
样式隔离:小程序端组件样式默认隔离(不影响外部),App/H5 端样式默认穿透(除非用 scoped)。跨端组件要注意:小程序端样式隔离可能导致外部无法覆盖组件内部样式。
原理流程
事件:子组件 $emit → 父组件 @event
样式:小程序端默认隔离 / App/H5 端默认穿透
代码或图示
| 维度 | Vue 标准 | 小程序差异 |
|---|---|---|
| 事件冒泡 | $emit | catch 阻止冒泡 |
| 样式隔离 | scoped | 小程序默认隔离 |
常见误区
- 误区:小程序端样式能穿透到组件内部;正解:小程序端样式默认隔离,外部覆盖不了组件内部样式。
- 误区:事件冒泡各端一致;正解:小程序端用 catch 阻止冒泡,与 Vue 的 .stop 修饰符对应。
追问
- Q:如何在小程序端让外部覆盖组件样式?A:用外部 CSS 变量或开放样式类(externalClasses),具体以官方文档为准。
- Q:catch 与 .stop 修饰符对应吗?A:catch 阻止冒泡,对应 Vue 的 .stop 修饰符。
07.2.4.5-015 登录支付分享的基础差异怎么在本章讲?
一句话结论
登录、支付、分享的完整业务链路属于 07.2.4.10(另一位子 Agent 写),本章只讲基础差异:各端 API 不同、授权结果需换业务登录态、支付回调需核对订单状态;业务侧要统一封装服务层。
概念解释
登录:微信小程序用 wx.login() 拿 code,App 端用 uni.login() 带 provider,H5 端用账号密码或第三方登录;拿到平台凭证后,要在后端换取业务登录态(token)。
支付:微信小程序用 wx.requestPayment,App 端用 uni.requestPayment,参数与回调机制在各端不同;支付结果以后端回调为准,不要以前端 success 为准。
分享:微信小程序用 onShareAppMessage,App 端用分享 SDK,H5 端用 Web 分享;分享参数在各端不同。
完整链路在 07.2.4.10,本章只讲基础差异与封装思路。
原理流程
业务调用统一 auth/pay 服务
↓
服务层条件编译调各端 API
↓
微信:wx.login / wx.requestPayment
App:uni.login / uni.requestPayment
H5:自定义
↓
后端换业务登录态 / 核对支付结果
代码或图示
| 能力 | 各端 API | 完整链路 |
|---|---|---|
| 登录 | wx.login / uni.login / 自定义 | 见 07.2.4.10 |
| 支付 | wx.requestPayment / uni.requestPayment | 见 07.2.4.10 |
| 分享 | onShareAppMessage / 分享 SDK | 见 07.2.4.10 |
常见误区
- 误区:前端支付 success 就是支付成功;正解:支付结果以后端回调为准,前端 success 只是支付流程完成。
- 误区:各端登录 API 一样;正解:各端 API 不同,要统一封装。
追问
- Q:为什么要后端换登录态?A:平台凭证(code)是临时的,后端用 code 换用户 openid,再建立业务 token。
- Q:支付失败怎么处理?A:以后端回调核对订单状态,不要以前端 fail 为准。
07.2.4.5-016 综合题:某 API 在某端不支持,怎么兜底?
一句话结论
按三步兜底:先查官方平台支持表确认不支持,再用条件编译在编译期裁掉该端调用,最后在运行时用 canIUse 判断并降级(替代功能或隐藏入口)。
概念解释
第一步:查官方文档平台支持表,确认某 API 在某端不支持。第二步:用条件编译 #ifndef 不支持端 包裹调用,其他端不调用该 API。第三步:如果同端不同版本也有差异,用 uni.canIUse 运行时判断,不可用则降级(提供替代功能或隐藏按钮)。
典型场景:App 端不支持某小程序 API,条件编译裁掉;H5 端不支持某 App API,条件编译裁掉。兜底方案要让用户有合理预期,不要点击无响应。
原理流程
某 API 某端不支持
↓
1. 查官方平台支持表
↓
2. 条件编译 #ifndef 不支持端 → 不调用
↓
3. 运行时 canIUse 判断 → 降级或隐藏入口
代码或图示
| 步骤 | 做法 |
|---|---|
| 确认 | 查官方平台支持表 |
| 编译期 | 条件编译裁掉不支持端 |
| 运行时 | canIUse 判断 + 降级 |
常见误区
- 一上来就写 try-catch;正解:先查官方文档确认,条件编译是第一道防线。
- 不支持就隐藏按钮;正解:如果业务需要,提供替代功能或明确提示"暂不支持"。
追问
- Q:如何批量处理不支持的 API?A:在适配层统一封装,内部按端条件编译,业务侧零感知。
- Q:降级方案怎么选?A:优先提供替代功能,其次隐藏入口,最后提示"暂不支持"。