Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
uni-app
提交
3ecaa645
U
uni-app
项目概览
DCloud
/
uni-app
4 个月 前同步成功
通知
731
Star
38707
Fork
3642
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
7
列表
看板
标记
里程碑
合并请求
1
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
uni-app
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
7
Issue
7
列表
看板
标记
里程碑
合并请求
1
合并请求
1
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
未验证
提交
3ecaa645
编写于
3月 26, 2020
作者:
W
wanganxp
提交者:
GitHub
3月 26, 2020
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Update use-weex.md
上级
856a8d8c
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
76 addition
and
2 deletion
+76
-2
docs/use-weex.md
docs/use-weex.md
+76
-2
未找到文件。
docs/use-weex.md
浏览文件 @
3ecaa645
...
...
@@ -563,20 +563,94 @@ canvas API使用,详见canvas文档。
-
nvue 页面只能使用 flex 布局,不支持其他布局方式。页面开发前,首先想清楚这个页面的纵向内容有什么,哪些是要滚动的,然后每个纵向内容的横轴排布有什么,按 flex 布局设计好界面。
-
原生开发没有页面滚动的概念,页面内容高过屏幕高度并不会自动滚动,只有部分组件可滚动(list、waterfall、scroll-view/scroller),要滚得内容需要套在可滚动组件下。这不符合前端开发的习惯,所以在 nvue 编译为 uni-app模式时,给页面外层自动套了一个 scroller,页面内容过高会自动滚动。(组件不会套,页面有recycle-list时也不会套)。后续会提供配置,可以设置不自动套。
-
文字内容,必须、只能在
`<text>`
组件下。不能在
`<div>`
、
`<view>`
的text区域里直接写文字。否则即使渲染了,也无法绑定js里的变量。
-
只有text标签可以设置字体大小,字体颜色。
-
布局不能使用百分比、没有媒体查询。
-
nvue 切换横竖屏时可能导致样式出现问题,建议有 nvue 的页面锁定手机方向。
-
支持的css有限,不过并不影响布局出你需要的界面,flex还是非常强大的。
[
详见
](
https://weex.apache.org/zh/docs/styles/common-styles.html#%E7%9B%92%E6%A8%A1%E5%9E%8B
)
-
不支持背景图。但可以使用image组件和层级来实现类似web中的背景效果。因为原生开发本身也没有web这种背景图概念
-
css选择器支持的比较少,
没有web丰富
。详见weex的样式文档
-
css选择器支持的比较少,
只能使用 class 选择器
。详见weex的样式文档
-
class 进行绑定时只支持数组语法。
-
nvue页面没有bounce回弹效果,只有几个列表组件有bounce效果,包括 list、recycle-list、waterfall。
-
Android端在一个页面内使用大量圆角边框会造成性能问题,尤其是多个角的样式还不一样的话更耗费性能。应避免这类使用。
-
nvue 的各组件在安卓端默认是透明的,如果不设置background-color,可能会导致出现重影的问题。
-
在 App.vue 中定义的全局js变量不会在 nvue 页面生效。globalData和vuex是生效的。
-
App.vue 中定义的全局css,对nvue和vue页面同时生效。如果全局css中有些css在nvue下不支持,编译时控制台会报警,建议把这些不支持的css包裹在条件编译里,
`APP-PLUS-NVUE`
-
nvue 切换横竖屏时可能导致样式出现问题,建议有 nvue 的页面锁定手机方向。
-
不能在 style 中引入字体文件,nvue 中字体图标的使用参考:
[
weex 加载自定义字体
](
https://weex.apache.org/zh/docs/modules/dom.html#addrule
)
。如果是本地字体,可以用plus.io的API转换路径。
-
目前不支持在 nvue 页面使用 typescript/ts。
-
nvue 页面关闭原生导航栏时,想要模拟状态栏,可以参考:
[
https://ask.dcloud.net.cn/article/35111
](
https://ask.dcloud.net.cn/article/35111
)
。但是,仍然强烈建议在nvue页面使用原生导航栏。nvue的渲染速度再快,也没有原生导航栏快。原生排版引擎解析json绘制原生导航栏耗时很少,而解析nvue的js绘制整个页面的耗时要大的多,尤其在新页面进入动画期间,对于复杂页面,没有原生导航栏会在动画期间产生整个屏幕的白屏或闪屏。
-
nvue 页面的布局排列方向默认为竖排(
`column`
),如需改变布局方向,可以在
`manifest.json`
->
`app-plus`
->
`nvue`
->
`flex-direction`
节点下修改,仅在
`uni-app`
模式下生效。
[
详情
](
https://uniapp.dcloud.io/collocation/manifest?id=nvue
)
。
-
nvue页面编译为H5、小程序时,会做一件css默认值对齐的工作。因为weex渲染引擎只支持flex,并且默认flex方向是垂直。而H5和小程序端,使用web渲染,默认不是flex,并且设置display:flex后,它的flex方向默认是水平而不是垂直的。所以nvue编译为H5、小程序时,会自动把页面默认布局设为flex、方向为垂直。当然开发者手动设置后会覆盖默认设置。
下面有些正确和错误的写法示例对比:
-
选择器仅支持class 选择器
```
css
/* 错误 */
#id
{}
.a
.b
.c
{}
.a
>
.b
{}
/* 正确 */
.class
{}
```
-
border 不支持简写
```
css
/* 错误 */
.class
{
border
:
1px
red
solid
;
}
/* 正确 */
.class
{
border-width
:
1px
;
border-style
:
solid
;
border-color
:
red
;
}
```
-
background 不支持简写
```
css
/* 错误 */
.class
{
background
:
red
;
}
/* 正确 */
.class
{
background-color
:
red
;
}
```
-
nvue的
`uni-app`
编译模式下,
`App.vue`
中的样式,会编译到每个
`nvue文件`
。对于共享样式,如果有不合法属性控制台会给出警告,可以通过条件编译
`APP-PLUS-NVUE`
屏蔽
`App`
中的警告。
```
css
/* 错误 */
/* 控制台警告:
WARNING: `border` is not a standard property name (may not be supported)
WARNING: `-webkit-transform` is not a standard property name (may not be supported)
*/
.class
{
border
:
1px
red
solid
;
-webkit-transform
:
scaleY
(
.5
);
}
/* 正确 */
.class
{
border-width
:
1px
;
border-style
:
solid
;
border-color
:
red
;
/* #ifndef APP-PLUS-NVUE */
-webkit-transform
:
scaleY
(
.5
);
/* #endif*/
}
```
## Android平台阴影(box-shadow)问题
Android平台weex对阴影样式(
`box-shadow`
)支持不完善,如设置圆角边框时阴影样式显示不正常、设置动画时在
`Android7`
上显示不正常等。为解决这些问题,从HBuilderX 2.4.7起,新增
`elevation`
属性(组件的属性,不是css样式)设置组件的层级,
`Number`
类型,层级值越大阴影越明显,阴影效果也与组件位置有关,越靠近页面底部阴影效果越明显
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录