uniapp
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chineseuni-app
uni-app
本 skill 基于 uni-app 文档生成，生成日期 2026-01-29。
uni-app 是基于 Vue 的跨平台应用开发框架，一套代码可编译到 App、H5、微信/支付宝/百度等小程序。适用于需要为 Agent 提供「如何用 uni-app 配置项目、写页面与组件、使用路由与 API、注意跨端差异」等能力说明的场景。
本 skill 基于 uni-app 文档生成，生成日期 2026-01-29。
uni-app 是基于 Vue 的跨平台应用开发框架，一套代码可编译到 App、H5、微信/支付宝/百度等小程序。适用于需要为 Agent 提供「如何用 uni-app 配置项目、写页面与组件、使用路由与 API、注意跨端差异」等能力说明的场景。
核心参考
核心参考
| 主题 | 说明 | 参考 |
|---|---|---|
| 入口 main.js/uts | 入口文件、代码时序、插件与路由 | core-main |
| App.vue | 应用生命周期、globalData、全局样式 | core-app |
| pages.json | 页面路由、globalStyle、tabBar、easycom | core-pages |
| 页面生命周期 | onLoad、onShow、onReady、onHide、onUnload | core-lifecycle |
| manifest.json | 应用配置、版本、超时、各端配置 | core-manifest |
| 条件编译 | #ifdef/#ifndef、平台标识、多端差异化 | core-conditional-compilation |
| 样式与布局 | rpx/px 单位、预处理器、nvue 差异 | core-syntax-css |
| 分包配置 | subPackages、preloadRule、主包与分包 | core-subpackages |
| 主题 | 说明 | 参考 |
|---|---|---|
| 入口 main.js/uts | 入口文件、代码时序、插件与路由 | core-main |
| App.vue | 应用生命周期、globalData、全局样式 | core-app |
| pages.json | 页面路由、globalStyle、tabBar、easycom | core-pages |
| 页面生命周期 | onLoad、onShow、onReady、onHide、onUnload | core-lifecycle |
| manifest.json | 应用配置、版本、超时、各端配置 | core-manifest |
| 条件编译 | #ifdef/#ifndef、平台标识、多端差异化 | core-conditional-compilation |
| 样式与布局 | rpx/px 单位、预处理器、nvue 差异 | core-syntax-css |
| 分包配置 | subPackages、preloadRule、主包与分包 | core-subpackages |
能力参考
能力参考
| 主题 | 说明 | 参考 |
|---|---|---|
| API 概述 | uni API、Promise 化、各端特色 API、canIUse | features-api-overview |
| 路由与跳转 | navigateTo/redirectTo/reLaunch/switchTab、传参、EventChannel、窗口动画 | features-router |
| 组件概述 | 基础组件分类、公共属性、easycom、扩展组件 | features-component-overview |
| 自定义组件 | slot、ref、父子通信、defineExpose | features-vue-components |
| Vue 基础 | 单文件结构、数据绑定、事件、列表与条件渲染 | features-vue-basics |
| 页面栈与通讯 | getCurrentPages、uni.$emit/$on/$off | features-window-communication |
| 下拉与触底 | onPullDownRefresh、onReachBottom、start/stopPullDownRefresh | features-pulldown |
| 定时器 | setTimeout、setInterval、clearTimeout、clearInterval、销毁时清理 | features-timer |
| 网络请求 | uni.request、上传下载、超时与中断 | features-request |
| 网络状态 | getNetworkType、onNetworkStatusChange、offNetworkStatusChange | features-network |
| 上传与下载 | uploadFile、downloadFile、formData、多文件 | features-upload-download |
| WebSocket | connectSocket、SocketTask、onOpen/onMessage/send/close | features-websocket |
| 数据缓存 | setStorage/getStorage、本地持久化 | features-storage |
| 剪贴板 | setClipboardData、getClipboardData | features-clipboard |
| 键盘 | hideKeyboard、onKeyboardHeightChange、offKeyboardHeightChange | features-keyboard |
| 启动参数 | getLaunchOptionsSync、getEnterOptionsSync、path/query/scene | features-launch-options |
| 授权与设置 | authorize、getSetting、openSetting、scope 列表 | features-authorize |
| 交互反馈 | showToast、showLoading、showModal、showActionSheet | features-ui-prompt |
| 拦截器 | addInterceptor、removeInterceptor、回调与返回值改写 | features-interceptor |
| 节点信息 | createSelectorQuery、boundingClientRect、scrollOffset、in(component) | features-nodes-info |
| 节点相交 | createIntersectionObserver、relativeTo、observe、disconnect | features-intersection-observer |
| 表单 | form 组件、report-submit、@submit、@reset、form-type | features-form |
| 图片 | chooseImage、previewImage、getImageInfo、saveImageToPhotosAlbum | features-media-image |
| 视频与音频 | chooseVideo、createVideoContext、getRecorderManager、createInnerAudioContext、getBackgroundAudioManager | features-media-video-audio |
| 文件 | saveFile、getSavedFileList、openDocument、getFileSystemManager | features-file |
| 位置与地图 | getLocation、chooseLocation、openLocation、位置更新、createMapContext | features-location |
| 画布 | createCanvasContext、CanvasContext、canvasToTempFilePath | features-canvas |
| 导航栏与 TabBar | setNavigationBarTitle、setTabBarItem、hideTabBar、setTabBarBadge | features-navigation-tabbar |
| 媒体查询与胶囊按钮 | createMediaQueryObserver、getMenuButtonBoundingClientRect、setBackgroundColor | features-ui-extras |
| 动画 | createAnimation、animation.export、组件 animation 属性、pageScrollTo | features-ui-animation |
| 字体与单位 | loadFontFace、rpx2px、upx2px | features-font |
| 语言与主题 | getLocale、setLocale、onLocaleChange、onThemeChange | features-locale-theme |
| 系统信息 | getSystemInfo、getDeviceInfo、getWindowInfo、getAppBaseInfo | features-system-info |
| 设备能力 | 振动、scanCode、makePhoneCall、getBatteryInfo、onMemoryWarning | features-system-device |
| 应用级事件 | onPageNotFound、onError、onAppShow、onAppHide | features-application-events |
| 页面预加载 | preloadPage、unPreloadPage（App-nvue、H5） | features-preload-page |
| 登录/支付/分享/推送 | login、getUserInfo、requestPayment、share、getProvider、push 概述 | features-plugins-overview |
| 其它 API | getAccountInfoSync、getEnvInfoSync、getUpdateManager、navigateToMiniProgram、exit、nextTick、base64 | features-other-apis |
| H5 宽屏适配 | topWindow、leftWindow、rightWindow、getTopWindowStyle、setTopWindowStyle | features-h5-adapt |
| 主题 | 说明 | 参考 |
|---|---|---|
| API 概述 | uni API、Promise 化、各端特色 API、canIUse | features-api-overview |
| 路由与跳转 | navigateTo/redirectTo/reLaunch/switchTab、传参、EventChannel、窗口动画 | features-router |
| 组件概述 | 基础组件分类、公共属性、easycom、扩展组件 | features-component-overview |
| 自定义组件 | slot、ref、父子通信、defineExpose | features-vue-components |
| Vue 基础 | 单文件结构、数据绑定、事件、列表与条件渲染 | features-vue-basics |
| 页面栈与通讯 | getCurrentPages、uni.$emit/$on/$off | features-window-communication |
| 下拉与触底 | onPullDownRefresh、onReachBottom、start/stopPullDownRefresh | features-pulldown |
| 定时器 | setTimeout、setInterval、clearTimeout、clearInterval、销毁时清理 | features-timer |
| 网络请求 | uni.request、上传下载、超时与中断 | features-request |
| 网络状态 | getNetworkType、onNetworkStatusChange、offNetworkStatusChange | features-network |
| 上传与下载 | uploadFile、downloadFile、formData、多文件 | features-upload-download |
| WebSocket | connectSocket、SocketTask、onOpen/onMessage/send/close | features-websocket |
| 数据缓存 | setStorage/getStorage、本地持久化 | features-storage |
| 剪贴板 | setClipboardData、getClipboardData | features-clipboard |
| 键盘 | hideKeyboard、onKeyboardHeightChange、offKeyboardHeightChange | features-keyboard |
| 启动参数 | getLaunchOptionsSync、getEnterOptionsSync、path/query/scene | features-launch-options |
| 授权与设置 | authorize、getSetting、openSetting、scope 列表 | features-authorize |
| 交互反馈 | showToast、showLoading、showModal、showActionSheet | features-ui-prompt |
| 拦截器 | addInterceptor、removeInterceptor、回调与返回值改写 | features-interceptor |
| 节点信息 | createSelectorQuery、boundingClientRect、scrollOffset、in(component) | features-nodes-info |
| 节点相交 | createIntersectionObserver、relativeTo、observe、disconnect | features-intersection-observer |
| 表单 | form 组件、report-submit、@submit、@reset、form-type | features-form |
| 图片 | chooseImage、previewImage、getImageInfo、saveImageToPhotosAlbum | features-media-image |
| 视频与音频 | chooseVideo、createVideoContext、getRecorderManager、createInnerAudioContext、getBackgroundAudioManager | features-media-video-audio |
| 文件 | saveFile、getSavedFileList、openDocument、getFileSystemManager | features-file |
| 位置与地图 | getLocation、chooseLocation、openLocation、位置更新、createMapContext | features-location |
| 画布 | createCanvasContext、CanvasContext、canvasToTempFilePath | features-canvas |
| 导航栏与 TabBar | setNavigationBarTitle、setTabBarItem、hideTabBar、setTabBarBadge | features-navigation-tabbar |
| 媒体查询与胶囊按钮 | createMediaQueryObserver、getMenuButtonBoundingClientRect、setBackgroundColor | features-ui-extras |
| 动画 | createAnimation、animation.export、组件 animation 属性、pageScrollTo | features-ui-animation |
| 字体与单位 | loadFontFace、rpx2px、upx2px | features-font |
| 语言与主题 | getLocale、setLocale、onLocaleChange、onThemeChange | features-locale-theme |
| 系统信息 | getSystemInfo、getDeviceInfo、getWindowInfo、getAppBaseInfo | features-system-info |
| 设备能力 | 振动、scanCode、makePhoneCall、getBatteryInfo、onMemoryWarning | features-system-device |
| 应用级事件 | onPageNotFound、onError、onAppShow、onAppHide | features-application-events |
| 页面预加载 | preloadPage、unPreloadPage（App-nvue、H5） | features-preload-page |
| 登录/支付/分享/推送 | login、getUserInfo、requestPayment、share、getProvider、push 概述 | features-plugins-overview |
| 其它 API | getAccountInfoSync、getEnvInfoSync、getUpdateManager、navigateToMiniProgram、exit、nextTick、base64 | features-other-apis |
| H5 宽屏适配 | topWindow、leftWindow、rightWindow、getTopWindowStyle、setTopWindowStyle | features-h5-adapt |
进阶参考
进阶参考
| 主题 | 说明 | 参考 |
|---|---|---|
| nvue | 原生渲染、与 vue 差异、requireNativePlugin | advanced-nvue |
| renderjs | 视图层 JS、App 端操作 DOM、echarts 等 | advanced-renderjs |
| subNVues | App 原生子窗体、getSubNVueById、getCurrentSubNVue | advanced-subnvue |
| Worker | 多线程、各端实现差异 | advanced-worker |
| 主题 | 说明 | 参考 |
|---|---|---|
| nvue | 原生渲染、与 vue 差异、requireNativePlugin | advanced-nvue |
| renderjs | 视图层 JS、App 端操作 DOM、echarts 等 | advanced-renderjs |
| subNVues | App 原生子窗体、getSubNVueById、getCurrentSubNVue | advanced-subnvue |
| Worker | 多线程、各端实现差异 | advanced-worker |
最佳实践
最佳实践
| 主题 | 说明 | 参考 |
|---|---|---|
| 跨端注意 | 标签与样式、JS/API 差异、工程与配置、常见异常 | best-practices-cross-platform |
| 主题 | 说明 | 参考 |
|---|---|---|
| 跨端注意 | 标签与样式、JS/API 差异、工程与配置、常见异常 | best-practices-cross-platform |