diff --git a/docs/api/get-system-info.md b/docs/api/get-system-info.md index 4709dd33e921e030bf3ce2148fa809c38fc6d6f0..ae9dbff9b24b10d68dccc07f6e215bfda07f49ad 100644 --- a/docs/api/get-system-info.md +++ b/docs/api/get-system-info.md @@ -18,6 +18,8 @@ uni-app 提供了异步(`uni.getSystemInfo`)和同步(`uni.getSystemInfoSync`) 因本API涉及的信息越来越多，查询速度会逐渐变慢。由此拆解分出3个新API，[uni.getDeviceInfo](get-device-info.md)、[uni.getAppBaseInfo](get-app-base-info.md)、[uni.getWindowInfo](get-window-info.md)。新API包含的信息更多。 +微信小程序已经不推荐使用getSystemInfo，建议使用上述分拆的3个API。 + diff --git a/docs/dom/README.md b/docs/dom/README.md index 5d2f8578f8e034473296d3a88091bedec7720aba..65a25257468f34733efc29e94636d7f10f8eed4c 100644 --- a/docs/dom/README.md +++ b/docs/dom/README.md @@ -1,14 +1,16 @@ # UVUE DOM -App-uvue的每个页面，在内存中都有一个 DOM（文档对象模型）。它和浏览器的 [DOM规范](https://www.w3.org/DOM/?spm=a2c7j.-zh-docs-api-weex-variable.0.0.2a5537c6FrgbYp) 类似。 +每个uvue页面，在内存中都有一个 DOM（文档对象模型）。它和浏览器的 [DOM规范](https://www.w3.org/DOM/?spm=a2c7j.-zh-docs-api-weex-variable.0.0.2a5537c6FrgbYp) 类似。 DOM 是页面元素内容的结构数据。DOM 模型用一个逻辑树来表示一个页面文档，树的每个分支的终点都是一个节点，每个节点都对应一个节点对象（UniElement）。 -实际上 app-uvue 的template、数据绑定，在底层调用的也是 DOM API。 +实际上 uvue 的template、数据绑定，在底层调用的也是 DOM API。 在浏览器中，开发者一旦跳过vue框架直接操作dom，vue框架将无法管理相应dom，开发者需要注意两端的冲突。 -在 App 端，为了减少冲突，目前不支持通过 DOM API 创建和删除 DOM 树中的元素。只支持获取元素UniElement。 +为了减少冲突，目前不支持通过 DOM API 创建和删除 DOM 树中的元素。只支持获取元素UniElement。 + +DOM在Web、Android、iOS、微信小程序均存在。微信小程序受微信限制，只实现了部分DOM API，请注意兼容性表格。 > HBuilderX4.0 开始DOM元素的类型统一调整为 UniElement 对象。废弃之前 HBuilderX 3.91 的 Element对象 和 HBuilderX 3.91以前的 INode 对象。 @@ -66,7 +68,7 @@ export default { ``` ### 通过this.$refs获取DOM元素@refs -app-uvue页面中可以通过 vue 框架中的组件实例对象 [this.$refs](https://uniapp.dcloud.net.cn/tutorial/vue3-api.html#%E5%AE%9E%E4%BE%8B-property) 获取 DOM 元素对象。 +uvue页面中可以通过 vue 框架中的组件实例对象 [this.$refs](https://uniapp.dcloud.net.cn/tutorial/vue3-api.html#%E5%AE%9E%E4%BE%8B-property) 获取 DOM 元素对象。 首先需要为组件设置 ref 属性值，它类似于id： ```vue diff --git a/docs/mp/README.md b/docs/mp/README.md index 728c2c028f9f9eb177b3070012d942555bf8f822..4d4f518dde1b96f7ca99cbd93ea38030c84bbfed 100644 --- a/docs/mp/README.md +++ b/docs/mp/README.md @@ -1,9 +1,13 @@ # 编译到小程序端 -> 编译到微信小程序端新增于4.41版本 +> 新增于 HBuilderX 4.41+ uni-app x 项目在编译到小程序平台时，将部分特性对齐了web与app端，因此和非uni-app x项目编译到小程序端略有差异。 +## uts + +推荐使用uts跨端开发，但微信小程序上也支持js/ts。 + ## vue ### 组件启用virtualHost @@ -56,11 +60,11 @@ event.screenY ## css -### 默认样式 +### 样式重置 -为保证多端统一，uni-app-x编译到小程序端时，内置组件根元素带有一些默认样式，详情参考：[uvue css使用](../css/README.md)。 +App平台的ucss和webview的标准css略有差异。为保证多端统一，uni-app-x编译到小程序端时，会进行浏览器样式重置，内置组件根元素带有一些默认样式，详情参考：[uvue css使用](../css/README.md)。 -如果确实不需要ucss的样式覆盖来帮助对齐不同端的显示效果，可以在pages.json的globalStyle或对应的页面style内配置`enableUcssReset`为false来关闭ucss样式重置。参考：[page.json文档](../collocation/pagesjson.md) +如果你不开发App，且不需要样式重置，想使用原始的小程序样式，那么可以在pages.json的globalStyle或对应的页面style内配置`enableUcssReset`为false来关闭ucss样式重置。参考：[page.json文档](../collocation/pagesjson.md) ## skyline @@ -75,3 +79,7 @@ worklet函数暂不支持写在uvue、uts文件内，推荐从js文件内引用 ### 实体字符 uni-app x项目在编译到小程序端时，如果页面内静态的使用了实体字符`>、<、 、 、 、 `则会在最终输出的小程序页面文件中保留这些实体字符，例如` `在微信小程序的wxml文件中仍为` `不会被转为空格， 而非uni-app-x项目` `会转为空格。 + +## 开发和调试 + +在HBuilderX底部状态栏选择语法平台，确保有微信小程序平台，否则代码提示不会有微信专有API。如果选择其他平台，但代码里在非MP-WEIXIN的条件编译里写了微信专有代码，ide会告警。