tmui-cli 2.0.4 → 2.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/data/components.json +1 -1
- package/data/config.json +1 -1
- package/data/doc-index.json +1 -1
- package/data/examples/radio.vue +4 -0
- package/data/guides//346/233/264/346/226/260/346/227/245/345/277/227.md +2 -0
- package/data/tmui4x/60.AI/350/207/252/345/212/250/345/214/226/01.Agent.md +42 -16
- package/data/tmui4x/60.AI/350/207/252/345/212/250/345/214/226/04.SKILL.md +9 -8
- package/data/tmui4x-doc-index.json +1 -1
- package/data/uni-app-x-docs/.vuepress/utils/cssJson.json +1 -1
- package/data/uni-app-x-docs/.vuepress/utils/example-mapping.json +7 -0
- package/data/uni-app-x-docs/.vuepress/utils/utsApiJson.json +1 -1
- package/data/uni-app-x-docs/.vuepress/utils/utsComJson.json +1 -1
- package/data/uni-app-x-docs/.vuepress/utils/vueJson.json +1 -1
- package/data/uni-app-x-docs/_sidebar.md +6 -1
- package/data/uni-app-x-docs/api/get-location.md +6 -6
- package/data/uni-app-x-docs/api/modal.md +2 -1
- package/data/uni-app-x-docs/api/request.md +1 -0
- package/data/uni-app-x-docs/api/toast.md +2 -2
- package/data/uni-app-x-docs/api/window.md +2 -0
- package/data/uni-app-x-docs/collocation/app.md +10 -5
- package/data/uni-app-x-docs/collocation/manifest-android.md +15 -15
- package/data/uni-app-x-docs/collocation/manifest-ios.md +17 -16
- package/data/uni-app-x-docs/collocation/manifest-modules.md +10 -10
- package/data/uni-app-x-docs/component/map.md +10 -8
- package/data/uni-app-x-docs/component/video.md +8 -4
- package/data/uni-app-x-docs/css/_sidebar.md +0 -1
- package/data/uni-app-x-docs/css/common/function.md +8 -4
- package/data/uni-app-x-docs/css/common/selector.md +2 -0
- package/data/uni-app-x-docs/mp/README.md +0 -4
- package/data/uni-app-x-docs/mp/native-component-and-wxs.md +166 -0
- package/data/uni-app-x-docs/native/download/android.md +106 -19
- package/data/uni-app-x-docs/native/download/ios.md +11 -9
- package/data/uni-app-x-docs/page.md +2 -0
- package/data/uni-app-x-docs/project.md +6 -7
- package/data/uni-app-x-docs/release-note-alpha.md +142 -0
- package/data/uni-app-x-docs/release.md +263 -0
- package/data/uni-app-x-docs/select/native-render-and-self-render.md +386 -0
- package/data/uni-app-x-docs/tutorial/android-16kb.md +5 -1
- package/data/uni-app-x-docs/tutorial/app-env.md +1 -1
- package/data/uni-app-x-docs/tutorial/app-update-wgt.md +13 -0
- package/data/uni-app-x-docs/tutorial/store.md +0 -1
- package/data/uni-app-x-docs/uts/README.md +27 -25
- package/data/uni-app-x-docs/vue/README.md +64 -29
- package/data/uni-app-x-docs/vue/built-in.md +1 -1
- package/data/uni-app-x-docs/vue/component.md +1 -1
- package/data/uni-app-x-docs/vue/composition-api.md +6 -19
- package/data/uni-app-x-docs/vue/global-api.md +1 -1
- package/data/uniappx/_sidebar.md +6 -1
- package/data/uniappx/api/create-editor-context-async.md +3 -3
- package/data/uniappx/api/get-app-base-info.md +14 -14
- package/data/uniappx/api/get-file-system-manager.md +2 -2
- package/data/uniappx/api/get-location.md +6 -6
- package/data/uniappx/api/modal.md +2 -1
- package/data/uniappx/api/on-tab-bar-mid-button-tap.md +4 -4
- package/data/uniappx/api/request.md +1 -0
- package/data/uniappx/api/toast.md +4 -4
- package/data/uniappx/api/window.md +2 -0
- package/data/uniappx/collocation/app.md +10 -5
- package/data/uniappx/collocation/manifest-android.md +15 -15
- package/data/uniappx/collocation/manifest-ios.md +17 -16
- package/data/uniappx/collocation/manifest-modules.md +10 -10
- package/data/uniappx/component/checkbox.md +2 -2
- package/data/uniappx/component/input.md +9 -15
- package/data/uniappx/component/label.md +4 -3
- package/data/uniappx/component/map.md +19 -14
- package/data/uniappx/component/swiper.md +31 -67
- package/data/uniappx/component/switch.md +3 -9
- package/data/uniappx/component/textarea.md +4 -8
- package/data/uniappx/component/uni-ui-x/uni-badge-view.md +2 -2
- package/data/uniappx/component/uni-ui-x/uni-collapse.md +11 -55
- package/data/uniappx/component/uni-ui-x/uni-fab-button.md +1 -1
- package/data/uniappx/component/uni-ui-x/uni-link.md +1 -1
- package/data/uniappx/component/uni-ui-x/uni-number-box.md +2 -2
- package/data/uniappx/component/uni-ui-x/uni-rate.md +2 -2
- package/data/uniappx/component/uni-ui-x/uni-refresh-box.md +1 -1
- package/data/uniappx/component/uni-ui-x/uni-tab.md +44 -2
- package/data/uniappx/component/video.md +16 -13
- package/data/uniappx/component/web-view.md +10 -21
- package/data/uniappx/css/_sidebar.md +1 -2
- package/data/uniappx/css/common/function.md +7 -4
- package/data/uniappx/css/common/selector.md +14 -14
- package/data/uniappx/mp/README.md +0 -4
- package/data/uniappx/mp/native-component-and-wxs.md +151 -0
- package/data/uniappx/native/download/android.md +106 -19
- package/data/uniappx/native/download/ios.md +11 -9
- package/data/uniappx/page.md +2 -0
- package/data/uniappx/project.md +5 -6
- package/data/uniappx/release-note-alpha.md +142 -0
- package/data/uniappx/release.md +263 -0
- package/data/uniappx/select/native-render-and-self-render.md +382 -0
- package/data/uniappx/tutorial/android-16kb.md +5 -1
- package/data/uniappx/tutorial/app-env.md +1 -1
- package/data/uniappx/tutorial/app-update-wgt.md +9 -0
- package/data/uniappx/uts/README.md +27 -25
- package/data/uniappx/vue/README.md +11 -82
- package/data/uniappx/vue/built-in.md +2 -2
- package/data/uniappx/vue/component.md +1 -1
- package/data/uniappx/vue/composition-api.md +2 -86
- package/data/uniappx/vue/global-api.md +1 -1
- package/data/uniappx/vue/modifier.md +3 -3
- package/data/uniappx-doc-index.json +44 -16
- package/dist/main.mjs +1 -1
- package/package.json +1 -1
- package/data/uni-app-x-docs/css/css_diff_web.md +0 -802
- package/data/uniappx/css/css_diff_web.md +0 -802
|
@@ -67,6 +67,8 @@
|
|
|
67
67
|
* [概述](mp/README.md)
|
|
68
68
|
* [AI 开发模式接入指南](mp/mp-weixin-ai-develop.md)
|
|
69
69
|
* [独立分包](mp/independent-subpackage.md)
|
|
70
|
+
* [组件和 WXS](mp/native-component-and-wxs.md)
|
|
71
|
+
* [分包异步化](mp/miniprogram-subcontract-asynchrony.md)
|
|
70
72
|
* [适配 glass-easel](mp/mp-weixin-glass-easel.md)
|
|
71
73
|
* 运行和调试
|
|
72
74
|
* [Android/iOS运行](tutorial/run-app.md)
|
|
@@ -90,7 +92,9 @@
|
|
|
90
92
|
* [Android性能评测基准报告](benchmark/vapor-benchmark-android.md)
|
|
91
93
|
* [iOS性能评测基准报告](benchmark/vapor-benchmark-ios.md)
|
|
92
94
|
* [鸿蒙性能评测基准报告](benchmark/vapor-benchmark-harmony.md)
|
|
93
|
-
*
|
|
95
|
+
* 选型参考
|
|
96
|
+
* [一文讲透原生渲染和自渲染](./select/native-render-and-self-render.md)
|
|
97
|
+
* [uni-app 升级 uni-app x](uniapptox.md)
|
|
94
98
|
* 安全专题
|
|
95
99
|
* [综述](tutorial/safe.md)
|
|
96
100
|
* 客户端安全
|
|
@@ -127,6 +131,7 @@
|
|
|
127
131
|
* [uni-push2.0、uni-id、uni统计的组合](https://doc.dcloud.net.cn/uniCloud/uni-cloud-push/mate.html)
|
|
128
132
|
* [安卓、鸿蒙厂商推送配置](uni-push/vendor_config.md)
|
|
129
133
|
* [谷歌FCM配置](uni-push/google-fcm.md)
|
|
134
|
+
* [uni统计](https://uniapp.dcloud.net.cn/uni-stat-uniappx)
|
|
130
135
|
* cursor/vscode插件
|
|
131
136
|
* [语言服务插件](tutorial/ls-plugin.md)
|
|
132
137
|
* [AI Rules/MCP](tutorial/rules_mcp.md)
|
|
@@ -66,23 +66,23 @@ web平台也分系统定位的SDK定位。系统定位只有wgs84坐标。三方
|
|
|
66
66
|
|
|
67
67
|
|
|
68
68
|
#### Android平台
|
|
69
|
-
参考 [Android平台配置“uni-location(定位)”](../collocation/manifest-android.md#
|
|
69
|
+
参考 [Android平台配置“uni-location(定位)”](../collocation/manifest-android.md#moduleslocation)
|
|
70
70
|
|
|
71
|
-
使用腾讯定位时,需配置对应的Key,参考[Android平台配置腾讯定位](../collocation/manifest-android.md#
|
|
71
|
+
使用腾讯定位时,需配置对应的Key,参考[Android平台配置腾讯定位](../collocation/manifest-android.md#locationtencent)
|
|
72
72
|
|
|
73
73
|
#### iOS平台
|
|
74
|
-
参考 [iOS平台配置“uni-location(定位)”](../collocation/manifest-ios.md#
|
|
74
|
+
参考 [iOS平台配置“uni-location(定位)”](../collocation/manifest-ios.md#moduleslocation)。
|
|
75
75
|
|
|
76
76
|
使用腾讯定位时,需配置对应的Key,参考[iOS平台配置腾讯定位](../collocation/manifest-ios.md#locationtencent)。
|
|
77
77
|
|
|
78
78
|
使用高精度定位,需要配置 `NSLocationTemporaryUsageDescriptionDictionary`,参考[](../collocation/manifest-ios.md#hightprecision)。
|
|
79
79
|
|
|
80
|
-
如果应用需要后台定位能力,需在 `manifest.json` 中的 [后台运行能力](../collocation/manifest-ios.md#
|
|
80
|
+
如果应用需要后台定位能力,需在 `manifest.json` 中的 [后台运行能力](../collocation/manifest-ios.md#backgroundmodes) 配置 `location`。
|
|
81
81
|
|
|
82
82
|
#### 鸿蒙平台
|
|
83
|
-
参考 [鸿蒙平台配置“uni-location(定位)”](../collocation/manifest-harmony#
|
|
83
|
+
参考 [鸿蒙平台配置“uni-location(定位)”](../collocation/manifest-harmony#moduleslocation)。
|
|
84
84
|
|
|
85
|
-
鸿蒙平台暂时仅支持系统定位,参考 [鸿蒙平台配置“系统定位”](../collocation/manifest-harmony.md#
|
|
85
|
+
鸿蒙平台暂时仅支持系统定位,参考 [鸿蒙平台配置“系统定位”](../collocation/manifest-harmony.md#locationsystem)。
|
|
86
86
|
|
|
87
87
|
|
|
88
88
|
### 权限@permission
|
|
@@ -47,4 +47,5 @@ uni.showModal({
|
|
|
47
47
|
success: function (showRet : ShowModalSuccess) {
|
|
48
48
|
}
|
|
49
49
|
})
|
|
50
|
-
```
|
|
50
|
+
```
|
|
51
|
+
* `uni.showModal` 是跨平台模态弹框 API。如需在 App iOS 26+ 的蒸汽模式中使用液态玻璃效果,可使用 [uni-glass-modal](https://ext.dcloud.net.cn/plugin?name=uni-glass-modal) 插件(HBuilderX 5.25+);iOS 26 以下将降级为系统毛玻璃效果。
|
|
@@ -66,6 +66,7 @@ complete: () => {
|
|
|
66
66
|
|
|
67
67
|
如不释放,在调用Task对象的方法将导致控制台报错:
|
|
68
68
|
`error: instance object does not exist: id:15`
|
|
69
|
+
* Android release 包默认禁止 http 明文请求(Android 9+ targetSdkVersion≥28)。会导致联网失败。优先推荐使用 https 来解决。如果确定坚持不安全的http,那么方案如下:在项目根目录新建 AndroidManifest.xml,给 application 节点加 android:usesCleartextTraffic="true",配置方式见 https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-android.html
|
|
69
70
|
|
|
70
71
|
<!-- UTSAPIJSON.general_type.name -->
|
|
71
72
|
|
|
@@ -47,8 +47,8 @@
|
|
|
47
47
|
- 只有系统 toast ,和 App window 绑定
|
|
48
48
|
- 不支持 icon 图标,仅支持文字
|
|
49
49
|
- 5.25 及以上:
|
|
50
|
-
* position 设为 bottom 时,为系统 toast
|
|
51
|
-
*
|
|
50
|
+
* position 设为 top、center、bottom 时,为系统 toast,和页面绑定
|
|
51
|
+
* 当没有传递 position 参数时,支持 icon、mask、image 参数,和页面绑定
|
|
52
52
|
- 当 Toast 和页面绑定时:
|
|
53
53
|
+ 当showToast执行时,会寻找当前页面栈顶的窗体(包括 dialogPage),找到后进行绑定,然后弹出 Toast。
|
|
54
54
|
+ 在支持 dialogPage 的平台(Web和App),[uni.showModal](./modal.md)、[uni.showActionSheet](./action-sheet.md) 也是 dialogPage 实现的,此时 toast 会绑定到这些 dialogPage 上
|
|
@@ -45,11 +45,11 @@
|
|
|
45
45
|
- App平台可通过以下方法配置使用 scheme(deeplink) 启动应用,打包后生效
|
|
46
46
|
+ Android平台在 `manifest.json` 的可视化界面配置 scheme,参考[Android平台配置URL Schemes](../collocation/manifest-android.md#urlschemes)
|
|
47
47
|
+ iOS平台在 `manifest.json` 的可视化界面配置 scheme,参考[Android平台配置URL Schemes](../collocation/manifest-ios.md#urlschemes)
|
|
48
|
-
+
|
|
48
|
+
+ 鸿蒙平台在HBuilderX 5.26+ 支持在manifest中配置。低版本需在原生工程的 json5 中配置
|
|
49
49
|
- App平台可通过以下方法配置使用 applink(通用链接) 启动应用,打包后生效
|
|
50
50
|
+ Android平台暂未支持 applink(通用链接)
|
|
51
51
|
+ iOS平台需先在 `manifest.json` 的可视化界面配置[关联域(Associated Domains)](../collocation/manifest-ios.md#associateddomains),再在服务器配置`apple-app-site-association`,完整教程参考[iOS通用链接配置教程](https://uniapp.dcloud.net.cn/tutorial/app-ios-capabilities.html#%E9%80%9A%E7%94%A8%E9%93%BE%E6%8E%A5-universal-link)
|
|
52
|
-
+
|
|
52
|
+
+ 鸿蒙平台在HBuilderX 5.26+ 支持在manifest中配置。低版本需在原生工程的 json5 中配置
|
|
53
53
|
- 如开发App页面直达功能,需先配置 scheme(deeplink) 或 applink(通用链接) 启动应用,在应用的 `onShow` 生命周期获取启动并解析appScheme或appLink参数,然后自行写 [uni.navigatorTo](../api/navigator.md#navigateto) 等路由API跳转页面。 `onShow` 生命周期的好处是不管首页启动还是后台激活到前台都触发,当然如果是初次启动,仍然会先打开App的首页再执行开发者编写的路由代码。
|
|
54
54
|
- Web的页面直达无需使用scheme或通用链接,所有页面地址都可以直接在地址栏访问。
|
|
55
55
|
|
|
@@ -97,7 +97,7 @@
|
|
|
97
97
|
|
|
98
98
|
无法监听异步逻辑(例如:`setTimeout`)中的错误和应用初始化之前、 App 崩溃等错误。
|
|
99
99
|
|
|
100
|
-
onError
|
|
100
|
+
onError里打印的错误,是拦截转发的。可能会丢失错误堆栈,导致无法精准定位问题所在代码行号。真机运行时尽量避免全局监听onError。
|
|
101
101
|
|
|
102
102
|
:::
|
|
103
103
|
<!-- VUEJSON.application.onError.compatibility -->
|
|
@@ -175,7 +175,12 @@ onError里打印的错误,是拦截转发的。可能会丢失错误堆栈,
|
|
|
175
175
|
|
|
176
176
|
> HBuilderX 3.99+
|
|
177
177
|
|
|
178
|
-
小程序有 globalData,这是一种简单的全局变量机制。这套机制在 uni-app
|
|
178
|
+
小程序有 globalData,这是一种简单的全局变量机制。这套机制在 uni-app x 里也可以使用。
|
|
179
|
+
|
|
180
|
+
globalData依赖于vue和js环境,在页面里都使用,但在uts插件中使用有限制:
|
|
181
|
+
|
|
182
|
+
- VDOM模式:仅 `iOS uts 插件` 环境不支持。
|
|
183
|
+
- 蒸汽模式:Android和iOS的uts插件环境均不支持,鸿蒙在页面script驱动为ArkTS时,uts插件可以globalData,但页面script驱动为jsvm时,uts插件也不能使用globalData
|
|
179
184
|
|
|
180
185
|
**以下是 App.uvue 中定义globalData的相关配置:**
|
|
181
186
|
|
|
@@ -244,7 +249,7 @@ onError里打印的错误,是拦截转发的。可能会丢失错误堆栈,
|
|
|
244
249
|
|
|
245
250
|
::: warning 注意
|
|
246
251
|
- `uni-app x` 中 `globalData` 的数据结构与类型通过 `App.uvue` 中的 `globalData` 初始值定义,后续只能读取或修改,不能新增或删除。
|
|
247
|
-
- 在组合式 API App.uvue 中使用 `globalData` 时,无法像选项式 API 那样通过 `this.globalData` 访问,而是需要通过 `getApp().globalData` 访问。但部分生命周期中 App
|
|
252
|
+
- 在组合式 API App.uvue 中使用 `globalData` 时,无法像选项式 API 那样通过 `this.globalData` 访问,而是需要通过 `getApp().globalData` 访问。但部分生命周期中 App 实例可能还未初始化,需要注意时机问题。
|
|
248
253
|
:::
|
|
249
254
|
|
|
250
255
|
globalData是简单的全局变量,其他状态管理方式,可参考文档[全局变量和状态管理](../tutorial/store.md)。
|
|
@@ -125,7 +125,7 @@ uni-app x 的 app-android 平台,启动界面有以下策略:
|
|
|
125
125
|
- 启动图片
|
|
126
126
|
- Google SplashScreen
|
|
127
127
|
|
|
128
|
-
### 启动图配置 @
|
|
128
|
+
### 启动图配置 @splascreendefault
|
|
129
129
|
|
|
130
130
|
打开项目的manifest.json文件,在可视化界面中配置各分辨率启动图:
|
|
131
131
|
|
|
@@ -170,7 +170,7 @@ Android Studio 已经集成 .9.png 图片编辑工具,使用详情可参考 An
|
|
|
170
170
|
|
|
171
171
|
可以参考开发者在[插件市场](https://ext.dcloud.net.cn/search?q=.9)做好的.9样例工程
|
|
172
172
|
|
|
173
|
-
### Google SplashScreen配置 @
|
|
173
|
+
### Google SplashScreen配置 @splashscreenandroid12
|
|
174
174
|
|
|
175
175
|
Android 12(API 31)开始强制开启 [SplashScreen](https://developer.android.google.cn/guide/topics/ui/splash-screen?hl=zh-cn) 。
|
|
176
176
|
|
|
@@ -270,7 +270,7 @@ HBuilderX4.75及以上版本,如果没有配置启动图,配置启动界面
|
|
|
270
270
|
+ 配置Android 12应用启动界面后仅影响Android 12及以上版本应用启动界面,Android 12以下版本依然使用启动图展示splash
|
|
271
271
|
+ Android 12启动界面中部logo图标在部分系统设备会被裁剪成圆形,部分设备不会裁剪,需要注意圆形logo适配
|
|
272
272
|
|
|
273
|
-
### 不同Splash方式的选择参考 @
|
|
273
|
+
### 不同Splash方式的选择参考 @splashscreenselect
|
|
274
274
|
|
|
275
275
|
Splash是因为主界面渲染慢,给用户一个等待过渡。但注意复杂的Splash,也一样会影响启动速度。
|
|
276
276
|
|
|
@@ -297,7 +297,7 @@ Splash是因为主界面渲染慢,给用户一个等待过渡。但注意复
|
|
|
297
297
|
|
|
298
298
|
uni-app js引擎版的Android App启动时那个默认的logo转圈效果,其实不是splash,是应用启动后原生view绘制的一个动画。所以点击桌面应用图标后界面不会立即有反应。这个设计影响启动速度,在uni-app x上被废弃了。
|
|
299
299
|
|
|
300
|
-
### Android平台splash关闭时机 @
|
|
300
|
+
### Android平台splash关闭时机 @splashscreenclose
|
|
301
301
|
|
|
302
302
|
splash默认是在首页onShow时关闭。但可配置,打开项目的manifest.json文件,选择源码视图,在app->splashScreen节点下设置autoClose值域,控制splash关闭时机,默认onShow。
|
|
303
303
|
|
|
@@ -342,7 +342,7 @@ onReady触发时机要比onShow晚一些。
|
|
|
342
342
|
- splash关闭后才显示开屏广告
|
|
343
343
|
:::
|
|
344
344
|
|
|
345
|
-
### 不同启动方式对splash的影响 @
|
|
345
|
+
### 不同启动方式对splash的影响 @splashscreenstart
|
|
346
346
|
|
|
347
347
|
应用的启动有冷启动、温启动、切换到前台,这三种方式splash展示时间是有区别的。
|
|
348
348
|
|
|
@@ -396,13 +396,13 @@ onReady触发时机要比onShow晚一些。
|
|
|
396
396
|
```
|
|
397
397
|
|
|
398
398
|
|
|
399
|
-
### uni-location(定位) @
|
|
399
|
+
### uni-location(定位) @moduleslocation
|
|
400
400
|
|
|
401
401
|
定位相关功能使用 [provider机制](../api/provider.md) 实现,uni-app x 项目中使用 [uni.getLocation](../api/get-location.md),[uni.onLocationChange](../api/location-change.md#onlocationchange),[uni.offLocationChange](../api/location-change.md#offlocationchange) 等API时依赖此模块。
|
|
402
402
|
|
|
403
403
|
支持以下定位 provider :
|
|
404
404
|
|
|
405
|
-
#### 系统定位 @
|
|
405
|
+
#### 系统定位 @locationsystem
|
|
406
406
|
使用系统自带定位功能,由ROM系统实现。使用此模块,需在manifest.json中配置:
|
|
407
407
|
|
|
408
408
|
- HBuilderX 4.71 及以上版本
|
|
@@ -440,10 +440,10 @@ onReady触发时机要比onShow晚一些。
|
|
|
440
440
|
}
|
|
441
441
|
```
|
|
442
442
|
|
|
443
|
-
#### 腾讯定位 @
|
|
443
|
+
#### 腾讯定位 @locationtencent
|
|
444
444
|
使用 [腾讯位置服务](https://lbs.qq.com/) 的 “Android定位SDK” 实现,使用前需申请Key。
|
|
445
445
|
|
|
446
|
-
> 同时使用 [腾讯地图](#
|
|
446
|
+
> 同时使用 [腾讯地图](#maptencent) 时,要求使用相同的Key
|
|
447
447
|
|
|
448
448
|
使用此模块,需在manifest.json中配置:
|
|
449
449
|
|
|
@@ -505,17 +505,17 @@ onReady触发时机要比onShow晚一些。
|
|
|
505
505
|
```
|
|
506
506
|
|
|
507
507
|
|
|
508
|
-
### uni-map(地图) @
|
|
508
|
+
### uni-map(地图) @modulesmap
|
|
509
509
|
|
|
510
510
|
uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocation](../api/choose-location.md) API时依赖此模块。
|
|
511
511
|
|
|
512
512
|
地图是商业服务,授权较贵,如需购买,请点击[获取优惠](https://ask.dcloud.net.cn/explore/map/)。
|
|
513
513
|
|
|
514
|
-
#### 腾讯地图 @
|
|
514
|
+
#### 腾讯地图 @maptencent
|
|
515
515
|
|
|
516
516
|
使用 [腾讯位置服务](https://lbs.qq.com/) 的 “Android地图SDK” 实现,使用前需申请Key,并在腾讯后台申请 Key 界面勾选“SDK”。
|
|
517
517
|
|
|
518
|
-
> 同时使用 [腾讯定位](#
|
|
518
|
+
> 同时使用 [腾讯定位](#locationtencent) 时,要求使用相同的Key
|
|
519
519
|
|
|
520
520
|
使用此模块,需在manifest.json中配置:
|
|
521
521
|
|
|
@@ -577,13 +577,13 @@ uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocatio
|
|
|
577
577
|
```
|
|
578
578
|
|
|
579
579
|
|
|
580
|
-
### uni-payment(支付) @
|
|
580
|
+
### uni-payment(支付) @modulespayment
|
|
581
581
|
|
|
582
582
|
请求支付功能使用 [provider机制](../api/provider.md) 实现,uni-app x 项目中使用 [uni.requestPayment](../api/request-payment.md) API时依赖此模块。
|
|
583
583
|
|
|
584
584
|
支持以下支付 provider :
|
|
585
585
|
|
|
586
|
-
#### 支付宝支付 @
|
|
586
|
+
#### 支付宝支付 @paymentalipay
|
|
587
587
|
使用 “App支付宝客户端SDK” 实现。使用此模块,需在manifest.json中配置:
|
|
588
588
|
|
|
589
589
|
- HBuilderX 4.71 及以上版本
|
|
@@ -622,7 +622,7 @@ uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocatio
|
|
|
622
622
|
```
|
|
623
623
|
|
|
624
624
|
|
|
625
|
-
#### 微信支付 @
|
|
625
|
+
#### 微信支付 @paymentweixin
|
|
626
626
|
使用 “微信 Open SDK for Android” 实现,使用前需到[微信开放平台](https://open.weixin.qq.com/)创建移动应用并在开发配置中正确配置`Android应用`的包名和签名。
|
|
627
627
|
|
|
628
628
|
在uni-app x项目中使用此模块,需在manifest.json中配置:
|
|
@@ -206,13 +206,13 @@ iOS平台在iPad设备默认是支持`多任务处理`的,即支持悬浮窗
|
|
|
206
206
|
- 注意:根据apple审核要求,支持任何三方登录,必须同时支持Apple 登录功能,否则审核失败; 具体请参考[Apple App Review Guidelines - Login Services说明](https://developer.apple.com/app-store/review/guidelines/#design)
|
|
207
207
|
|
|
208
208
|
|
|
209
|
-
### uni-location(定位) @
|
|
209
|
+
### uni-location(定位) @moduleslocation
|
|
210
210
|
|
|
211
211
|
定位相关功能使用 [provider机制](../api/provider.md) 实现,uni-app x 项目中使用 [uni.getLocation](../api/get-location.md),[uni.onLocationChange](../api/location-change.md#onlocationchange),[uni.offLocationChange](../api/location-change.md#offlocationchange) 等API时依赖此模块。
|
|
212
212
|
|
|
213
213
|
支持以下定位 provider :
|
|
214
214
|
|
|
215
|
-
#### 系统定位 @
|
|
215
|
+
#### 系统定位 @locationsystem
|
|
216
216
|
使用系统自带定位功能,由苹果iOS系统实现
|
|
217
217
|
|
|
218
218
|
使用此模块,需在manifest.json中配置:
|
|
@@ -253,11 +253,11 @@ iOS平台在iPad设备默认是支持`多任务处理`的,即支持悬浮窗
|
|
|
253
253
|
```
|
|
254
254
|
|
|
255
255
|
|
|
256
|
-
#### 腾讯定位 @
|
|
256
|
+
#### 腾讯定位 @locationtencent
|
|
257
257
|
|
|
258
258
|
使用 [腾讯位置服务](https://lbs.qq.com/) 的 “iOS定位SDK” 实现,使用前需申请Key。
|
|
259
259
|
|
|
260
|
-
> 同时使用 [腾讯地图](#
|
|
260
|
+
> 同时使用 [腾讯地图](#maptencent) 时,要求使用相同的Key
|
|
261
261
|
|
|
262
262
|
使用此模块,需在manifest.json中配置:
|
|
263
263
|
|
|
@@ -337,17 +337,17 @@ iOS平台在iPad设备默认是支持`多任务处理`的,即支持悬浮窗
|
|
|
337
337
|
</plist>
|
|
338
338
|
```
|
|
339
339
|
|
|
340
|
-
### uni-map(地图) @
|
|
340
|
+
### uni-map(地图) @modulesmap
|
|
341
341
|
|
|
342
342
|
uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocation](../api/choose-location.md) API时依赖此模块。
|
|
343
343
|
|
|
344
344
|
地图是商业服务,授权较贵,如需购买,请点击[获取优惠](https://ask.dcloud.net.cn/explore/map/)。
|
|
345
345
|
|
|
346
|
-
#### 腾讯地图 @
|
|
346
|
+
#### 腾讯地图 @maptencent
|
|
347
347
|
|
|
348
348
|
使用 [腾讯位置服务](https://lbs.qq.com/) 的 “iOS地图SDK” 实现,使用前需申请Key,并在腾讯后台申请 Key 界面勾选“SDK”。
|
|
349
349
|
|
|
350
|
-
> 同时使用 [腾讯定位](#
|
|
350
|
+
> 同时使用 [腾讯定位](#locationtencent) 时,要求使用相同的Key
|
|
351
351
|
|
|
352
352
|
使用此模块,需在manifest.json中配置:
|
|
353
353
|
|
|
@@ -406,13 +406,13 @@ uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocatio
|
|
|
406
406
|
```
|
|
407
407
|
|
|
408
408
|
|
|
409
|
-
### uni-payment(支付) @
|
|
409
|
+
### uni-payment(支付) @modulespayment
|
|
410
410
|
|
|
411
411
|
请求支付功能使用 [provider机制](../api/provider.md) 实现,uni-app x 项目中使用 [uni.requestPayment](../api/request-payment.md) API时依赖此模块。
|
|
412
412
|
|
|
413
413
|
支持以下支付 provider :
|
|
414
414
|
|
|
415
|
-
#### 支付宝支付 @
|
|
415
|
+
#### 支付宝支付 @paymentalipay
|
|
416
416
|
使用 “App支付宝客户端SDK” 实现。使用此模块,需在manifest.json中配置:
|
|
417
417
|
|
|
418
418
|
- HBuilderX 4.71 及以上版本
|
|
@@ -451,7 +451,7 @@ uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocatio
|
|
|
451
451
|
```
|
|
452
452
|
|
|
453
453
|
|
|
454
|
-
#### 微信支付 @
|
|
454
|
+
#### 微信支付 @paymentweixin
|
|
455
455
|
使用 “微信 Open SDK for iOS” 实现,使用前需到[微信开放平台](https://open.weixin.qq.com/)创建移动应用并在开发配置中正确配置`iOS应用`的 Bundle ID 和 Universal Links。
|
|
456
456
|
在uni-app x项目中使用此模块,需在manifest.json中配置:
|
|
457
457
|
|
|
@@ -564,7 +564,7 @@ uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocatio
|
|
|
564
564
|
|
|
565
565
|
|
|
566
566
|
|
|
567
|
-
## URL Schemes @
|
|
567
|
+
## URL Schemes @urlschemes
|
|
568
568
|
|
|
569
569
|
> HBuilderX 4.71 及以上版本支持可视化配置URL Schemes。
|
|
570
570
|
> HBuilderX 4.71 以下版本未提供 url scheme 配置,需在 app 原生应用配置文件中进行设置,详情参考:[iOS平台 URL Scheme 配置](https://uniapp.dcloud.net.cn/tutorial/app-nativeresource-ios.html#urlscheme)。
|
|
@@ -579,7 +579,7 @@ uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocatio
|
|
|
579
579
|
标准基座可通过此网页体验 Url Scheme 启动 App:[https://uniappx.dcloud.net.cn/scheme.html](https://uniappx.dcloud.net.cn/scheme.html)
|
|
580
580
|
|
|
581
581
|
|
|
582
|
-
## 关联域(Associated Domains) @
|
|
582
|
+
## 关联域(Associated Domains) @associateddomains
|
|
583
583
|
|
|
584
584
|
关联域(Associated Domains)是配置应用通用链接的前置条件,需将通用链接的域名加“applinks:”前缀配置为关联域。如应用需设置通用链接值“https://uniappx.dcloud.net.cn/ulinks”,其域名为“uniappx.dcloud.net.cn”,对应的关联域值则为“applinks:uniappx.dcloud.net.cn”。
|
|
585
585
|
|
|
@@ -610,7 +610,7 @@ uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocatio
|
|
|
610
610
|
- 配置 应用访问白名单 需提交云端打包才能生效
|
|
611
611
|
|
|
612
612
|
|
|
613
|
-
## 后台运行能力 @
|
|
613
|
+
## 后台运行能力 @backgroundmodes
|
|
614
614
|
|
|
615
615
|
声明应用在后台(App 进入后台或被挂起时)需要继续执行的任务类型。向系统申请特定的后台运行权限,确保应用在后台仍能完成必要操作(如播放音乐、获取位置更新等)。
|
|
616
616
|
|
|
@@ -624,7 +624,7 @@ uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocatio
|
|
|
624
624
|
- 配置 后台运行能力 需提交云端打包才能生效
|
|
625
625
|
|
|
626
626
|
|
|
627
|
-
## 隐私信息访问的许可描述 @
|
|
627
|
+
## 隐私信息访问的许可描述 @usagedescription
|
|
628
628
|
|
|
629
629
|
`隐私信息访问的许可描述`向用户解释应用为何需要访问敏感数据或功能(如相机、相册、位置等),这些描述会在系统首次请求权限时展示给用户,直接影响用户是否授权。
|
|
630
630
|
|
|
@@ -646,7 +646,7 @@ uni-app x 项目中使用 [map](../component/map.md) 组件,[uni.chooseLocatio
|
|
|
646
646
|
- 配置 隐私信息访问的许可描述 需提交云端打包才能生效
|
|
647
647
|
|
|
648
648
|
|
|
649
|
-
## TargetName @
|
|
649
|
+
## TargetName @targetname
|
|
650
650
|
|
|
651
651
|
>HBuilder4.34版本新增支持
|
|
652
652
|
|
|
@@ -671,7 +671,7 @@ iOS平台配置应用构建目标(Target)的标识名称,自定义基座
|
|
|
671
671
|
|
|
672
672
|
>HBuilder4.34版本新增支持
|
|
673
673
|
|
|
674
|
-
iOS平台配置应用内部名称,默认值为[TargetName](#
|
|
674
|
+
iOS平台配置应用内部名称,默认值为[TargetName](#targetname),最多支持15个字符,详细说明参考[苹果官方文档](https://developer.apple.com/documentation/bundleresources/information-property-list/cfbundlename)。
|
|
675
675
|
|
|
676
676
|
如需更改应用内部名称,可在项目 manifest.json 文件的 "app-ios" -> "distribute" 节点配置 CFBundleName,如下示例将应用内部名称修改为“MyApp”:
|
|
677
677
|
```json
|
|
@@ -712,6 +712,7 @@ iOS平台配置应用在iPad设置是否能够与其他应用程序共享屏幕
|
|
|
712
712
|
## Minimum Deployment(DeploymentTarget) @deploymenttarget
|
|
713
713
|
|
|
714
714
|
>HBuilder5.25版本新增支持
|
|
715
|
+
>HBuilderX5.24版本云端打包2026年9月11更新支持
|
|
715
716
|
|
|
716
717
|
Minimum Deployment(DeploymentTarget)设置应用能安装的最低 iOS 系统版本,从HBuilderX5.25开始默认为 15.0。
|
|
717
718
|
|
|
@@ -331,8 +331,8 @@ app平台默认`启动界面`为白色(暗黑模式下为黑色),为了避
|
|
|
331
331
|
|
|
332
332
|
uni-app x 项目中 uni-oauth 基于 [provider](../api/provider.md) 机制实现。
|
|
333
333
|
需在 `manifest.json` 中手动配置三方登录服务供应商:
|
|
334
|
-
- [Android平台](manifest-android.md#
|
|
335
|
-
- [iOS平台](manifest-ios.md#
|
|
334
|
+
- [Android平台](manifest-android.md#modulesoauth)
|
|
335
|
+
- [iOS平台](manifest-ios.md#modulesoauth)
|
|
336
336
|
|
|
337
337
|
**注意**
|
|
338
338
|
- 标准基座已包含 `微信登录`
|
|
@@ -344,8 +344,8 @@ uni-app x 项目中 uni-oauth 基于 [provider](../api/provider.md) 机制实现
|
|
|
344
344
|
|
|
345
345
|
uni-app x 项目中 uni-share 基于 [provider](../api/provider.md) 机制实现。
|
|
346
346
|
需在 `manifest.json` 中手动配置三方分享服务供应商:
|
|
347
|
-
- [Android平台](manifest-android.md#
|
|
348
|
-
- [iOS平台](manifest-ios.md#
|
|
347
|
+
- [Android平台](manifest-android.md#modulesshare)
|
|
348
|
+
- [iOS平台](manifest-ios.md#modulesshare)
|
|
349
349
|
|
|
350
350
|
**注意**
|
|
351
351
|
- 标准基座已包含 `微信分享`
|
|
@@ -358,8 +358,8 @@ uni-app x 项目中 uni-share 基于 [provider](../api/provider.md) 机制实现
|
|
|
358
358
|
|
|
359
359
|
uni-app x 项目中 uni-payment 基于 [provider](../api/provider.md) 机制实现。
|
|
360
360
|
需在 `manifest.json` 中手动配置三方支付服务供应商:
|
|
361
|
-
- [Android平台](manifest-android.md#
|
|
362
|
-
- [iOS平台](manifest-ios.md#
|
|
361
|
+
- [Android平台](manifest-android.md#modulespayment)
|
|
362
|
+
- [iOS平台](manifest-ios.md#modulespayment)
|
|
363
363
|
|
|
364
364
|
**注意**
|
|
365
365
|
- 标准基座已包含 `微信支付`、`支付宝支付`
|
|
@@ -372,8 +372,8 @@ uni-app x 项目中 uni-payment 基于 [provider](../api/provider.md) 机制实
|
|
|
372
372
|
|
|
373
373
|
uni-app x 项目中 uni-location 基于 [provider](../api/provider.md) 机制实现。
|
|
374
374
|
需在 `manifest.json` 中手动配置三方定位服务供应商:
|
|
375
|
-
- [Android平台](manifest-android.md#
|
|
376
|
-
- [iOS平台](manifest-ios.md#
|
|
375
|
+
- [Android平台](manifest-android.md#moduleslocation)
|
|
376
|
+
- [iOS平台](manifest-ios.md#moduleslocation)
|
|
377
377
|
|
|
378
378
|
**注意**
|
|
379
379
|
- 标准基座已包含 `系统定位`、`腾讯定位`
|
|
@@ -388,8 +388,8 @@ uni-app x 项目中 uni-location 基于 [provider](../api/provider.md) 机制实
|
|
|
388
388
|
|
|
389
389
|
使用腾讯地图需到 [腾讯位置服务](https://lbs.qq.com/) 官网申请TencentLBSAPIKey,并配置到应用中。
|
|
390
390
|
|
|
391
|
-
- [Android平台](manifest-android.md#
|
|
392
|
-
- [iOS平台](manifest-ios.md#
|
|
391
|
+
- [Android平台](manifest-android.md#maptencent)
|
|
392
|
+
- [iOS平台](manifest-ios.md#maptencent)
|
|
393
393
|
|
|
394
394
|
#### Harmony平台配置腾讯地图Key @uni-map-tencent-harmony-key
|
|
395
395
|
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
|高德 |√ |√ |√ |x |
|
|
16
16
|
|Google |√ |x |x |x |
|
|
17
17
|
|
|
18
|
-
App标准基座里地图是腾讯地图,如需高德地图版本,请在插件市场单独安装,需要自定义基座运行:[官方高德地图插件](https://ext.dcloud.net.cn/plugin?id=25947)。该插件基于独立的 `<amap>`
|
|
18
|
+
App标准基座里地图是腾讯地图,如需高德地图版本,请在插件市场单独安装,需要自定义基座运行:[官方高德地图插件](https://ext.dcloud.net.cn/plugin?id=25947)。该插件基于独立的 `<amap>` 组件实现,Android平台与内置 map 组件存在功能差异:属性、事件、上下文 API 均为内置 map 的子集;iOS平台自`1.3.0`起和内置map组件功能一致;Harmony 平台暂不支持,详见[高德地图插件功能差异](#amap)。
|
|
19
19
|
|
|
20
20
|
除了内置支持的图商,还可以在插件市场寻找更多地图解决方案:
|
|
21
21
|
1. [插件市场的三方地图插件](https://ext.dcloud.net.cn/search?q=%E5%9C%B0%E5%9B%BE&orderBy=Relevance&uni-appx=1)
|
|
@@ -66,8 +66,8 @@ GS粤(2023)1171号
|
|
|
66
66
|
|
|
67
67
|
app平台目前还没有可视化界面,采用摇树机制,即调用地图相关api才会把地图组件编译到基座中,Map Key配置方式如下:
|
|
68
68
|
|
|
69
|
-
- iOS平台:需要在info.plist中配置对应的Key,参考[iOS平台配置腾讯地图Key](../collocation/manifest-ios.html#
|
|
70
|
-
- Android平台:需要在AndroidManifest.xml配置Key, 参考[Android平台配置腾讯地图Key](../collocation/manifest-android.html#
|
|
69
|
+
- iOS平台:需要在info.plist中配置对应的Key,参考[iOS平台配置腾讯地图Key](../collocation/manifest-ios.html#maptencent)
|
|
70
|
+
- Android平台:需要在AndroidManifest.xml配置Key, 参考[Android平台配置腾讯地图Key](../collocation/manifest-android.html#maptencent)
|
|
71
71
|
- Harmony平台:需要在`/harmony-configs/entry/src/main/module.json5`的metadata属性内配置Key,同时 manifest.json 内还需要配置 app.distribute.modules.uni-map 参考[Harmony平台配置腾讯地图Key](../collocation/manifest-harmony.html#uni-map-tencent)
|
|
72
72
|
|
|
73
73
|
### 高德地图@amap
|
|
@@ -80,11 +80,13 @@ App平台的高德地图由插件市场 [官方高德地图插件 uni-map-amap](
|
|
|
80
80
|
| :- | :-: | :-: |
|
|
81
81
|
| 基础属性:longitude、latitude、scale、theme、min-scale、max-scale、layer-style、show-location、enable-satellite、enable-traffic | √ | √ |
|
|
82
82
|
| markers 标记点 | √ | √ |
|
|
83
|
-
| 覆盖物属性:polyline、polygons、circles、controls、include-points | √ | x |
|
|
84
|
-
| 手势视角属性:enable-3D、show-compass、enable-zoom、enable-scroll、enable-rotate、rotate、skew、enable-overlooking | √ | x |
|
|
85
|
-
| 显示控制属性:enable-poi、enable-building、enable-indoorMap | √ | x |
|
|
86
|
-
| 事件:@markertap、@controltap、@regionchange、@updated、@tap、@anchorpointtap、@poitap | √ | x |
|
|
87
|
-
| 上下文 API
|
|
83
|
+
| 覆盖物属性:polyline、polygons、circles、controls、include-points | √ | Android:x;iOS:1.3.0+ |
|
|
84
|
+
| 手势视角属性:enable-3D、show-compass、enable-zoom、enable-scroll、enable-rotate、rotate、skew、enable-overlooking | √ | Android:x;iOS:1.3.0+ |
|
|
85
|
+
| 显示控制属性:enable-poi、enable-building、enable-indoorMap | √ | Android:x;iOS:1.3.0+ |
|
|
86
|
+
| 事件:@markertap、@controltap、@regionchange、@updated、@tap、@anchorpointtap、@poitap | √ | Android:x;iOS:1.3.0+ |
|
|
87
|
+
| 上下文 API:`uni.createAmapContext` 及已实现的上下文方法 | √ | Android:x;iOS:1.3.0+ |
|
|
88
|
+
|
|
89
|
+
其中,iOS 1.3.0 的上下文 API 支持 `getCenterLocation`、`moveToLocation`、`translateMarker`、`includePoints`、`getRegion`、`getScale`、`addMarkers`、`removeMarkers`、`moveAlong`、`addGroundOverlay`、`updateGroundOverlay`、`removeGroundOverlay`。高德插件使用 `uni.createAmapContext(mapId, component)`,与内置腾讯地图的 `uni.createMapContext(mapId)` 不同。
|
|
88
90
|
|
|
89
91
|
完整差异明细、插件版本支持情况及 API Key 配置说明,详见插件市场 [uni-map-amap 插件文档](https://ext.dcloud.net.cn/plugin?id=25947)。
|
|
90
92
|
|
|
@@ -53,15 +53,20 @@
|
|
|
53
53
|
|
|
54
54
|
### app平台组件实现
|
|
55
55
|
|
|
56
|
-
#### HBuilderX5.08及以上版本
|
|
57
|
-
App-Android
|
|
58
|
-
App-iOS
|
|
56
|
+
#### HBuilderX5.08及以上版本
|
|
57
|
+
- App-Android平台 使用 Google ExoPlayer 库实现,不再支持 codec、play-strategy 属性
|
|
58
|
+
- App-iOS平台 使用iOS系统自带的AVPlayer 实现,不再支持 codec、play-strategy 属性
|
|
59
|
+
- App-Harmony平台 使用系统video实现
|
|
60
|
+
|
|
61
|
+
新版本放弃ijkplayer,主要原因是该库原作者已不维护。使用系统的video虽然会损失一些功能,如下:
|
|
59
62
|
|
|
60
63
|
> 不再支持流媒体 rtmp/rtsp,仅支持hls协议
|
|
61
64
|
> 不再支持flv视频格式
|
|
62
65
|
|
|
66
|
+
但系统video的性能、质量和包体积占用更有优势。
|
|
63
67
|
|
|
64
68
|
#### HBuilderX5.08以下版本
|
|
69
|
+
|
|
65
70
|
App-Android/iOS平台video组件使用ijkplayer库实现:[https://github.com/bilibili/ijkplayer](https://github.com/bilibili/ijkplayer);
|
|
66
71
|
|
|
67
72
|
弹幕功能使用DanmakuFlameMaster库实现:[https://github.com/bilibili/DanmakuFlameMaster](https://github.com/bilibili/DanmakuFlameMaster)
|
|
@@ -70,7 +75,6 @@ ijkplayer库底层又使用了ffmpeg,这些库的功能较多,官方的video
|
|
|
70
75
|
|
|
71
76
|
video组件的源码[详见](https://gitcode.com/dcloud/uni-component/tree/master/uni_modules/uni-video)。下载该uni_modules到工程下,修改源码打包,可覆盖内置的video组件。
|
|
72
77
|
|
|
73
|
-
另外ijkplayer作为一个开源库,比腾讯视频等商业sdk仍有差距。如无法在开源库上满足需求,可在插件市场寻找其他插件:见插件市场[视频播放](https://ext.dcloud.net.cn/search?q=%E8%A7%86%E9%A2%91%E6%92%AD%E6%94%BE&orderBy=Relevance&uni-appx=1)
|
|
74
78
|
|
|
75
79
|
<!-- UTSCOMJSON.video.children -->
|
|
76
80
|
|
|
@@ -33,11 +33,15 @@ CSS自定义变量规范参考[MDN Reference](https://developer.mozilla.org/zh-C
|
|
|
33
33
|
App平台相比web平台,有以下差异:
|
|
34
34
|
- 定义变量时不支持值为var(--*) ex: --color: var(--color)
|
|
35
35
|
- 回退值不支持var(--*) ex: --height: var(--height1 , var(--height2))
|
|
36
|
-
- App
|
|
37
|
-
- App平台 VDOM模式的部分组件的样式不支持CSS变量:input、textarea 的 placeholder-style、placeholder-class;picker-view 的 indicator-style、indicator-class、mask-style、mask-class。
|
|
38
|
-
- 蒸汽模式的部分组件使用了useComputedStyle,这类组件的样式支持CSS变量需HBuilderX 5.25+,包括input、textarea、loading组件的class。
|
|
36
|
+
- App平台蒸汽模式的部分组件使用了useComputedStyle,这类组件的样式支持CSS变量需HBuilderX 5.25+,包括input、textarea、loading组件的class。
|
|
39
37
|
- App平台不支持:root伪类。蒸汽模式可以使用page选择器替代。vdom模式需要自行在页面根元素或合适的父级元素的class中定义css变量,以便在子元素生效。
|
|
40
38
|
|
|
39
|
+
App平台 VDOM模式注意事项:
|
|
40
|
+
- App平台 VDOM模式简写属性(如padding、margin等)不支持使用var,比如:--padding: 10px 20px; padding: var(--padding);。需展开后使用,比如展开成padding-left。
|
|
41
|
+
- App平台 VDOM模式transtion暂不支持使用var。App平台 蒸汽模式仅transtion长写属性支持var
|
|
42
|
+
- App平台 VDOM模式的部分组件的样式不支持CSS变量:input、textarea 的 placeholder-style、placeholder-class;picker-view 的 indicator-style、indicator-class、mask-style、mask-class。
|
|
43
|
+
|
|
44
|
+
|
|
41
45
|
<!-- CSSJSON.variables_values.example -->
|
|
42
46
|
|
|
43
47
|
## env @env
|
|
@@ -114,7 +118,7 @@ web平台的 CSS环境变量规范参考[MDN Reference](https://developer.mozill
|
|
|
114
118
|
|
|
115
119
|
|
|
116
120
|
## calc @calc
|
|
117
|
-
> uni-app x 5.
|
|
121
|
+
> uni-app x 5.31+ App平台 蒸汽模式支持calc方法
|
|
118
122
|
|
|
119
123
|
calc() 函数允许在声明 CSS 属性值时执行计算。
|
|
120
124
|
|
|
@@ -43,6 +43,8 @@
|
|
|
43
43
|
以上代码示例,当我们把 `rowDesc` 变量从 `row-desc1` 变为 `row-desc2` 时,会更新 `text` 节点样式,但是如果把 `docBody` 变量从 `doc-body1` 变为 `doc-body2`,是不会更新 `text` 节点样式的。\
|
|
44
44
|
因为 `doc-body` 不是最后一个选择器,非末尾的选择器变更有可能影响很多 DOM 元素,从而影响到渲染性能。
|
|
45
45
|
|
|
46
|
+
<!-- EXAMPLEJSON.css.selector -->
|
|
47
|
+
|
|
46
48
|
::: warning 注意
|
|
47
49
|
App端相邻选择器暂不支持动态新增或删减节点,为了优化性能减少一些重新渲染工作,示例 [https://issues.dcloud.net.cn/pages/issues/detail?id=1452](https://issues.dcloud.net.cn/pages/issues/detail?id=1452)
|
|
48
50
|
:::
|