tmui-cli 2.0.6 → 5.3.2

package/data/uniappx/api/theme-change.md

@@ -273,9 +273,9 @@ uni-app x的内置组件，在App和Web平台均支持css设置所有样式，
 ::: sourceCode
 ## uni.setAppTheme(options) @setapptheme
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-theme
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-theme
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
 设置应用主题
 
@@ -289,46 +289,46 @@ uni.setAppTheme用于设置App当前主题。开发者仍需为不同主题定
 uni-app x的UI相关的API（比如showModal），也会响应setAppTheme。
 
 ### setAppTheme 兼容性  
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.18 | 4.18 | 4.71 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.18 | 4.18 | 4.71 |
 
 ### 参数 
 
 | 名称 | 类型 | 必填 | 兼容性 |
 | :- | :- | :- |  :-: |
-| options | **SetAppThemeOptions** | 是 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） |
+| options | **SetAppThemeOptions** | 是 | Web x / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） |
 | 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
 | :- | :- | :- | :- |  :-: | :- |
-| theme | string | 是 |  | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 主题 |
+| theme | string | 是 |  | Web x / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 主题 |
 @@| 合法值 | 兼容性 | 描述 |
 @@| :- |  :-: | :- |
-@@| light | Web x / 微信小程序 x（部分支持，见上） | 亮色模式 |
-@@| dark | Web x / 微信小程序 x（部分支持，见上） | 深色模式 |
-@@| auto | Web x / 微信小程序 x（部分支持，见上） | 跟随系统模式 |
-| success | (result: [SetAppThemeSuccessResult](#setappthemesuccessresult-values)) => void | 否 | null | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 接口调用成功的回调函数 |
-| fail | (result: [AppThemeFail](#appthemefail-values)) => void | 否 | null | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 接口调用失败的回调函数 |
-| complete | (result: any) => void | 否 | null | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+@@| "light" | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 亮色模式 |
+@@| "dark" | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 深色模式 |
+@@| "auto" | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 跟随系统模式 |
+| success | (result: [SetAppThemeSuccessResult](#setappthemesuccessresult-values)) => void | 否 | null | Web x / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 接口调用成功的回调函数 |
+| fail | (result: [AppThemeFail](#appthemefail-values)) => void | 否 | null | Web x / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null | Web x / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 接口调用结束的回调函数（调用成功、失败都会执行） | 
 
 #### SetAppThemeSuccessResult 的属性值 @setappthemesuccessresult-values 
 
 | 名称 | 类型 | 必备 | 兼容性 |
 | :- | :- | :- |  :-: |
-| theme | string | 是 | Web x / 微信小程序 x（部分支持，见上） |
+| theme | string | 是 | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） |
 
 #### AppThemeFail 的属性值 @appthemefail-values 
 
 | 名称 | 类型 | 必备 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| errCode | number | 是 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 错误码<br/>- 702001  参数错误<br/>- 2002000  未知错误 |
+| errCode | number | 是 | Web x / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 错误码<br/>- 702001  参数错误<br/>- 2002000  未知错误 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| 702001 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 参数错误 |
-| 2002000 | Web x / 微信小程序 x（部分支持，见上） | 未知错误 |
-| errSubject | string | 是 | Web x / 微信小程序 x（部分支持，见上） | 统一错误主题（模块）名称 |
-| data | any | 否 | Web x / 微信小程序 x（部分支持，见上） | 错误信息中包含的数据 |
+| 702001 | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 参数错误 |
+| 2002000 | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 未知错误 |
+| errSubject | string | 是 | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 统一错误主题（模块）名称 |
+| data | any | 否 | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 错误信息中包含的数据 |
 | cause | Error | 否 |   | 源错误信息，可以包含多个错误，详见SourceError |
-| errMsg | string | 是 | Web x / 微信小程序 x（部分支持，见上） |  |
+| errMsg | string | 是 | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） |  |
 
 ```uts
 uni.setAppTheme({
@@ -348,9 +348,9 @@ uni.setAppTheme({
 ::: sourceCode
 ## uni.onAppThemeChange(callback) @onappthemechange
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-theme
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-theme
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
 开启监听应用主题变化
 
@@ -359,25 +359,25 @@ uni.setAppTheme({
 - HBuilderX 4.19版本调整为：应用的light/dark主题真正发生变化时触发监听回调。无论是手动设置setAppTheme还是跟随osTheme变化，只要真正变化了就会触发本监听。回调参数中的 appTheme 值只能是"light" | "dark"。
 
 ### onAppThemeChange 兼容性  
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.18 | 4.18 | 4.71 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.18 | 4.18 | 4.71 |
 
 ### 参数 
 
 | 名称 | 类型 | 必填 | 兼容性 |
 | :- | :- | :- |  :-: |
-| callback | (res: [AppThemeChangeResult](#appthemechangeresult-values)) => void | 是 | Web x / 微信小程序 x（部分支持，见上） | 
+| callback | (res: [AppThemeChangeResult](#appthemechangeresult-values)) => void | 是 | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 
 
 ### AppThemeChangeResult 的属性值 @appthemechangeresult-values 
 
 | 名称 | 类型 | 必备 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| appTheme | string | 是 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 应用主题 |
+| appTheme | string | 是 | Web x / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 应用主题 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| light | Web x / 微信小程序 x（部分支持，见上） | 亮色模式 |
-| dark | Web x / 微信小程序 x（部分支持，见上） | 深色模式 |
+| "light" | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 亮色模式 |
+| "dark" | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 深色模式 |
 
 ### 返回值 
 
@@ -398,9 +398,9 @@ val callbackId = uni.onAppThemeChange((res: AppThemeChangeResult) => {
 ::: sourceCode
 ## uni.offAppThemeChange(id) @offappthemechange
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-theme
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-theme
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
 取消监听应用主题变化
 
@@ -431,32 +431,32 @@ uni.offAppThemeChange(this.appThemeChangeId)
 ::: sourceCode
 ## uni.onOsThemeChange(callback) @onosthemechange
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-theme
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-theme
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
 开启监听系统主题变化
 
 ### onOsThemeChange 兼容性  
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.18 | 4.18 | 4.71 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.18 | 4.18 | 4.71 |
 
 ### 参数 
 
 | 名称 | 类型 | 必填 | 兼容性 |
 | :- | :- | :- |  :-: |
-| callback | (res: [OsThemeChangeResult](#osthemechangeresult-values)) => void | 是 | Web x / 微信小程序 x（部分支持，见上） | 
+| callback | (res: [OsThemeChangeResult](#osthemechangeresult-values)) => void | 是 | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 
 
 ### OsThemeChangeResult 的属性值 @osthemechangeresult-values 
 
 | 名称 | 类型 | 必备 | 兼容性 | 描述 |
 | :- | :- | :- |  :-: | :- |
-| osTheme | string | 是 | Web x / 微信小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 系统主题 |
+| osTheme | string | 是 | Web x / 微信小程序 x / 支付宝小程序 x / Android 4.18 / iOS 4.18 / HarmonyOS 4.71（部分支持，见上） | 系统主题 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| light | Web x / 微信小程序 x（部分支持，见上） | 亮色模式 |
-| dark | Web x / 微信小程序 x（部分支持，见上） | 深色模式 |
+| "light" | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 亮色模式 |
+| "dark" | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） | 深色模式 |
 
 ### 返回值 
 
@@ -481,22 +481,22 @@ val callbackId = uni.onOsThemeChange((res: OsThemeChangeResult)=> {
 ::: sourceCode
 ## uni.offOsThemeChange(id) @offosthemechange
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-theme
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-theme
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
 取消监听系统主题变化
 
 ### offOsThemeChange 兼容性  
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.18 | 4.18 | 4.71 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.18 | 4.18 | 4.71 |
 
 ### 参数 
 
 | 名称 | 类型 | 必填 | 兼容性 |
 | :- | :- | :- |  :-: |
-| id | number | 是 | Web x / 微信小程序 x（部分支持，见上） |
+| id | number | 是 | Web x / 微信小程序 x / 支付宝小程序 x（部分支持，见上） |
 
 ```uts
 val callbackId = uni.onOsThemeChange((res: OsThemeChangeResult)=> {
@@ -514,16 +514,16 @@ uni.offOsThemeChange(callbackId)
 ::: sourceCode
 ## uni.onHostThemeChange(callback) @onhostthemechange
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-theme
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-theme
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
 监听宿主题状态变化。
 
 ### onHostThemeChange 兼容性  
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.35 | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.71 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.35 | 4.41 | 5.31 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.71 |
 
 ### 参数 
 
@@ -538,8 +538,8 @@ uni.offOsThemeChange(callbackId)
 | hostTheme | string | 是 | Android x / iOS x（部分支持，见上） | 主题名称 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| light | Android x / iOS x（部分支持，见上） | 亮色模式 |
-| dark | Android x / iOS x（部分支持，见上） | 深色模式 |
+| "light" | Android x / iOS x（部分支持，见上） | 亮色模式 |
+| "dark" | Android x / iOS x（部分支持，见上） | 深色模式 |
 
 ### 返回值 
 
@@ -565,16 +565,16 @@ uni.offOsThemeChange(callbackId)
 ::: sourceCode
 ## uni.offHostThemeChange(id) @offhostthemechange
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-theme
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-theme
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
 取消监听宿主题状态变化。
 
 ### offHostThemeChange 兼容性  
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.35 | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.71 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.35 | 4.41 | 5.31 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.71 |
 
 ### 参数 
 
@@ -600,16 +600,16 @@ uni.offOsThemeChange(callbackId)
 ::: sourceCode
 ## uni.~~onThemeChange(callback)~~ @onthemechange
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-theme
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-theme
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
 监听系统主题状态变化。  **已废弃，在web、小程序上推荐使用 onHostThemeChange**
 
 ### onThemeChange 兼容性  
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.71 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 5.31 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.71 |
 
 ### 参数 
 
@@ -624,8 +624,8 @@ uni.offOsThemeChange(callbackId)
 | theme | string | 是 | Android x / iOS x（部分支持，见上） | 主题名称 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| light | Android x / iOS x（部分支持，见上） | 亮色模式 |
-| dark | Android x / iOS x（部分支持，见上） | 深色模式 |
+| "light" | Android x / iOS x（部分支持，见上） | 亮色模式 |
+| "dark" | Android x / iOS x（部分支持，见上） | 深色模式 |
 
 ### 参见
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.ui.themeChange.onThemeChange)
@@ -645,16 +645,16 @@ uni.offOsThemeChange(callbackId)
 ::: sourceCode
 ## uni.~~offThemeChange(callback)~~ @offthemechange
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-theme
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-theme
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-theme
 
 取消监听系统主题状态变化。  **已废弃，在web、小程序上推荐使用 offHostThemeChange**
 
 ### offThemeChange 兼容性  
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | 4.41 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.71 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 5.31 | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | <a style="color:unset;" href="https://vote.dcloud.net.cn/#/?name=uni-app%20x">x</a> | 4.71 |
 
 ### 参数 
 
@@ -669,8 +669,8 @@ uni.offOsThemeChange(callbackId)
 | theme | string | 是 | Android x / iOS x（部分支持，见上） | 主题名称 |
 | 合法值 | 兼容性 | 描述 |
 | :- |  :-: | :- |
-| light | Android x / iOS x（部分支持，见上） | 亮色模式 |
-| dark | Android x / iOS x（部分支持，见上） | 深色模式 |
+| "light" | Android x / iOS x（部分支持，见上） | 亮色模式 |
+| "dark" | Android x / iOS x（部分支持，见上） | 深色模式 |
 
 ### 参见
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.ui.themeChange.offThemeChange)

package/data/uniappx/api/toast.md

@@ -1,16 +1,16 @@
 ::: sourceCode
 ## uni.showToast(options) @showtoast
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-prompt
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-prompt
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-prompt
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-prompt
 
 显示消息提示框
 
 ### showToast 兼容性  
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | 4.41 | 3.91 | 4.11 | 4.61 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 5.31 | 3.91 | 4.11 | 4.61 |
 
 ### 参数 
 
@@ -19,28 +19,28 @@
 | options | **ShowToastOptions** | 是 | uni.showToast参数定义 |
 | 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
 | :- | :- | :- | :- |  :-: | :- |
-| title | string | 是 |  | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 提示的内容，长度与 icon 取值有关。 |
-| icon | string | 否 | "success" | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | icon值说明 |
+| title | string | 是 |  | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 提示的内容，长度与 icon 取值有关。 |
+| icon | string | 否 | "success" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | icon值说明 |
 @@| 合法值 | 兼容性 | 描述 |
 @@| :- |  :-: | :- |
-@@| "success" | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 显示成功图标 |
-@@| error | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 显示错误图标 |
-@@| fail | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 显示错误图标，此时title文本无长度显示，支付宝、抖音小程序生效 |
-@@| exception | Web x / 微信小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 显示异常图标，此时title文本无长度显示，支付宝小程序生效 |
-@@| loading | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 显示加载图标 |
-@@| none | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 不显示图标 |
-| image | string.ImageURIString | 否 |  | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 自定义图标的本地路径（app-android/app-ios端暂不支持gif） |
-| mask | boolean | 否 | false | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 是否显示透明蒙层，防止触摸穿透 |
-| duration | number | 否 | 1500 | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 提示的延迟时间，单位毫秒 |
-| position | string | 否 |  | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | position值说明。纯文本轻提示显示位置，填写有效值后只有 title 属性生效，且不支持通过 uni.hideToast 隐藏。 |
+@@| "success" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 显示成功图标 |
+@@| "error" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 显示错误图标 |
+@@| "fail" | Web x / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 显示错误图标，此时title文本无长度显示，支付宝、抖音小程序生效 |
+@@| "exception" | Web x / 微信小程序 x / 支付宝小程序 x / Android x / iOS x / HarmonyOS x（不支持） | 显示异常图标，此时title文本无长度显示，支付宝小程序生效 |
+@@| "loading" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 显示加载图标 |
+@@| "none" | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 不显示图标 |
+| image | string.ImageURIString | 否 |  | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 自定义图标的本地路径（app-android/app-ios端暂不支持gif） |
+| mask | boolean | 否 | false | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 5.25 | 是否显示透明蒙层，防止触摸穿透 |
+| duration | number | 否 | 1500 | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 提示的延迟时间，单位毫秒 |
+| position | string | 否 |  | Web 5.32 / 微信小程序 x / 支付宝小程序 x / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | position值说明。纯文本轻提示显示位置，填写有效值后只有 title 属性生效，且不支持通过 uni.hideToast 隐藏。 |
 @@| 合法值 | 兼容性 | 描述 |
 @@| :- |  :-: | :- |
-@@| "top" | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 居上显示 |
-@@| center | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 居中显示 |
-@@| bottom | Web x / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61（部分支持，见上） | 居底显示 |
-| success | (res: ShowToastSuccess) => void | 否 |  | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | uni.showToast成功回调函数定义 |
-| fail | (res: [ShowToastFail](#showtoastfail-values)) => void | 否 |  | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | uni.showToast失败回调函数定义 |
-| complete | (res: any) => void | 否 |  | Web 4.0 / 微信小程序 4.41 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | uni.showToast完成回调函数定义 | 
+@@| "top" | Web 5.32 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 居上显示 |
+@@| "center" | Web 5.32 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 居中显示 |
+@@| "bottom" | Web 5.32 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | 居底显示 |
+| success | (res: ShowToastSuccess) => void | 否 |  | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | uni.showToast成功回调函数定义 |
+| fail | (res: [ShowToastFail](#showtoastfail-values)) => void | 否 |  | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | uni.showToast失败回调函数定义 |
+| complete | (res: any) => void | 否 |  | Web 4.0 / 微信小程序 4.41 / 支付宝小程序 5.31 / Android 3.91 / iOS 4.11 / HarmonyOS 4.61 | uni.showToast完成回调函数定义 | 
 
 #### ShowToastFail 的属性值 @showtoastfail-values 
 
@@ -59,7 +59,7 @@
 ### 参见
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.ui.toast.showToast)
 - [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/ui/prompt.html#showtoast)
-- [微信小程序文档](https://developers.weixin.qq.com/doc/search.html?source=enter&query=showToast&doc_type=miniprogram)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.showToast.html)
 - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=showToast&pageIndex=1&pageSize=10&source=doc_top&type=all)
 - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=showToast&scope=devdocs&source=docs)
 - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=showToast&secondType=all&type=1)
@@ -72,23 +72,56 @@
 - [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)
 
 ::: sourceCode
-## uni.hideToast() @hidetoast
+## uni.hideToast(options?) @hidetoast
 
-> GitCode: https://gitcode.com/dcloud/uni-api/tree/alpha/uni_modules/uni-prompt
+> GitCode: https://gitcode.com/dcloud/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-prompt
 
-> GitHub: https://github.com/dcloudio/uni-api/tree/alpha/uni_modules/uni-prompt
+> GitHub: https://github.com/dcloudio/uni-app/tree/uni-app-x-alpha/src/uni_modules/uni-prompt
 
 隐藏消息提示框。
 
 ### hideToast 兼容性  
-| Web | 微信小程序 | Android | iOS | HarmonyOS |
-| :- | :- | :- | :- | :- |
-| 4.0 | 4.41 | 3.91 | 4.11 | 4.61 |
+| Web | 微信小程序 | 支付宝小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 5.31 | 3.91 | 4.11 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **HideToastOptions** | 否 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| allType | boolean | 否 | Web 5.32 / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS 5.31 / HarmonyOS 5.31（部分支持，见上） | 是否关闭所有类型的 toast，默认不关闭。仅鸿蒙平台支持。 |
+| success | (res: [HideToastSuccess](#hidetoastsuccess-values)) => void | 否 | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS 5.31 / HarmonyOS 5.31（部分支持，见上） | 成功回调函数定义 |
+| fail | (res: [HideToastFail](#hidetoastfail-values)) => void | 否 | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS 5.31 / HarmonyOS 5.31（部分支持，见上） | 失败回调函数定义 |
+| complete | (res: any) => void | 否 | Web x / 微信小程序 x / 支付宝小程序 x / Android 5.31 / iOS 5.31 / HarmonyOS 5.31（部分支持，见上） | 完成回调函数定义 |
+| noConflict | boolean | 否 | 微信小程序 4.41（部分支持，见上） | 需要基础库： `2.22.1`<br/><br/>目前 toast 和 loading 相关接口可以相互混用，此参数可用于取消混用特性<br/> | 
+
+#### HideToastSuccess 的属性值 @hidetoastsuccess-values 
+
+| 名称 | 类型 | 必备 |
+| :- | :- | :- |
+| errMsg | string | 是 |
+
+#### HideToastFail 的属性值 @hidetoastfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+| 合法值 | 描述 |
+| :- | :- |
+| 1 | 撤销 |
+| 1001 | 请求参数非法 |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
 
 ### 参见
 - [相关 Bug](https://issues.dcloud.net.cn/?mid=api.ui.toast.hideToast)
 - [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/ui/prompt.html#hidetoast)
-- [微信小程序文档](https://developers.weixin.qq.com/doc/search.html?source=enter&query=hideToast&doc_type=miniprogram)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.hideToast.html)
 - [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=hideToast&pageIndex=1&pageSize=10&source=doc_top&type=all)
 - [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=hideToast&scope=devdocs&source=docs)
 - [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=hideToast&secondType=all&type=1)
@@ -110,36 +143,43 @@
 >示例
 ```vue
 <template>
-  
-  <scroll-view direction="vertical" style="flex:1">
-  
-    <page-head :title="data.title"></page-head>
-    <view class="uni-padding-wrap">
-      <enum-data :items="iconOptions" title="设置icon" item-class="radio-icon"
-        @change="radioChangeIcon"></enum-data>
-      <boolean-data :defaultValue="data.imageSelect" title="是否显示自定义图标"
-        @change="change_image_boolean"></boolean-data>
-      <boolean-data :defaultValue="data.maskSelect" title="是否显示透明蒙层-屏蔽点击事件"
-        @change="change_mask_boolean"></boolean-data>
-      <view class="uni-title uni-list-cell-padding">提示的延迟时间，默认：1500（单位毫秒）</view>
-      <view class="uni-list-cell-padding">
-        <slider @change="sliderChange" foreColor="#007AFF" :value="data.intervalSelect" :min="1500" :max="5000"
-          :show-value="true" />
-      </view>
-      <view class="uni-btn-v">
-        <button type="default" @tap="toast1Tap" id="btn-toast-default">点击弹出toast</button>
-        <button type="default" @tap="hideToast" id="btn-toast-hide">点击隐藏toast</button>
-      </view>
+  <page-head :title="data.title"></page-head>
+  <view class="uni-padding-wrap">
+    <enum-data :items="iconOptions" title="设置icon" item-class="radio-icon"
+      @change="radioChangeIcon"></enum-data>
+    <boolean-data :value="data.imageSelect" title="是否显示自定义图标"
+      @change="change_image_boolean"></boolean-data>
+    <boolean-data :value="data.maskSelect" title="是否显示透明蒙层-屏蔽点击事件"
+      @change="change_mask_boolean"></boolean-data>
+    <view class="uni-title uni-list-cell-padding">提示的延迟时间，默认：1500（单位毫秒）</view>
+    <view class="uni-list-cell-padding">
+      <slider @change="sliderChange" foreColor="#007AFF" :value="data.intervalSelect" :min="1500" :max="5000"
+        :show-value="true" />
+    </view>
+    <view class="uni-btn-v">
+      <button type="default" @tap="toast1Tap" id="btn-toast-default">点击弹出toast</button>
+      <button type="default" @tap="hideToast" id="btn-toast-hide">点击隐藏toast</button>
+    </view>
+    
+    <enum-data :items="positionOptions" title="设置position" item-class="radio-position"
+      @change="radioChangePosition"></enum-data>
+    <button class="uni-btn uni-common-mb" type="default" @tap="toast2Tap" id="btn-toast-position">点击弹出设置position的toast</button>
+    
+    
+    <button class="uni-btn uni-common-mb" type="default" @tap="toast4Tap">
       
-      <enum-data :items="positionOptions" title="设置position，仅App生效" item-class="radio-position"
-        @change="radioChangePosition"></enum-data>
-      <button class="uni-btn uni-common-mb" type="default" @tap="toast2Tap">点击弹出设置position的toast</button>
+      显示系统toast和原生toast
       
-      <text>{{data.exeRet}}</text>
-    </view>
-  
-  </scroll-view>
-  
+      
+      同时显示页面级和应用级toast
+      
+    </button>
+    
+    
+    <button class="uni-btn uni-common-mb" type="default" @tap="hideSystemToast" id="btn-toast-hide-all">关闭所有toast</button>
+    
+    <text>{{data.exeRet}}</text>
+  </view>
 </template>
 
 
@@ -154,27 +194,40 @@
 | :- | :- | :- | :- |
 | errMsg | string | 是 | 错误信息 |
 
-## Bug & Tips@tips
-- 在 iOS、微信小程序、Web 平台，showToast 是和页面（包括 dialogPage）绑定的
-- 在 Android 平台
-	* position 设为 bottom 时，为系统toast，此时与 App 绑定，而不是与页面绑定。position 不为 bottom 时仍与页面绑定
-	* 系统toast 不支持 icon 图标，仅支持文字
+## 页面级toast和应用级toast@position
+
+toast，分页面级和应用级。默认为页面级。
+
+- 页面级toast：
+	toast 和页面绑定。**页面（含 dialogPage）关闭时，toast 会跟随页面立即一起消失；新页面（含 dialogPage）出现时会遮挡之前页面弹出的 toast **。
+  + 当showToast执行时，会寻找当前页面栈顶的窗体（包括 dialogPage），找到后进行绑定，然后弹出 Toast。
+	+ 在支持 dialogPage 的平台（Web和App），[uni.showModal](./modal.md)、[uni.showActionSheet](./action-sheet.md) 也是 dialogPage 实现的，此时 toast 会绑定到这些 dialogPage 上
+	+ 在弹出 toast 后，再次打开新页面，新页面会覆盖原页面弹出的 toast。
+		+ 如需在新页面（包括 dialogPage）弹出 toast，需要再次调用 showToast
+  + 关闭页面（包括 dialogPage）时，toast 会跟随页面（包括 dialogPage）一起消失
+		+ 如需在dialogPage关闭后，仍然弹出 toast，需要在关闭dialogPage后再次调用 showToast
+- 应用级toast：
+	toast 和应用绑定。
+	弹出和关闭页面，全部 toast 都不会跟随页面被遮挡或消失。toast会按指定的时长完整显示，然后再消失。
+
+由于历史原因和平台差异，设置应用级 toast 的方式是设置 showToast 的参数 position 属性，不管 position 设为 "top"、"center"、"bottom" 均可。
+
+并非所有平台、所有版本都支持设置 position，即应用级 toast。
+- 小程序平台不支持，所以小程序平台的 toast 都是和页面绑定的。
+- web平台暂不支持。后续会补充
+- iOS平台需要5.31+ 蒸汽模式才支持。
+- Android平台设置 position 时弹出的是 Android系统的 toast，该 toast 样式受rom影响：
+	* 系统toast 不支持 icon 图标，仅支持文字，Android12及以上版本文字内容通常限制为两行
+	* Android11及以上版本，系统toast设置不支持设置显示在顶部或居中，仅支持显示在底部
+	* Android11及以上版本，应用进入后台后，调用系统 toast 不弹出。 [文档地址](https://developer.android.google.cn/about/versions/11/behavior-changes-11?hl=nb#toasts)
 	* 部分 Android ROM，如 MIUI，调用系统 toast 时，会在 toast 行首自动加上 App 图标。此为 ROM 行为，目的是帮助用户区分该 toast 是哪个 App 弹出的
-- 在 HarmonyOS 平台
+- HarmonyOS 平台
   - 5.24 及以下
     - 只有系统 toast ，和 App window 绑定
   	- 不支持 icon 图标，仅支持文字
   - 5.25 及以上：
   	* position 设为 top、center、bottom 时，为系统 toast，和页面绑定
   	* 当没有传递 position 参数时，支持 icon、mask、image 参数，和页面绑定
-- 当 Toast 和页面绑定时：
-  + 当showToast执行时，会寻找当前页面栈顶的窗体（包括 dialogPage），找到后进行绑定，然后弹出 Toast。
-	+ 在支持 dialogPage 的平台（Web和App），[uni.showModal](./modal.md)、[uni.showActionSheet](./action-sheet.md) 也是 dialogPage 实现的，此时 toast 会绑定到这些 dialogPage 上
-	+ 在弹出 Toast 后，再次打开新页面，新页面会覆盖原页面弹出的 Toast。
-		+ 如需在新页面（包括 dialogPage）弹出 Toast，需要再次调用 showToast
-  + 关闭页面（包括 dialogPage）时，Toast 会跟随页面（包括 dialogPage）一起消失
-		+ 如需在dialogPage关闭后，仍然弹出 Toast，需要在关闭dialogPage后再次调用 showToast
-- 当 Toast 和应用绑定时，也即系统 toast：
-	弹出和关闭页面，系统 toast 都不会跟随页面被遮挡或消失。
-- Android 11 及以上版本，应用进入后台后，调用系统 toast 不弹出。 [文档地址](https://developer.android.google.cn/about/versions/11/behavior-changes-11?hl=nb#toasts)
+
+## Bug & Tips@tips
 - showToast 里的 Loading，和 showLoading 的区别是，showLoading 需要手动调用 HideLoading 才会关闭。而 showToast 里的 Loading 显示指定时间后会自动关闭。一般情况都需要精准控制关闭时机，所以大多使用 showLoading 和 hideLoading