diff --git a/docs/mp/README.md b/docs/mp/README.md new file mode 100644 index 0000000000000000000000000000000000000000..2580d6be27336df7ca218563bde0145f431c452a --- /dev/null +++ b/docs/mp/README.md @@ -0,0 +1,61 @@ +# 编译到小程序端 + +> 新增于4.35版本 + +uni-app x 项目在编译到小程序平台时,将部分特性对齐了web与app端,因此和非uni-app x项目编译到小程序端略有差异。 + +## vue + +### 组件启用virtualHost + +uni-app x 项目在编译到小程序端时,启用了virtualHost,同时默认启用了[mergeVirtualHostAttributes特性](https://uniapp.dcloud.net.cn/collocation/manifest.html#mp-weixin)。 + +启用virtualHost会让组件在实际渲染时不会额外包裹一层dom节点。 + +mergeVirtualHostAttributes特性会将组件的 style、class 属性合并到根节点上。 + +### refs@refs + +非 uni-app x 项目使用refs取内置组件引用时会获取到undefined,而 uni-app x 项目会获取到对应的UniElement。 + +## dom + +### UniElement + +小程序端逻辑层与是图层分离,导致大多数同步的dom api都不可用。 + +UniElement在小程序端仅支持如下属性/方法: + +- id 元素的id属性 +- nodeName 元素的节点名 +- tagName 元素的标签名 +- style 元素的style对象,可以通过style对象调用style.setProperty方法 +- getBoundingClientRectAsync 异步获取元素的布局位置信息 +- getAttribute 获取元素的属性值,目前仅支持id、style + +### 事件 + +click、tap事件上补充了如下属性,使其表现更像PointerEvent: + +``` +event.x +event.y +event.clientX +event.clientY +event.pageX +event.pageY +event.screenX +event.screenY +``` + +## css + +### 默认样式 + +为保证多端统一,uni-app-x编译到小程序端时,内置组件根元素带有一些默认样式,详情参考:[uvue css使用](../css/README.md)。 + +## 其他差异 + +### 实体字符 + +uni-app x项目在编译到小程序端时,如果页面内静态的使用了实体字符`>、<、 、 、 、 `则会在最终输出的小程序页面文件中保留这些实体字符,例如` `在微信小程序的wxml文件中仍为` `不会被转为空格, 而非uni-app-x项目` `会转为空格。 diff --git a/docs/web/README.md b/docs/web/README.md index a283b287f01974a7d4ff35a4257775eb16eebd53..6c6b782c46c230ca5825e905038684c8a9d27e83 100644 --- a/docs/web/README.md +++ b/docs/web/README.md @@ -199,4 +199,4 @@ uni相关的异步api在web端不传回调时会返回promise(详情参考:[ ## 其他注意事项 -- 内置组件的tagName、nodeName与安卓端不同,目前web端和安卓端相比多了`UNI-`前缀,例如web端为`UNI-VIEW`、`UNI-IMAGE`,安卓端为`VIEW`、`IMAGE`。此问题已在HBuilderX 4.02版本修复,web端移除了UNI-前缀。 +- 4.02之前的版本内置组件的tagName、nodeName与安卓端不同,web端和安卓端相比多了`UNI-`前缀,例如web端为`UNI-VIEW`、`UNI-IMAGE`,安卓端为`VIEW`、`IMAGE`。此问题已在HBuilderX 4.02版本修复,web端移除了UNI-前缀。