Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
良好的行为成为习惯
uni-app
提交
880f6cd5
U
uni-app
项目概览
良好的行为成为习惯
/
uni-app
与 Fork 源项目一致
Fork自
DCloud / uni-app
通知
1
Star
1
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
1
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
uni-app
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
1
Issue
1
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
880f6cd5
编写于
8月 07, 2019
作者:
W
wanganxp
提交者:
GitHub
8月 07, 2019
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update native-component.md
上级
a7506b19
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
13 addition
and
8 deletion
+13
-8
docs/component/native-component.md
docs/component/native-component.md
+13
-8
未找到文件。
docs/component/native-component.md
浏览文件 @
880f6cd5
#### 原生组件说明
为了提升性能,小程序和App架构下部分ui元素,比如导航栏、tabbar、video、map使用了原生控件
。
小程序和App的vue页面,主体是webview渲染的。为了提升性能,小程序和App的vue页面下部分ui元素,比如导航栏、tabbar、video、map使用了原生控件。这种方式被称为混合渲染
。
虽然提升了性能,但原生组件带来了其他问题:1) 前端组件无法覆盖原生控件的层级问题、2) 原生组件不能嵌入特殊前端组件(如scroll-view)、3) 原生控件无法灵活自定义。
H5、App的nvue页面,不存在混合渲染的情况,它们或者全部是前端渲染、或者全部是原生渲染,不涉及层级问题。
``uni-app``
中原生组件清单如下:
*
[
map
](
/component/map
)
*
[
video
](
/component/video
)
...
...
@@ -16,12 +18,13 @@
*
[
cover-view
](
/component/cover-view
)
*
[
cover-image
](
/component/cover-view?id=cover-image
)
#### 原生组件的使用限制
#### 混合渲染模式下原生组件的使用限制
由于原生组件脱离在 WebView 渲染流程外,因此在使用时有以下限制:
*
原生组件的层级是
**最高**
的,所以页面中的其他组件无论设置 z-index 为多少,都无法盖在原生组件上。后插入的原生组件可以覆盖之前的原生组件。
*
原生组件无法在 scroll-view、swiper、picker-view、movable-view 中使用(微信基础库2.4.4起支持了原生组件在 scroll-view、swiper、movable-view 中的使用)
*
原生组件无法在 scroll-view、swiper、picker-view、movable-view 中使用(微信基础库2.4.4起支持了原生组件在 scroll-view、swiper、movable-view 中的使用
,即原生组件的同层渲染;App-nvue 2.1.5也实现了同层渲染了
)
*
部分CSS样式无法应用于原生组件,例如:
*
无法对原生组件设置 CSS 动画;
*
无法定义原生组件为 position: fixed;
...
...
@@ -30,24 +33,26 @@
#### 其他原生界面元素
除了原生组件外,uni-app在非H5端还有其他原生界面元素,清单如下:
*
原生导航栏和tabbar(pages.json里配置的)
*
原生导航栏和tabbar(pages.json里配置的)
。
*
web-view组件虽然不是原生的,但这个组件相当于一个原生webview覆盖在页面上,并且小程序上web-view组件是强制全屏的,无法在上面覆盖前端元素
*
弹出框:picker、showModal、showToast、showLoading、showActionSheet、previewImage、chooseImage、chooseVideo等弹出元素也无法被前端组件覆盖
*
plus下的plus.nativeObj.view、plus.video.LivePusher、plus.nativeUI、plus.webview,层级均高于前端元素
注意:app的nvue页面里的组件虽然不涉及map、video等原生组件的层级遮挡问题,但上述“其他原生界面元素”,一样是nvue里的组件也无法遮挡的。
#### vue页面层级覆盖解决方案
为了解决原生组件层级最高的限制,uni-app提供了
[
cover-view
](
/component/cover-view
)
和
[
cover-image
](
/component/cover-view?id=cover-image
)
组件,让其覆盖在原生组件上。
为了解决
webview渲染中
原生组件层级最高的限制,uni-app提供了
[
cover-view
](
/component/cover-view
)
和
[
cover-image
](
/component/cover-view?id=cover-image
)
组件,让其覆盖在原生组件上。
除了跨端的cover-view,App端还提供了2种方案:plus.nativeObj.view、subNVue。详述如下
-
[
cover-view
](
https://uniapp.dcloud.io/component/cover-view?id=cover-view
)
cover-view
只能覆盖原生组件,不能覆盖其他原生界面元素。比如cover-view可以覆盖video、map,但无法覆盖原生导航栏、tabbar、web-view。
`cover-view`
只能覆盖原生组件,不能覆盖其他原生界面元素。比如cover-view可以覆盖video、map,但无法覆盖原生导航栏、tabbar、web-view。
微信小程序在基础库 2.4.0 起已支持 video 组件的同层渲染。也就是video在非全屏时,可以被前端元素通过调节zindex来遮挡。但video全屏时,仍需要cover-view覆盖。
cover-view在App端相比小程序端还有一些限制,1) 无法嵌套、 2) 无法内部滚动,即cover-view无法内部出现滚动条
vue页面的
`cover-view`
在App端相比小程序端还有一些限制,1) 无法嵌套、 2) 无法内部滚动,即cover-view无法内部出现滚动条、 3) 无法覆盖到视频的全屏界面。nvue页面的
`cover-view`
无这些限制。
另外cover-view无论如何都无法解决原生导航栏、tabbar、web-view组件的覆盖,为此App端补充了2个层级覆盖方案plus.nativeObj.view和subNVue
...
...
@@ -83,4 +88,4 @@ nvue页面全部都是原生组件,互相之间没有层级问题。
#### 总结
所以如果你的层级覆盖问题比较简单,不用嵌套,且有跨端需求,就使用cover-view。
如果App端cover-view无法满足需求,且需要覆盖的原生界面比较简单,可以用plus.nativeObj.view。否则,就使用subnvue吧。
\ No newline at end of file
如果App端cover-view无法满足需求,且需要覆盖的原生界面比较简单,可以用plus.nativeObj.view。否则,就使用subnvue吧。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录