diff --git a/docs/api/filemanager.md b/docs/api/filemanager.md new file mode 100644 index 0000000000000000000000000000000000000000..be8ba0c1951aa68ebde2f554f2118611a88af489 --- /dev/null +++ b/docs/api/filemanager.md @@ -0,0 +1,21 @@ +## uni.getFileSystemManager() @getfilesystemmanager + + + +文件管理器对象,用于操作应用可访问的本地文件空间,在app-Android上是沙盒目录。 + +可实现目录和文件的创建、删除、改名或改路径、遍历目录、获取文件信息、读写文件。 + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/api/interceptor.md b/docs/api/interceptor.md index 8b045affb3a35a22344fd310f263c772ceb7eec3..8157b7fa928ddd80b54e6ac568c769496a272284 100644 --- a/docs/api/interceptor.md +++ b/docs/api/interceptor.md @@ -28,6 +28,7 @@ -## Bug & Tips@tips +## Tips@tips -* 目前仅以下接口支持拦截器:navigateTo、redirectTo、reLaunch、switchTab、navigateBack、loadFontFace、pageScrollTo、startPullDownRefresh、setNavigationBarColor、setNavigationBarTitle、setTabBarBadge、removeTabBarBadge、setTabBarItem、setTabBarStyle、hideTabBar、showTabBar、showTabBarRedDot、hideTabBarRedDot \ No newline at end of file +* 目前仅以下接口支持拦截器: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 diff --git a/docs/api/push.md b/docs/api/push.md index 5a78bd3677ff79f71e514dfb4799534cf1af1fb3..fe1e3f25dce490a56b7453126ebed05268df82e8 100644 --- a/docs/api/push.md +++ b/docs/api/push.md @@ -1,8 +1,8 @@ # uni-push -uni-push是DCloud与合作伙伴共同推出的统一推送服务。用于从服务器端推送消息到客户端。 +uni-push是DCloud与合作伙伴个推共同推出的统一推送服务。用于从服务器端推送消息到客户端。 -它包括在线推送、离线推送,聚合了Apple、华为、小米、OPPO、VIVO、魅族、Google等多个手机厂商的推送通道。 +它包括在线推送、离线推送,聚合了Apple、华为、小米、OPPO、VIVO、魅族、荣耀(3.99+)、Google等多个手机厂商的推送通道。 若不使用服务器推送,仅想创建手机通知栏本地消息,也需要使用本模块的API。 diff --git a/docs/api/uni-verify.md b/docs/api/uni-verify.md new file mode 100644 index 0000000000000000000000000000000000000000..9fd005ab8b672faa2bfc6d92e2bb5c84b2577fe8 --- /dev/null +++ b/docs/api/uni-verify.md @@ -0,0 +1,30 @@ +## uni.getUniverifyManager() @getuniverifymanager + + + +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) + + + + + + + + + + + +## Tips +- 运营商对一键登陆给用户呈现的ui有强制要求。(需补充细节) +- 目前一键登陆的UI可自定义性有限。(需补充细节) + + + + \ No newline at end of file diff --git a/docs/component/README.md b/docs/component/README.md index f75d02dd10f9aa3607fa12504456497e3f07cb78..17728d21a1d232d99cc1357f6f9c0142eab8f746 100644 --- a/docs/component/README.md +++ b/docs/component/README.md @@ -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 { diff --git a/docs/component/unsupport.md b/docs/component/unsupport.md index 66c5d0297301c74b8c434824fe44ab40b5ab23ca..dfb45fef4dd86bd050deebae6a8dc25b0bd5a47b 100644 --- a/docs/component/unsupport.md +++ b/docs/component/unsupport.md @@ -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) diff --git a/docs/css/readme.md b/docs/css/readme.md index fc0e76ced1a1448b9f7097b14dcabda2bf4c5343..18e71ab9d0aa624358319bcbf9a1eedc132ea297 100644 --- a/docs/css/readme.md +++ b/docs/css/readme.md @@ -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) diff --git a/docs/tutorial/store.md b/docs/tutorial/store.md index de746172bc6ce3cfde370ec8e93a63a4b69dd5d5..c81800f674067dbcee6dc7f7b208e631a54fd1c2 100644 --- a/docs/tutorial/store.md +++ b/docs/tutorial/store.md @@ -1,7 +1,43 @@ # 全局变量与状态管理 -`uni-app x` 不支持globaldata,目前也不支持pinia和vuex。但可通过一个专用模块组织和管理全局变量与状态。 +`uni-app x` 目前不支持 `pinia` 和 `vuex`。可通过 `globalData(3.99+)` 或一个专用模块组织和管理全局变量与状态。 +## globalData + +`App.uvue` 中定义 `globalData`。 + +```ts + +``` + +页面或组件中通过 `getApp().globalData` 访问。 + +```ts + +``` + +**注意:** `uni-app x` 中 `globalData` 的数据结构与类型通过 `App.uvue` 中的 `globalData` 初始值定义,后续只能读取或修改,不能新增或删除。 + +## 专用模块 定义一个模块,编写一个单独的uts文件,比如 /store/index.uts,在里面设一个全局变量,比如globalNum。 ```ts diff --git a/docs/uts/data-type.md b/docs/uts/data-type.md index b05d8a4f08908196cb629d33a66b11d2cb6804ad..63024e980c12f170ead80a9db6a2717902917ca1 100644 --- a/docs/uts/data-type.md +++ b/docs/uts/data-type.md @@ -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 转 java float[]的示例 +let a = new Array(10) +// b是 List +let b = a.toKotlinList().map(function(it):Float{ + return it.toFloat() +}) +// c是 float[] +let c = b.toTypedArray() +// d 是 FloatArray +let d = b.toFloatArray() + + ``` #### iOS 平台专有数组类型 diff --git a/docs/vue/README.md b/docs/vue/README.md index 28bda41529b9945a111a9c6d3c4204c766089fa7..93b5524978d98b4665d8a330999ba483c92e6556 100644 --- a/docs/vue/README.md +++ b/docs/vue/README.md @@ -1,8 +1,11 @@ # 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 @@ -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) -### 特殊元素 +### 特殊元素 @special-elements - App 端,如需页面级滚动,根节点必须是 `scroll-view` 标签。 -### 特殊 Attributes +### 特殊 Attributes @special-attributes -### 生命周期选项 +### 生命周期选项 @lifecycle-options ## 插件 -暂不支持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) 和 [ -### 渲染选项 +### 渲染选项 @rendering-options @@ -99,7 +102,7 @@ uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle) 和 [ -### 组件实例 +### 组件实例 @component-instance