提交 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 @@
<!-- 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
* 如需拦截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是DCloud与合作伙伴共同推出的统一推送服务。用于从服务器端推送消息到客户端。
uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。用于从服务器端推送消息到客户端。
它包括在线推送、离线推送,聚合了Apple、华为、小米、OPPO、VIVO、魅族、Google等多个手机厂商的推送通道。
它包括在线推送、离线推送,聚合了Apple、华为、小米、OPPO、VIVO、魅族、荣耀(3.99+)、Google等多个手机厂商的推送通道。
若不使用服务器推送,仅想创建手机通知栏本地消息,也需要使用本模块的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支持的组件包括:
- 仅支持直接在 `export default` 内部声明,不支持其他位置定义后,在 `export default` 中引用。
- 复杂数据类型需要通过 `PropType` 标记类型,[详见](https://cn.vuejs.org/guide/typescript/options-api.html#typing-component-props)
```ts
import { type PropType } from 'vue'
type Obj = { a: number }
export default {
......
......@@ -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)
- picker:可改用[picker-view](picker-view.md)
- canvas:目前没有完整的canvas组件,但
* 每个view,都提供了[draw API](dom/drawablecontext.md),可以高性能的画各种形状、写字。
* 每个view,都提供了[draw API](../dom/drawablecontext.md),可以高性能的画各种形状、写字。
* 关于截图,无需像webview那样通过canvas中转,view直接提供截图方案,[takesnapshot](dom/element.md#takesnapshot)
* 使用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)
......
......@@ -199,7 +199,7 @@ uvue中文字都是要使用text组件的。
uni-app x的css的样式不继承规则,虽然与web有差异,其实只是更严谨。
开发者遵循仅在text组件下写文字有关的样式,就可以编译到全端而保持界面正常。
一般情况下,开发者遵循仅在text组件下写文字有关的样式,就可以编译到全端而保持界面正常。
## 层级
......@@ -217,7 +217,7 @@ uni-app x的css的样式不继承规则,虽然与web有差异,其实只是
|Block 布局 |× | |
|字体 |√ |支持ttf、otf,不支持woff和woff2和可变字体 |
|Positioned 布局 |√ | |
|CSS Animation | | |
|CSS Animation |x | |
|CSS Transition |√ | |
|CSS Variable |× | |
|媒体查询 |× | |
......@@ -309,7 +309,7 @@ uni-app x的css的样式不继承规则,虽然与web有差异,其实只是
## css方法
目前仅支持url()
目前仅支持url()、rgb()、rgba()。
暂不支持css变量val()。--status-bar-height、--window-top、--window-bottom,也暂时无法使用,有相关需求可使用[uni.getWindowInfo()](../api/getwindowinfo.md)方式获取。
......@@ -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。
```ts
......
......@@ -677,6 +677,7 @@ array1.forEach((element:string, index:number) => {
* kotlin.collections.List
* kotlin.Array
* kotlin.IntArray
* kotlin.FloatArray
* kotlin.ByteArray
* kotlin.LongArray
* ...
......@@ -763,6 +764,18 @@ console.log("b",b[2])
let a = [[2].toKotlinList().toIntArray(),[23].toKotlinList().toIntArray(),[22].toKotlinList().toIntArray()]
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 平台专有数组类型
......
# 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)
uni-app x中vue的用法,有单独的示例应用:[hello uvue](https://gitcode.net/dcloud/hello-uvue)。这里都是可以跑通的使用样例代码。
## 全局 API兼容性
### 应用实例 @app-instance
......@@ -25,7 +28,7 @@ uni-app x的vue规范,按照vue3规范实现,但目前不支持setup组合
### [函数 event 参数的类型](uni-app-x/tutorial/codegap.md#function-event-argument-type)
### 指令
### 指令 @directives
<!-- VUEJSON.directives.compatibility -->
......@@ -54,31 +57,31 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [
## 组件
- [props](uni-app-x/component/README.md#props)
- [自定义事件](uni-app-x/component/README.md#自定义事件)
- [计算属性和侦听器](uni-app-x/component/README.md#计算属性和侦听器)
- [作用域插槽的类型](uni-app-x/component/README.md#作用域插槽的类型)
- [监听页面生命周期](uni-app-x/component/README.md#监听页面生命周期)
- [vue 与 uvue 不同文件后缀的优先级](uni-app-x/component/README.md#priority)
- [props](../component/README.md#props)
- [自定义事件](../component/README.md#自定义事件)
- [计算属性和侦听器](../component/README.md#计算属性和侦听器)
- [作用域插槽的类型](../component/README.md#作用域插槽的类型)
- [监听页面生命周期](../component/README.md#监听页面生命周期)
- [vue 与 uvue 不同文件后缀的优先级](../component/README.md#priority)
<!-- VUEJSON.components.compatibility -->
### 特殊元素
### 特殊元素 @special-elements
<!-- VUEJSON.special_elements.compatibility -->
- App 端,如需页面级滚动,根节点必须是 `scroll-view` 标签。
### 特殊 Attributes
### 特殊 Attributes @special-attributes
<!-- VUEJSON.special_attributes.compatibility -->
### 生命周期选项
### 生命周期选项 @lifecycle-options
<!-- VUEJSON.options_lifecycle.compatibility -->
## 插件
暂不支持vue插件,比如pinia、vuex、i18n、router。简单的状态管理可以参考文档[全局变量和状态管理](uni-app-x/tutorial/store.md)
暂不支持vue插件,比如pinia、vuex、i18n、router。简单的状态管理可以参考文档[全局变量和状态管理](../tutorial/store.md)
## 选项式 API兼容性
......@@ -86,7 +89,7 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [
<!-- VUEJSON.options_state.compatibility -->
### 渲染选项
### 渲染选项 @rendering-options
<!-- VUEJSON.options_rendering.compatibility -->
......@@ -99,7 +102,7 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [
<!-- VUEJSON.options_misc.compatibility -->
### 组件实例
### 组件实例 @component-instance
<!-- VUEJSON.component_instance.compatibility -->
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册