提交 8ab103c1 编写于 作者: D DCloud_LXH

chore: 同步文档更新

上级 542c81cd
## uni.getFileSystemManager() @getfilesystemmanager
<!-- UTSAPIJSON.getFileSystemManager.description -->
文件管理器对象,用于操作应用可访问的本地文件空间,在app-Android上是沙盒目录。
可实现目录和文件的创建、删除、改名或改路径、遍历目录、获取文件信息、读写文件。
<!-- UTSAPIJSON.getFileSystemManager.param -->
<!-- UTSAPIJSON.getFileSystemManager.returnValue -->
<!-- UTSAPIJSON.getFileSystemManager.compatibility -->
<!-- UTSAPIJSON.getFileSystemManager.tutorial -->
<!-- UTSAPIJSON.filemanager.example -->
<!-- UTSAPIJSON.general_type.name -->
<!-- UTSAPIJSON.general_type.param -->
\ No newline at end of file
...@@ -28,6 +28,7 @@ ...@@ -28,6 +28,7 @@
<!-- UTSAPIJSON.general_type.param --> <!-- UTSAPIJSON.general_type.param -->
## Bug & Tips@tips ## Tips@tips
* 目前仅以下接口支持拦截器:navigateTo、redirectTo、reLaunch、switchTab、navigateBack、loadFontFace、pageScrollTo、startPullDownRefresh、setNavigationBarColor、setNavigationBarTitle、setTabBarBadge、removeTabBarBadge、setTabBarItem、setTabBarStyle、hideTabBar、showTabBar、showTabBarRedDot、hideTabBarRedDot * 目前仅以下接口支持拦截器:navigateTo、redirectTo、reLaunch、switchTab、navigateBack、loadFontFace、pageScrollTo、startPullDownRefresh、setNavigationBarColor、setNavigationBarTitle、setTabBarBadge、removeTabBarBadge、setTabBarItem、setTabBarStyle、hideTabBar、showTabBar、showTabBarRedDot、hideTabBarRedDot
* 如需拦截request,可在插件市场搜索[拦截器插件](https://ext.dcloud.net.cn/search?q=%E6%8B%A6%E6%88%AA%E5%99%A8&uni-appx=1)
\ No newline at end of file
# uni-push # uni-push
uni-push是DCloud与合作伙伴共同推出的统一推送服务。用于从服务器端推送消息到客户端。 uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。用于从服务器端推送消息到客户端。
它包括在线推送、离线推送,聚合了Apple、华为、小米、OPPO、VIVO、魅族、Google等多个手机厂商的推送通道。 它包括在线推送、离线推送,聚合了Apple、华为、小米、OPPO、VIVO、魅族、荣耀(3.99+)、Google等多个手机厂商的推送通道。
若不使用服务器推送,仅想创建手机通知栏本地消息,也需要使用本模块的API。 若不使用服务器推送,仅想创建手机通知栏本地消息,也需要使用本模块的API。
......
## uni.getUniverifyManager() @getuniverifymanager
<!-- UTSAPIJSON.getUniverifyManager.description -->
App一键登陆,封装了个推的一键登陆sdk,其内部再次封装了中国三大电信运营商提供的sdk。通过运营商提供的服务,可以在手机sim卡信号正常的情况下,通过云端接口获取到当前用户的手机号。
App一键登陆是替代短信验证码登录的更优选择:对开发者而言更便宜、对用户而言体验更好。
一键登陆涉及业务开通和付费,涉及客户端和服务器交互,有较多文档:
1. 业务介绍:介绍业务流程、开通和付费。[详见](https://uniapp.dcloud.net.cn/univerify.html)
2. 客户端API,即本文
3. 服务器API,[详见](https://uniapp.dcloud.net.cn/uniCloud/uni-login/dev.html)
<!-- UTSAPIJSON.getUniverifyManager.param -->
<!-- UTSAPIJSON.getUniverifyManager.returnValue -->
<!-- UTSAPIJSON.getUniverifyManager.compatibility -->
<!-- UTSAPIJSON.getUniverifyManager.tutorial -->
<!-- UTSAPIJSON.uni-verify.example -->
## Tips
- 运营商对一键登陆给用户呈现的ui有强制要求。(需补充细节)
- 目前一键登陆的UI可自定义性有限。(需补充细节)
<!-- UTSAPIJSON.general_type.name -->
<!-- UTSAPIJSON.general_type.param -->
\ No newline at end of file
...@@ -46,8 +46,6 @@ uni-app x支持的组件包括: ...@@ -46,8 +46,6 @@ uni-app x支持的组件包括:
- 仅支持直接在 `export default` 内部声明,不支持其他位置定义后,在 `export default` 中引用。 - 仅支持直接在 `export default` 内部声明,不支持其他位置定义后,在 `export default` 中引用。
- 复杂数据类型需要通过 `PropType` 标记类型,[详见](https://cn.vuejs.org/guide/typescript/options-api.html#typing-component-props) - 复杂数据类型需要通过 `PropType` 标记类型,[详见](https://cn.vuejs.org/guide/typescript/options-api.html#typing-component-props)
```ts ```ts
import { type PropType } from 'vue'
type Obj = { a: number } type Obj = { a: number }
export default { export default {
......
...@@ -6,7 +6,7 @@ uni-app x在App端还有一批组件未与uni-app js引擎版拉齐。有的在 ...@@ -6,7 +6,7 @@ uni-app x在App端还有一批组件未与uni-app js引擎版拉齐。有的在
- movable-view:没有ui层和逻辑层的通信阻塞,开发者可自己写代码拖动view。hello uni-app x中有[示例代码](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/dev/pages/component/general-event/touch-event.uvue) - movable-view:没有ui层和逻辑层的通信阻塞,开发者可自己写代码拖动view。hello uni-app x中有[示例代码](https://gitcode.net/dcloud/hello-uni-app-x/-/blob/dev/pages/component/general-event/touch-event.uvue)
- picker:可改用[picker-view](picker-view.md) - picker:可改用[picker-view](picker-view.md)
- canvas:目前没有完整的canvas组件,但 - canvas:目前没有完整的canvas组件,但
* 每个view,都提供了[draw API](dom/drawablecontext.md),可以高性能的画各种形状、写字。 * 每个view,都提供了[draw API](../dom/drawablecontext.md),可以高性能的画各种形状、写字。
* 关于截图,无需像webview那样通过canvas中转,view直接提供截图方案,[takesnapshot](dom/element.md#takesnapshot) * 关于截图,无需像webview那样通过canvas中转,view直接提供截图方案,[takesnapshot](dom/element.md#takesnapshot)
* 使用web-view中的canvas也是一种方案,uvue页面里的web-view组件可以和uvue页面里的uts代码双向通信。比如生成二维码,可以由web-view组件来渲染,复用web生态的库。 * 使用web-view中的canvas也是一种方案,uvue页面里的web-view组件可以和uvue页面里的uts代码双向通信。比如生成二维码,可以由web-view组件来渲染,复用web生态的库。
* 当然二维码在插件市场也有现成的[插件](https://ext.dcloud.net.cn/search?q=%E4%BA%8C%E7%BB%B4%E7%A0%81&uni-appx=1) * 当然二维码在插件市场也有现成的[插件](https://ext.dcloud.net.cn/search?q=%E4%BA%8C%E7%BB%B4%E7%A0%81&uni-appx=1)
......
...@@ -199,7 +199,7 @@ uvue中文字都是要使用text组件的。 ...@@ -199,7 +199,7 @@ uvue中文字都是要使用text组件的。
uni-app x的css的样式不继承规则,虽然与web有差异,其实只是更严谨。 uni-app x的css的样式不继承规则,虽然与web有差异,其实只是更严谨。
开发者遵循仅在text组件下写文字有关的样式,就可以编译到全端而保持界面正常。 一般情况下,开发者遵循仅在text组件下写文字有关的样式,就可以编译到全端而保持界面正常。
## 层级 ## 层级
...@@ -217,7 +217,7 @@ uni-app x的css的样式不继承规则,虽然与web有差异,其实只是 ...@@ -217,7 +217,7 @@ uni-app x的css的样式不继承规则,虽然与web有差异,其实只是
|Block 布局 |× | | |Block 布局 |× | |
|字体 |√ |支持ttf、otf,不支持woff和woff2和可变字体 | |字体 |√ |支持ttf、otf,不支持woff和woff2和可变字体 |
|Positioned 布局 |√ | | |Positioned 布局 |√ | |
|CSS Animation | | | |CSS Animation |x | |
|CSS Transition |√ | | |CSS Transition |√ | |
|CSS Variable |× | | |CSS Variable |× | |
|媒体查询 |× | | |媒体查询 |× | |
...@@ -309,7 +309,7 @@ uni-app x的css的样式不继承规则,虽然与web有差异,其实只是 ...@@ -309,7 +309,7 @@ uni-app x的css的样式不继承规则,虽然与web有差异,其实只是
## css方法 ## css方法
目前仅支持url() 目前仅支持url()、rgb()、rgba()。
暂不支持css变量val()。--status-bar-height、--window-top、--window-bottom,也暂时无法使用,有相关需求可使用[uni.getWindowInfo()](../api/getwindowinfo.md)方式获取。 暂不支持css变量val()。--status-bar-height、--window-top、--window-bottom,也暂时无法使用,有相关需求可使用[uni.getWindowInfo()](../api/getwindowinfo.md)方式获取。
...@@ -442,6 +442,6 @@ Tips: ...@@ -442,6 +442,6 @@ Tips:
* 页面的样式作用于当前页面及其子组件。 * 页面的样式作用于当前页面及其子组件。
* 组件的样式仅作用于当前组件。 * 组件的样式仅作用于当前组件。
## Bug & Tips ## Bug
- 动态创建的根组件,`class` 样式不生效,暂时可通过外层包裹 `view` 解决。此bug已于HBuilderX 3.97+修复 css相关bug[详见](https://issues.dcloud.net.cn/?mid=css)
# 全局变量与状态管理 # 全局变量与状态管理
`uni-app x` 不支持globaldata,目前也不支持pinia和vuex。但可通过一个专用模块组织和管理全局变量与状态。 `uni-app x` 目前不支持 `pinia``vuex`。可通过 `globalData(3.99+)`一个专用模块组织和管理全局变量与状态。
## globalData
`App.uvue` 中定义 `globalData`
```ts
<script lang="uts">
export default {
globalData: {
str: 'global data str',
num: 123,
bool: true
}
}
</script>
```
页面或组件中通过 `getApp().globalData` 访问。
```ts
<script lang="uts">
export default {
methods: {
getGlobalData() {
const app = getApp()
this.globalDataStr = app.globalData.str
this.globalDataNum = app.globalData.num
this.globalDataBool = app.globalData.bool
}
}
}
</script>
```
**注意:** `uni-app x``globalData` 的数据结构与类型通过 `App.uvue` 中的 `globalData` 初始值定义,后续只能读取或修改,不能新增或删除。
## 专用模块
定义一个模块,编写一个单独的uts文件,比如 /store/index.uts,在里面设一个全局变量,比如globalNum。 定义一个模块,编写一个单独的uts文件,比如 /store/index.uts,在里面设一个全局变量,比如globalNum。
```ts ```ts
......
...@@ -677,6 +677,7 @@ array1.forEach((element:string, index:number) => { ...@@ -677,6 +677,7 @@ array1.forEach((element:string, index:number) => {
* kotlin.collections.List * kotlin.collections.List
* kotlin.Array * kotlin.Array
* kotlin.IntArray * kotlin.IntArray
* kotlin.FloatArray
* kotlin.ByteArray * kotlin.ByteArray
* kotlin.LongArray * kotlin.LongArray
* ... * ...
...@@ -763,6 +764,18 @@ console.log("b",b[2]) ...@@ -763,6 +764,18 @@ console.log("b",b[2])
let a = [[2].toKotlinList().toIntArray(),[23].toKotlinList().toIntArray(),[22].toKotlinList().toIntArray()] let a = [[2].toKotlinList().toIntArray(),[23].toKotlinList().toIntArray(),[22].toKotlinList().toIntArray()]
let b = a.toKotlinList().toTypedArray() let b = a.toKotlinList().toTypedArray()
// Array<Number> 转 java float[]的示例
let a = new Array<Number>(10)
// b是 List<Float>
let b = a.toKotlinList().map(function(it):Float{
return it.toFloat()
})
// c是 float[]
let c = b.toTypedArray()
// d 是 FloatArray
let d = b.toFloatArray()
``` ```
#### iOS 平台专有数组类型 #### iOS 平台专有数组类型
......
# vue # vue
uni-app x的vue规范,按照vue3规范实现,但目前不支持setup组合式写法,仅支持option选项式写法。\ uni-app x的vue规范,按照vue3规范实现,但目前不支持setup组合式写法,仅支持option选项式写法。
本文暂时只包括兼容性表格,vue功能详情另见 [vue3概述](https://uniapp.dcloud.net.cn/tutorial/vue3-basics.html#)[Vue3 API](https://uniapp.dcloud.net.cn/tutorial/vue3-api.html) 本文暂时只包括兼容性表格,vue功能详情另见 [vue3概述](https://uniapp.dcloud.net.cn/tutorial/vue3-basics.html#)[Vue3 API](https://uniapp.dcloud.net.cn/tutorial/vue3-api.html)
uni-app x中vue的用法,有单独的示例应用:[hello uvue](https://gitcode.net/dcloud/hello-uvue)。这里都是可以跑通的使用样例代码。
## 全局 API兼容性 ## 全局 API兼容性
### 应用实例 @app-instance ### 应用实例 @app-instance
...@@ -25,7 +28,7 @@ uni-app x的vue规范,按照vue3规范实现,但目前不支持setup组合 ...@@ -25,7 +28,7 @@ uni-app x的vue规范,按照vue3规范实现,但目前不支持setup组合
### [函数 event 参数的类型](uni-app-x/tutorial/codegap.md#function-event-argument-type) ### [函数 event 参数的类型](uni-app-x/tutorial/codegap.md#function-event-argument-type)
### 指令 ### 指令 @directives
<!-- VUEJSON.directives.compatibility --> <!-- VUEJSON.directives.compatibility -->
...@@ -54,31 +57,31 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [ ...@@ -54,31 +57,31 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [
## 组件 ## 组件
- [props](uni-app-x/component/README.md#props) - [props](../component/README.md#props)
- [自定义事件](uni-app-x/component/README.md#自定义事件) - [自定义事件](../component/README.md#自定义事件)
- [计算属性和侦听器](uni-app-x/component/README.md#计算属性和侦听器) - [计算属性和侦听器](../component/README.md#计算属性和侦听器)
- [作用域插槽的类型](uni-app-x/component/README.md#作用域插槽的类型) - [作用域插槽的类型](../component/README.md#作用域插槽的类型)
- [监听页面生命周期](uni-app-x/component/README.md#监听页面生命周期) - [监听页面生命周期](../component/README.md#监听页面生命周期)
- [vue 与 uvue 不同文件后缀的优先级](uni-app-x/component/README.md#priority) - [vue 与 uvue 不同文件后缀的优先级](../component/README.md#priority)
<!-- VUEJSON.components.compatibility --> <!-- VUEJSON.components.compatibility -->
### 特殊元素 ### 特殊元素 @special-elements
<!-- VUEJSON.special_elements.compatibility --> <!-- VUEJSON.special_elements.compatibility -->
- App 端,如需页面级滚动,根节点必须是 `scroll-view` 标签。 - App 端,如需页面级滚动,根节点必须是 `scroll-view` 标签。
### 特殊 Attributes ### 特殊 Attributes @special-attributes
<!-- VUEJSON.special_attributes.compatibility --> <!-- VUEJSON.special_attributes.compatibility -->
### 生命周期选项 ### 生命周期选项 @lifecycle-options
<!-- VUEJSON.options_lifecycle.compatibility --> <!-- VUEJSON.options_lifecycle.compatibility -->
## 插件 ## 插件
暂不支持vue插件,比如pinia、vuex、i18n、router。简单的状态管理可以参考文档[全局变量和状态管理](uni-app-x/tutorial/store.md) 暂不支持vue插件,比如pinia、vuex、i18n、router。简单的状态管理可以参考文档[全局变量和状态管理](../tutorial/store.md)
## 选项式 API兼容性 ## 选项式 API兼容性
...@@ -86,7 +89,7 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [ ...@@ -86,7 +89,7 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [
<!-- VUEJSON.options_state.compatibility --> <!-- VUEJSON.options_state.compatibility -->
### 渲染选项 ### 渲染选项 @rendering-options
<!-- VUEJSON.options_rendering.compatibility --> <!-- VUEJSON.options_rendering.compatibility -->
...@@ -99,7 +102,7 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [ ...@@ -99,7 +102,7 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [
<!-- VUEJSON.options_misc.compatibility --> <!-- VUEJSON.options_misc.compatibility -->
### 组件实例 ### 组件实例 @component-instance
<!-- VUEJSON.component_instance.compatibility --> <!-- VUEJSON.component_instance.compatibility -->
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册