Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-uni-app-x-zh
提交
621a312d
U
unidocs-uni-app-x-zh
项目概览
DCloud
/
unidocs-uni-app-x-zh
通知
144
Star
2
Fork
33
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
9
列表
看板
标记
里程碑
合并请求
11
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-uni-app-x-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
9
Issue
9
列表
看板
标记
里程碑
合并请求
11
合并请求
11
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
621a312d
编写于
11月 19, 2024
作者:
雪洛
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: 新增小程序开发文档
上级
d5c6a04c
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
62 addition
and
1 deletion
+62
-1
docs/mp/README.md
docs/mp/README.md
+61
-0
docs/web/README.md
docs/web/README.md
+1
-1
未找到文件。
docs/mp/README.md
0 → 100644
浏览文件 @
621a312d
# 编译到小程序端
> 新增于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项目
` `
会转为空格。
docs/web/README.md
浏览文件 @
621a312d
...
@@ -199,4 +199,4 @@ uni相关的异步api在web端不传回调时会返回promise(详情参考:[
...
@@ -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-前缀。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录