使用weex开发一个来月了,前前后后踩了不少坑,特此记录,以免遗忘
注意点
css
css
- weex 中默认的设计尺寸是750px
当真实屏幕不是750px时,weex会自动将设计尺寸映射到真实尺寸中去,即<meta name="weex-viewport" content="750">
——scale
scale = 当前屏幕尺寸 / 750
dpi = dp = px
会根据手机变化(相当于rem,是相对大小)
所以在扩展组件的时候,如果用户传入一个尺寸值,比如说 375,这个值是相对于 750 的设计尺寸来说的。你只需要将这个值乘以 scale, 就是适配当前屏幕的真实尺寸:value = 375 * this.data.scale. 它应该占据真实屏幕一半的大小。
- 样式需要使用class属性写,用id不支持,手机上可能显示不出来
- 图片需要指定大小才能显示,在移动端可以使用’wx’ 单位(相当于px),不会转化为rem,移动端支持’px’.
- iconfont 需要借助“dom”模块
var domModule = weex.requireModule('dom');
domModule.addRule('fontFace', {
'fontFamily': "iconfont",
'src': "url('http://at.alicdn.com/t/font_733844_kb66bfef25.woff')"
});
-
默认的HTML根元素的weex
font-size = 屏幕的宽度/10
-
中不支持阴影,设置weex
不起作用。box-shadow
- 样式表和CSS规则是由weex.js框架和原生渲染引擎管理的,处于性能考虑,weex目前支持在、单个类选择器,并且只支持CSS规则的子集。
- weex
支持线性渐变,不支持径向渐变
-
box-shadowweex中的
box-shadow仅仅支持IOS。 需要给容器的背景手动添加颜色,否则在IOS中背景颜色就是
的颜色。
-
不支持媒体查询`weex
-
组件设置image
为1后,就可以不用设置flex
和width
,可以自适应屏幕尺寸.height
- 使用绝对定位,不一定和web页面的显示一样。在tab页面使用fixed定位时,web中,固定定位的元素是根据第一个tab页面的左边源。而在安卓中是根据屏幕的左侧。
- 如果定位元素超过容器边界,在 Android 下,超出部分将不可见,原因在于 Android 端元素 overflow 默认值为 hidden,但目前 Android 暂不支持设置 overflow: visible。
- fixed定位的元素z轴位置会比较高
- position、transform:改变tab层的位置,此方法在定位为
的子元素上依然无效。position:fixed;
- 在APP上 fixed层级最高,但是fixed容器不能滚动。。。。。。
- 给style传多个字符串,在APP不能正确显示颜色,需要传递对象
- 使用 border 实现的三角形,在 native 环境中是不起作用的,即使样式分开写了,也是不起作用,weex 环境中使用三角形,建议使用 svg。
- input 组件设置disabled属性需要写成
不能采用web中的简写方式。<input type="text" disabled="true">
Weex
页面跳转
Weex
Weex 使用原生的navigator来管理页面实例,多个实例之间的状态是隔离的。也就是说,vuex和vue-router智能作用于当前一个页面,无法在多个页面间共享状态。
在项目中我也就没有使用
vue-router
和
vuex
. 使用自己写的
router.js
统一管理项目中的页面跳转。在页面传递简单的参数时,附加加URL后面,当需要在2个页面间传递复杂的对象时,暂时将2个页面合成一个tab页面实现页面跳转。
安卓native
android APP 项目中本地资源文件读取是要使用file:///协议,安卓版本不同,配置可能不同。默认地址是
file:///android_asset
,所以在项目中的js引用图片时要使用此地址
在页面跳转时,可以不用直接使用
file:///pages/homeIndex.js
,不用加
android_asset
是因为在activity类中做了解析.
android Studio 编译时提示 Error: Please select android sdk.
解决方法
与Vue的不兼容点
- v-bind:class可以普通class共存,但是v-bind:class只支持数组形式的语法,另外的两种形式对象和字符串都不支持
- weex官网文档写着支持vue的标签,实际上并不支持
显示和隐藏
-
的weex
只支持display
,所以无法设置flex
, 自然display: none
的vue
指令也不支持. 但是v-show
的vue
可以使用, 需要注意的是,v-if
v-if
最好只用来做页面结构的控制, 而不要偷懒作为显示隐藏的手段。
最佳实践:用
做页面结构控制,显示隐藏使用css的v-if
visibility
属性来控制
用
显示和隐藏单元素正常,但是对稍微复杂点的组件在显示的时候会出现抖动,解决方式参考写的另一篇文章解决组件用v-if
显示时出现的抖动问题v-if
- weex不支持
和overflow-x
, iOS下支持overflow-y
,默认为visible;Android下overflow
默认为overflow
,且无法设置为hidden
。visible
- opacity、visablity:此处需要注意,Weex的渲染机制和web是有区别的,对父层设置opacity或者visiablity隐藏是无法同时隐藏定位为
的子元素。position:fixed;
js
weex 中不支持Promise的finally方法,支持then和catch**
image组件的load方法在android下失效,且在android下圆角无法设置,安卓端可以自己写一个组件个weex使用
组件中有input组件时,如果给input初始化一个值,且绑定一个onInput事件,则在安卓中会执行onInput函数。而在web中不会
new Date(time)
time
在安卓中不能解析
xxxx-xx-xx
格式的时间参数,可以传
20180101
格式的
但是在传
20180101
格式的时间时注意不能传字符串,需要转化为整型,且必须为是时间戳
可以使用
2018,1,1
格式,注意不能为
2018,01,01
weex-nat 模块使用注意点
- 由于项目中需要上传文件到服务器,所以用到weex-nat模块的transfer模块,但是此模块只支持一次上传一个文件。并且文件流的
属性已经被写死为name
file
- 调用weex-nat 的image和camera模块时,回调函数不自动执行。需要在相应的安卓项目的activity中重写
方法。onActivityResult
/**
* 为了执行WXModule扩展模块中定义的{@link com.taobao.weex.common.WXModule#onActivityResult(int, int, Intent)}
* */
@Override
protected void onActivityResult(int requestCode, int resultCode,
Intent data)
{
super.onActivityResult(requestCode, resultCode, data);
if (mWXSDKInstance != null)
{
mWXSDKInstance.onActivityResult(requestCode, resultCode, data);
}
}
}