diff --git a/docs/api/log.md b/docs/api/log.md index 842dce0b10222eb08ea80524dc4862c0286f7576..b4ba39415ac76598c497b3a385b290aefc97d38d 100644 --- a/docs/api/log.md +++ b/docs/api/log.md @@ -17,4 +17,3 @@ - 不同平台对于 console 方法的支持存在差异,建议在开发过程中只使用文档中提到的方法。 - HBuilderX中有2个重要的代码块,敲`clog`:可直接输出`console.log()`;敲`clogv`:可输出`console.log(": " + );`,并且出现双光标,方便把变量名称和值同时打印出来。 -- HBuilderX 1.9.7 以上在App端支持打印对象信息到控制台。老版本可使用`clogj`代码块将json对象转为字符串打印出来。 diff --git a/docs/api/system/theme.md b/docs/api/system/theme.md index 426bab3283bba07fc3faf9e59a121bdb50b4e3b4..ca88b5b3d4f13131512c440099291cc71f171249 100644 --- a/docs/api/system/theme.md +++ b/docs/api/system/theme.md @@ -17,5 +17,4 @@ uni.onThemeChange(function (res) { ``` **注意** -- 自定义基座生效 -- 仅 V3 编译支持,参考 manifest.json 配置 \ No newline at end of file +- 自定义基座生效 \ No newline at end of file diff --git a/docs/collocation/frame/log.md b/docs/collocation/frame/log.md index 842dce0b10222eb08ea80524dc4862c0286f7576..b4ba39415ac76598c497b3a385b290aefc97d38d 100644 --- a/docs/collocation/frame/log.md +++ b/docs/collocation/frame/log.md @@ -17,4 +17,3 @@ - 不同平台对于 console 方法的支持存在差异,建议在开发过程中只使用文档中提到的方法。 - HBuilderX中有2个重要的代码块,敲`clog`:可直接输出`console.log()`;敲`clogv`:可输出`console.log(": " + );`,并且出现双光标,方便把变量名称和值同时打印出来。 -- HBuilderX 1.9.7 以上在App端支持打印对象信息到控制台。老版本可使用`clogj`代码块将json对象转为字符串打印出来。 diff --git a/docs/collocation/frame/window.md b/docs/collocation/frame/window.md index d5f5c1c0d6b1ae0c3eca4a4d586918a9c842bf9a..73d4e42849113a23fe3c81e88070b593360d1bea 100644 --- a/docs/collocation/frame/window.md +++ b/docs/collocation/frame/window.md @@ -12,6 +12,4 @@ console.log(app.globalData) **注意:** - 不要在定义于 `App()` 内的函数中,或调用 `App` 前调用 `getApp()` ,可以通过 `this.$scope` 获取对应的app实例 - 通过 `getApp()` 获取实例之后,不要私自调用生命周期函数。 -- v3模式加速了首页`nvue`的启动速度,当在首页`nvue`中使用`getApp()`不一定可以获取真正的`App`对象。对此v3版本提供了`const app = getApp({allowDefault: true})`用来获取原始的`App`对象,可以用来在首页对`globalData`等初始化 - -uni-app自带的web-view组件,是页面中新插入的一个子webview。获取该对象的方法见:[https://ask.dcloud.net.cn/article/35036](https://ask.dcloud.net.cn/article/35036) \ No newline at end of file +- 当在首页`nvue`中使用`getApp()`不一定可以获取真正的`App`对象。对此提供了`const app = getApp({allowDefault: true})`用来获取原始的`App`对象,可以用来在首页对`globalData`等初始化 diff --git a/docs/collocation/pages.md b/docs/collocation/pages.md index 004ce4c4af562bc6572cf819c21855664e9a1033..33538b1ebaede20782d1030ee775be7016cc04ff 100644 --- a/docs/collocation/pages.md +++ b/docs/collocation/pages.md @@ -899,13 +899,13 @@ h5 平台下拉刷新动画,只有 circle 类型。 其中 list 接收一个数组,数组中的每个项都是一个对象,其属性值如下: -|属性|类型|必填|说明| -|:-|:-|:-|:-| -|pagePath|String|是|页面路径,必须在 pages 中先定义| -|text|String|是|tab 上按钮文字,在 App 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标| -|iconPath|String|否|图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px,当 position 为 top 时,此参数无效,不支持网络图片,不支持字体图标| -|selectedIconPath|String|否|选中时的图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px ,当 position 为 top 时,此参数无效| -|visible|Boolean|否|该项是否显示,默认显示。App 3.2.10+、H5 3.2.10+| +|属性|类型|必填|说明|平台差异| +|:-|:-|:-|:-|:-| +|pagePath|String|是|页面路径,必须在 pages 中先定义|| +|text|String|是|tab 上按钮文字,在 App 和 H5 平台为非必填。例如中间可放一个没有文字的+号图标|| +|iconPath|String|否|图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px,当 position 为 top 时,此参数无效,不支持网络图片,不支持字体图标|| +|selectedIconPath|String|否|选中时的图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px ,当 position 为 top 时,此参数无效|| +|visible|Boolean|否|该项是否显示,默认显示|App (3.2.10+)、H5 (3.2.10)+| **midButton 属性说明** diff --git a/docs/component/input.md b/docs/component/input.md index d4b030bdefe9ebd3be7bda02e493d1930751c972..ebe04059ed83b511508f1a270e7fc10e201f0c19 100644 --- a/docs/component/input.md +++ b/docs/component/input.md @@ -114,7 +114,7 @@ App平台软键盘弹出有 adjustResize|adjustPan 两种模式,默认为 adju - adjustResize模式在Android App上,弹起键盘和收回键盘时,因为要重设webview窗体高度,可能会在个别安卓机型闪现灰屏或漏出下层页面内容。 - H5平台只能在用户交互时修改 focus 生效。 - 如果遇到 focus 属性设置不生效的问题参考:[组件属性设置不生效解决办法](/vue-api?id=_4-组件属性设置不生效解决办法) -- 如需禁止点击其他位置收起键盘的默认行为,可以监听`touch`事件并使用`prevent`修饰符(仅支持App-v3、H5,其他平台可以通过设置`focus`来使输入框重新获取焦点),例如在确认按钮上使用:```@touchend.prevent="onTap"``` +- 如需禁止点击其他位置收起键盘的默认行为,可以监听`touch`事件并使用`prevent`修饰符(仅支持App、H5,其他平台可以通过设置`focus`来使输入框重新获取焦点),例如在确认按钮上使用:```@touchend.prevent="onTap"``` #### 关于软键盘收起的逻辑说明 diff --git a/docs/component/textarea.md b/docs/component/textarea.md index 938d8409751834589ea509b49133bcd399ad90f7..6b48693c2f8e9027172703d540240751aad29daf 100644 --- a/docs/component/textarea.md +++ b/docs/component/textarea.md @@ -80,7 +80,7 @@ export default { - H5 平台只能在用户交互时修改 focus 生效。 - 如果遇到 focus 属性设置不生效的问题参考:[组件属性设置不生效解决办法](/vue-api?id=_4-组件属性设置不生效解决办法) - 软键盘的弹出和收起逻辑,详见[input的文档](/component/input?id=app%E5%B9%B3%E5%8F%B0ios%E7%AB%AF%E8%BD%AF%E9%94%AE%E7%9B%98%E4%B8%8A%E6%96%B9%E6%A8%AA%E6%9D%A1%E5%8E%BB%E9%99%A4%E6%96%B9%E6%A1%88) -- 如需禁止点击其他位置收起键盘的默认行为,可以监听`touch`事件并使用`prevent`修饰符(仅支持App-v3、H5,其他平台可以通过设置`focus`来使输入框重新获取焦点),例如在确认按钮上使用:```@touchend.prevent="onTap"``` +- 如需禁止点击其他位置收起键盘的默认行为,可以监听`touch`事件并使用`prevent`修饰符(仅支持App、H5,其他平台可以通过设置`focus`来使输入框重新获取焦点),例如在确认按钮上使用:```@touchend.prevent="onTap"``` - js中给textarea组件赋值为字符串,在字符串中加\n可实现换行。 ``` diff --git a/docs/component/web-view.md b/docs/component/web-view.md index 91c8bd8261bc8e1d2cb2be8190e4ddf5468b5b5a..c3fe8657389bb4c180ba90fdc162382383440060 100644 --- a/docs/component/web-view.md +++ b/docs/component/web-view.md @@ -65,7 +65,7 @@ - App 端使用 uni.web-view.js 的最低版为 [uni.webview.1.5.2.js](https://js.cdn.aliyun.dcloud.net.cn/dev/uni-app/uni.webview.1.5.2.js) - App 平台同时支持网络网页和本地网页,但本地网页及相关资源(js、css等文件)必须放在 `uni-app 项目根目录->hybrid->html` 文件夹下或者 `static` 目录下,如下为一个加载本地网页的`uni-app`项目文件目录示例: - nvue `web-view` 必须指定样式宽高 -- V3 编译模式,网页向应用 `postMessage` 为实时消息 +- App 网页向应用 `postMessage` 为实时消息 - app-nvue `web-view` 默认没有大小,可以通过样式设置大小,如果想充满整个窗口,设置 `flex: 1` 即可,标题栏不会自动显示 `web-view` 页面中的 title。如果想充满整个窗口且想要显示标题推荐使用 vue 页面的 `web-view`(默认充满屏幕不可控制大小), 想自定义 `web-view` 大小使用 nvue `web-view`
diff --git a/docs/frame.md b/docs/frame.md
index 3551585b0d8d2d02cb2f809160a44c2186902125..139e6561bb78257ba889384c8ee81555a8f58b6d 100644
--- a/docs/frame.md
+++ b/docs/frame.md
@@ -748,7 +748,7 @@ const package = require('packageName')
 
 |App|H5|
 |:-:|:-:|
-|√(2.5.5+,仅支持vue,并要求v3编译器)|√|
+|√(2.5.5+,仅支持vue)|√|
 
 ### 使用方式
 
diff --git a/docs/matter.md b/docs/matter.md
index 989eeffc23ae11d51718304c5685bbab740061ba..e199ab1e40911d3bd3655c26d926146bf6791b28 100644
--- a/docs/matter.md
+++ b/docs/matter.md
@@ -47,17 +47,12 @@ App的js运行在jscore下而不是浏览器里,没有浏览器专用的js对
 6. 很多人在H5端联网时使用本地测试服务地址(localhost或127.0.0.1),这样的联网地址手机App端是无法访问的,请使用手机可访问的IP进行联网
 
 ### App正常,但H5异常的可能性
-2. App端使用了App特有的API和功能,比如subNVue、原生插件等
+* App端使用了App特有的API和功能,比如subNVue、原生插件等
 
 
 ### App正常,H5异常的可能性
 1. 代码中使用了App端特有的subNVue、原生插件等功能
 
-### App(v2)与App(v3)差异说明
-
-1. App(v2)默认template中使用了未定义或未初始化的数据,运行不会报错,且不影响后续节点渲染。App(v3)运行时,会直接告警,并报错(标准的vue渲染逻辑,同H5),且影响后续节点数据的渲染,错误信息通常显示为`undefined is not an object, evaluating(xxx.xxx.xxx)`
-2. App(v2)默认隔离组件样式(组件间样式不会互相影响),App(v3)版本默认不隔离。目前发现开发者v2升级v3反馈的样式问题大多由此导致,v3版本将于`2.6.14-alpha`进行调整默认隔离组件间样式。
-
 ### 使用 Vue.js 的注意
 
 1. `uni-app` 基于`Vue 2.0`实现,开发者需注意Vue 1.0 -> 2.0 的使用差异,详见[从 Vue 1.x 迁移](https://cn.vuejs.org/v2/guide/migration.html)
diff --git a/docs/nvue-outline.md b/docs/nvue-outline.md
index b3dafbf91965589581e7ec057d7ca606cf82c83e..0c2a4f02b50a1cfad43e012872dcd580a4affd10 100644
--- a/docs/nvue-outline.md
+++ b/docs/nvue-outline.md
@@ -34,7 +34,7 @@ nvue的组件和API写法与vue页面一致,其内置组件还比vue页面内
 7. 如深度使用```map```组件,建议使用nvue。除了层级问题,App端nvue文件的map功能更完善。
 8. 如深度使用```video```,建议使用nvue。比如如下2个场景:video内嵌到swiper中,以实现抖音式视频滑动切换,例子见[插件市场](https://ext.dcloud.net.cn/search?q=%E4%BB%BF%E6%8A%96%E9%9F%B3);nvue的视频全屏后,通过```cover-view```实现内容覆盖,比如增加文字标题、分享按钮。
 9. 直播推流:nvue下有```live-pusher```组件,功能更完善,也没有层级问题。
-10. 对App启动速度要求极致化。App端v3编译器模式下,如果首页使用nvue且在manifest里配置fast模式,那么App的启动速度可以控制在1秒左右。而使用vue页面的话,App的启动速度一般是3秒起,取决于你的代码性能和体积。
+10. 对App启动速度要求极致化。App端如果首页使用nvue且在manifest里配置fast模式,那么App的启动速度可以控制在1秒左右。而使用vue页面的话,App的启动速度一般是3秒起,取决于你的代码性能和体积。
 
 但注意,在某些场景下,nvue不如vue页面,如下:
 1. ```canvas```。nvue的canvas性能不高,尤其是Android App平台,所以这个组件干脆没有内置,而是需要单独引入。操作canvas动画,最高性能的方式是使用vue页面的renderjs技术,在hello uni-app里的canvas示例就是如此。
diff --git a/docs/performance.md b/docs/performance.md
index 4f3632f55a81fc75ead69b42ee68b08f59679859..ea6a6fa723dfc94c6974fdf9c3c1664146ead5ce 100644
--- a/docs/performance.md
+++ b/docs/performance.md
@@ -125,7 +125,7 @@ Android上popin动画时,老窗体会有一个半透明消失的效果。这
 ##### 优化启动速度
 
 * App端的 splash 关闭有白屏检测机制,如果首页一直白屏或首页本身就是一个空的中转页面,可能会造成 splash 10秒才关闭,可参考此文解决[https://ask.dcloud.net.cn/article/35565](https://ask.dcloud.net.cn/article/35565)
-* App端使用v3编译器,首页为nvue页面时,并设置为[fast启动模式](https://ask.dcloud.net.cn/article/36749),此时App启动速度最快。
+* App端,首页为nvue页面时,并设置为[fast启动模式](https://ask.dcloud.net.cn/article/36749),此时App启动速度最快。
 * App设置为纯nvue项目(manifest里设置app-plus下的renderer:"native"),这种项目的启动速度更快,2秒即可完成启动。因为它整个应用都使用原生渲染,不加载基于webview的那套框架。
 
 ##### 优化包体积
@@ -133,5 +133,4 @@ Android上popin动画时,老窗体会有一个半透明消失的效果。这
 * uni-app的H5端,自带了vue.js、vue-router及部分es6 polyfill库,这部分的体积gzip后只有92k,和web开发使用vue基本一致。而内置组件ui库(如picker、switch等)、js api等,相当于一个完善的大型ui库。但大多数应用不会用到所有内置组件和API。由此uni-app提供了摇树优化机制,未摇树优化前的uni-app整体包体积约500k,服务器部署gzip后162k。开启摇树优化需在manifest配置,[详情](https://uniapp.dcloud.io/collocation/manifest?id=optimization)。
 * uni-app的App端,因为自带了一个独立v8引擎和uni-app框架,所以比普通hybrid的App引擎体积要大。Android基础引擎约9M。App还提供了扩展模块,比如地图、蓝牙等,打包时如不需要这些模块,可以裁剪掉,以缩小发行包体积。在 manifest.json-App模块权限 里可以选择。
 * App端支持如果选择纯nvue项目(manifest里设置app-plus下的renderer:"native"),包体积可以进一步减少2M左右。
-* App端在HBuilderX 2.7后,App端下掉了非v3的编译模式,包体积下降了3M。
 * uni-app的App-Android端有so库的概念,支持不同的cpu类型的so库越多,包越大。在HBuilderX 2.7以前,Android app默认包含arm32和x86两个cpu的支持so库。包体积比较大。如果你在意体积控制,可以在manifest里去掉x86 cpu的支持(manifest可视化界面-App其他设置里选择cpu),这可以减少包体积到9M。从HBuilderX 2.7起,默认不再包含x86,如有需求请自行在manifest里勾选后打包。一般手机都是arm的,涉及x86 cpu场景很少,包括:个别少见的Android pad、as的模拟器里选择x86类型。