提交 34460f7b 编写于 作者: DCloud-WZF's avatar DCloud-WZF 💬

docs: uni-app x compatibility

上级 3c17628f
......@@ -33,10 +33,10 @@ selector类似于 CSS 的选择器,但仅支持下列语法。
## uni-app x 注意事项
1. app-uvue支持的选择器较少,不支持ID选择器,[详见](../../uni-app-x/css/readme.md#选择器)
2. app-uvue的页面滚动,是由页面最外层的scroll-view模拟的,如果页面最外层不是scroll-view,无法使用本api。[详见](../../uni-app-x/css/readme.md#pagescroll)
3. app-uvue的scroll-view滚动时,如需动画,则需要在scroll-view的属性中配置 `scroll-with-animation="true"`[详见](../../component/scroll-view.md)
4. scroll-view的滚动,设置其scrollTop即可。[详见](../../component/scroll-view.md)
1. app-uvue支持的选择器较少,不支持ID选择器,[详见](uni-app-x/css/README.md#选择器)
2. app-uvue的页面滚动,是由页面最外层的scroll-view模拟的,如果页面最外层不是scroll-view,无法使用本api。[详见](uni-app-x/css/README.md#pagescroll)
3. app-uvue的scroll-view滚动时,如需动画,则需要在scroll-view的属性中配置 `scroll-with-animation="true"`[详见](component/scroll-view.md)
4. scroll-view的滚动,设置其scrollTop即可。[详见](component/scroll-view.md)
**示例**
......
......@@ -975,7 +975,7 @@ h5 平台下拉刷新动画,只有 circle 类型。
- 考虑到编译速度,直接在`pages.json`内修改`easycom`不会触发重新编译,需要改动页面内容触发。
- `easycom`只处理vue组件,不处理小程序专用组件(如微信的wxml格式组件)。不处理后缀为.nvue的组件。因为nvue页面引入的组件也是.vue组件。可以参考uni ui,使用vue后缀,同时兼容nvue页面。
- `nvue`页面里引用`.vue`后缀的组件,会按照nvue方式使用原生渲染,其中不支持的css会被忽略掉。这种情况同样支持`easycom`
- `vue``uvue` 组件优先级,[详见](/uni-app-x/component/readme.md#priority)
- `vue``uvue` 组件优先级,[详见](/uni-app-x/component/README.md#priority)
## tabBar
......
......@@ -214,7 +214,7 @@
* 如果您一定要在webview中实现区域长列表,建议使用三方如better-scroll组件,或者插件市场搜索 [虚拟列表](https://ext.dcloud.net.cn/search?q=%E8%99%9A%E6%8B%9F%E5%88%97%E8%A1%A8),这些专业组件实现了dom复用,即便列表很长也不会创建很多dom。
- 下拉刷新问题
* webview渲染时,建议使用页面级的原生下拉刷新,性能更好。如一定要在webview中自定义下拉刷新,建议插件市场搜索[虚拟列表](https://ext.dcloud.net.cn/search?q=%E4%B8%8B%E6%8B%89%E5%88%B7%E6%96%B0),这些专业组件使用wxs、renderjs等技术避免通信阻塞。
- scroll-view是区域滚动,不会触发页面滚动,无法触发pages.json配置的下拉刷新、页面触底onReachBottomDistance、titleNView的transparent透明渐变。但在app-uvue下,scroll-view如果是页面顶级节点,则等同于页面滚动。[详见](../uni-app-x/css/readme.md#pagescroll)
- scroll-view是区域滚动,不会触发页面滚动,无法触发pages.json配置的下拉刷新、页面触底onReachBottomDistance、titleNView的transparent透明渐变。但在app-uvue下,scroll-view如果是页面顶级节点,则等同于页面滚动。[详见](uni-app-x/css/README.md#pagescroll)
- webview渲染时,scroll-view的滚动条设置,可通过css的-webkit-scrollbar自定义,包括隐藏滚动条。
在app-uvue中,其实没有页面级滚动,scroll-view也不存在原生组件层级、下拉刷新性能问题。但app-uvue里使用长列表,请务必使用list-view组件,这个组件内置了recycle-view机制,不管列表多长,都可以通过回收不显示的列表来保证高性能。[详见](list-view.md)
......
......@@ -4,7 +4,7 @@
在app-uvue和app-nvue中,文本只能写在text中,而不能写在view的text区域。
虽然app-uvue中写在view的text区域的文字,也会被编译器自动包裹一层text组件,看起来也可以使用。但这样会造成无法修改该text文字的样式,详见uvue的[样式不继承](../uni-app-x/css/readme.md#stylenoextends)章节
虽然app-uvue中写在view的text区域的文字,也会被编译器自动包裹一层text组件,看起来也可以使用。但这样会造成无法修改该text文字的样式,详见uvue的[样式不继承](uni-app-x/css/README.md#stylenoextends)章节
## 属性说明
......
......@@ -4,7 +4,7 @@
在app-uvue和app-nvue中,文本只能写在text中,而不能写在view的text区域。文本样式的控制也应该在text组件上写style,而不是在view的样式里写。
虽然app-uvue中写在view的text区域的文字,也会被编译器自动包裹一层text组件,看起来也可以使用。但这样会造成无法修改该text文字的样式,详见uvue的[样式不继承](../uni-app-x/css/readme.md#stylenoextends)章节
虽然app-uvue中写在view的text区域的文字,也会被编译器自动包裹一层text组件,看起来也可以使用。但这样会造成无法修改该text文字的样式,详见uvue的[样式不继承](uni-app-x/css/README.md#stylenoextends)章节
<!-- UTSCOMJSON.text.attrubute -->
......
......@@ -86,7 +86,7 @@ uvue渲染引擎包括原生版的vue框架(组件、数据绑定...)、跨
uvue支持的vue语法,是按vue3实现的,但一期uvue不支持setup。详见[vue语法]()
uvue支持的css语法,是web的子集,类似于nvue的css。仅支持flex布局。但也足以布局出需要的界面。详见[css语法](css/readme.md)
uvue支持的css语法,是web的子集,类似于nvue的css。仅支持flex布局。但也足以布局出需要的界面。详见[css语法](uni-app-x/css/README.md)
以上约束特指App端的uvue引擎。如果把uvue页面编译到小程序和web平台,它的script仍然会被编译为js、它的样式遵循web的样式定义。
......
......@@ -226,8 +226,8 @@ request({url: 'https://www.example.com/request'} as RequestOptions)
## vue 注意事项
[详见]((uni-app-x/vue/readme.md))
[详见]((uni-app-x/vue/README.md))
## css使用注意
[详见](uni-app-x/css/readme.md)
[详见](uni-app-x/css/README.md)
......@@ -33,12 +33,12 @@
## 组件
- [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](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)
## 应用生命周期
uni-app x 新增了 [onLastPageBackPress](collocation/App.md#applifecycle)[onExit](collocation/App.md#applifecycle) 应用级生命周期,Android退出应用逻辑写在app.uvue里,新建项目的模板自动包含相关代码。如需修改退出逻辑,请直接修改相关代码。
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册