罗罗编程学习记录
本页内容 展开查看

07.2.4.5 组件与 API 多端差异

所属:全栈开发面试题库 / 07 端侧与桌面开发 / 07.2 跨平台移动开发 / 07.2.4 uni-app

本节要解决的问题

  • uni-app 内置组件(view/scroll-view/swiper/picker/map/video/canvas)在各端支持情况如何?
  • 同一组件在不同端的属性、事件、样式有哪些关键差异?
  • 平台专有组件怎么用条件编译接入?
  • 同一 uni.xxx API 在各端的返回值、错误码、能力边界有什么不同?
  • 权限与授权(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:优先提供替代功能,其次隐藏入口,最后提示"暂不支持"。