From 1732d10ab00885eadc1f213c204e894234122854 Mon Sep 17 00:00:00 2001 From: qiang Date: Fri, 27 Aug 2021 12:12:06 +0800 Subject: [PATCH] docs: use.md remove mp --- docs/use.md | 280 +++++++++++++++++++++++----------------------------- 1 file changed, 121 insertions(+), 159 deletions(-) diff --git a/docs/use.md b/docs/use.md index 295318d6c..954fc3b1b 100644 --- a/docs/use.md +++ b/docs/use.md @@ -5,11 +5,11 @@ ************************************** -``uni-app`` 在发布到H5时支持所有vue的语法；发布到App和小程序时，由于平台限制，无法实现全部vue语法，但``uni-app``仍是是对vue语法支持度最高的跨端框架。本文将详细讲解差异。 +``uni-app`` 在发布到H5时支持所有vue的语法；发布到App时，由于平台限制，无法实现全部vue语法，但``uni-app``仍是是对vue语法支持度最高的跨端框架。本文将详细讲解差异。 相比Web平台， ``Vue.js`` 在 ``uni-app`` 中使用差异主要集中在两个方面： - 新增：uni-app除了支持Vue实例的生命周期，还支持应用启动、页面显示等生命周期 -- 受限：相比web平台，在小程序和App端部分功能受限，具体见下。 +- 受限：相比web平台，在App端部分功能受限，具体见下。 - v3版本App端可以使用更多的vue特性，[详见](https://ask.dcloud.net.cn/article/36599) ## 生命周期 @@ -57,31 +57,10 @@ data() { } ``` -### 注意事项 -* 由于小程序端不支持更新属性值为 undefined，框架内部将替换 undefined 为 null，此时可能出现预期之外的情况（[相关反馈](https://github.com/dcloudio/uni-app/issues/1460)），需要自行判断一下。 - ## 全局变量 实现全局变量的方式需要遵循 Vue 单文件模式的开发规范。详细参考：[uni-app全局变量的几种实现方式](https://ask.dcloud.net.cn/article/35021) -## 其他配置 - -Vue 组件编译到小程序平台的时候会编译为对应平台的组件，部分小程序平台支持 options 选项（具体选项参考对应小程序平台文档的自定义组件部分），一般情况默认即可，如有特殊需求可在 Vue 组件中增加 options 属性。 - -```js -export default { - props: ['data'], - data(){ return { } }, - options: { - // 微信小程序中 options 选项 - multipleSlots: true, // 在组件定义时的选项中启动多slot支持，默认启用 - styleIsolation: "isolated", // 启动样式隔离。当使用页面自定义组件，希望父组件影响子组件样式时可能需要配置。具体配置选项参见：微信小程序自定义组件的样式 - addGlobalClass: true, // 表示页面样式将影响到自定义组件，但自定义组件中指定的样式不会影响页面。这个选项等价于设置 styleIsolation: apply-shared - virtualHost: true, // 将自定义节点设置成虚拟的，更加接近Vue组件的表现。我们不希望自定义组件的这个节点本身可以设置样式、响应 flex 布局等，而是希望自定义组件内部的第一层节点能够响应 flex 布局或者样式由自定义组件本身完全决定 - } -} -``` - ## Class 与 Style 绑定 为节约性能，我们将 ``Class`` 与 ``Style`` 的表达式通过 ``compiler`` 硬编码到 ``uni-app`` 中，支持语法和转换效果如下： @@ -231,7 +210,6 @@ export default { ### 注意事项 * 在H5平台 使用 v-for 循环整数时和其他平台存在差异，如 `v-for="(item, index) in 10"` 中，在H5平台 item 从 1 开始，其他平台 item 从 0 开始，可使用第二个参数 index 来保持一致。 * 在非H5平台 循环对象时不支持第三个参数，如 `v-for="(value, name, index) in object"` 中，index 参数是不支持的。 -* 小程序端数据为差量更新方式，由于小程序不支持删除对象属性，使用的设置值为 null 的方式替代，导致遍历时可能出现不符合预期的情况，需要自行过滤一下值为 null 的数据（[相关反馈](https://ask.dcloud.net.cn/question/103269)）。 ## 事件处理器 @@ -267,7 +245,7 @@ export default { -* 为兼容各端，事件需使用 ``v-on`` 或 ``@`` 的方式绑定，请勿使用小程序端的``bind`` 和 ``catch`` 进行事件绑定。 +* 为兼容各端，事件需使用 ``v-on`` 或 ``@`` 的方式绑定。 * 事件修饰符 * ``.stop``：各平台均支持， 使用时会阻止事件冒泡，在非 H5 端同时也会阻止事件的默认行为 * ``.native``：监听原生事件，仅在 H5 平台支持 @@ -395,24 +373,9 @@ export default { - `2.5.0+`版本支持在pages.json内引入组件，[详见](/collocation/pages?id=easycom) - **uni-app只支持vue单文件组件（.vue 组件）**。其他的诸如：动态组件，自定义 ``render``，和``