与Vue的不兼容点
虽然weex官方文档有列出来weex和Vue 2.0的不同之处,但是并不全,这里再补充下:
- v-bind:class可以普通class共存,但是v-bind:class只支持数组形式的语法,另外的两种形式对象和字符串都不支持
- weex官网文档写着支持vue的<transition>标签,实际上并不支持
- Android和iOS端的vue是内置的,无需import;而h5端的vue要用script标签在html页引入;这样可以是三端工程的代码都不用import vue
- 如果使用vuex的话,因为vuex导入的时候会检测window.vue是否存在,存在的话自动安装,而android和ios端并不会这样。所以要判断当前环境,如果非web平台,那么
Vue.use(Vuex)
与babel的不兼容
- 用babel转译ES6语法没有问题,但是使用babel-polyfill会导致运行不起来,而使用babel-runtime没有问题,所以要么用babel-plugin-transform-runtime,要么自行按需引入core-js(建议用这种,减少代码体积)
- 记得配置.babelrc,通过weex-toolkit创建的工程默认没有.babelrc,这会导致你的vue文件的es6代码不会被转译
定位
- fixed定位的元素z轴位置会比较高
显示和隐藏
- weex的display只支持flex,所以无法设置display: none,自然vue的v-show指令也不支持。但是vue的v-if可以使用,需要注意的是,v-if最好只用来做页面结构的控制,而不要偷懒作为显示隐藏的手段。实践开发中发现,带有圆角的图片使用v-if来显示->隐藏->再显示时,圆角效果会消失。
最佳实践:用v-if做页面结构控制,显示隐藏使用css的visibility属性来控制 - 用v-if显示和隐藏单元素正常,但是对稍微复杂点的组件在显示的时候会出现抖动,解决方式参考写的另一篇文章解决组件用v-if显示时出现的抖动问题
- weex不支持overflow-x和overflow-y;iOS下支持overflow,默认为visible;Android下overflow默认为hidden,且无法设置为visible。iOS和Android的overflow默认值差别,有可能会导致两端的展示效果不一致,比如对某个元素设置放大动画,可能iOS上正常展示,但是Android上超出父元素的动画部分不可见,这点要注意。
动画
- weex不支持css3的animation,但是其内部有一个animation的模块供我们以代码的方式来生成动画,animation的模块的大部分设置项名称和意义都能和css3的动画对应上,算是一个简化版,如果要把css3的动画移过来一般都是要做改动,甚至是动画的重实现。比如weex的动画不能设置运行次数,只运行一次,需要依靠动画完成回调自行处理;又如weex的动画不支持类似css3对动画关键帧在某个阶段的属性调整,也是只能依靠动画完成回调自己把一个大动画拆解成好几个小动画来拼接起来。
最关键的一点是:weex的动画完成之后,动画对象会保持在动画完成之后的状态,后续的动画都是在这个状态上继续的,但是代码中的属性设置的相对值都是相对于原来对象的。此外,动画完成后对原来的对象设置一些状态,然后再继续执行新动画,有可能这个状态并不反应在动画上。
最佳实践:一旦对象设置了动画,最后对象的其他状态都依靠动画函数来设置会比较有保证 - iOS的timingFunction默认是linear,而android默认是ease-in-out,所以最好设置下这个值,以统一效果
媒体
- weex不支持audio标签,只支持video标签
- iOS下会有控制条,即使把width和height都设为0,也还是会有控制条,所以要设opacity为0,才能把控制条隐藏掉。此外,不能把width和height都设置为0,因为android下video会不工作,所以至少要把width和height设为1px。还要设置position为absolute,以脱离布局流,以免影响后续元素的布局。
最后,总结下用video模拟audio的css设置:
position: absolute;
width: 1px;
height: 1px;
opacity: 0;
PS:用video标签手机发热比较明显。
图像
- weex不支持img而是使用image(这个标签是需要闭合的),且src要使用绝对url,不能使用相对url。
- 时刻记住一定要设置width和height,对于全屏图片的设置,利用weex.config.env的deviceWidth和deviceHeight计算出比例,再乘以750的布局宽度,即可得出布局高度
- weexpack添加的android和iOS工程,iOS支持base64的image,但是android和使用的图片处理库有关,默认使用Picasso,但是Picasso不支持base64图片;改用Fresco即可,在WXApplication中,把默认使用的ImageAdapter改成FrescoImageAdapter即可
文本
- 由于都是flex布局,所以weex元素都属于h5概念上的块级元素,而没有内联元素,所以不支持富文本。通过flex-direction: row和text来模拟,只能在text块级换行,效果比较糟糕。要想实现真正的富文本,还得自行对weex扩展。
- 和HTML5的语法不同,weex的标签语法要求符合XML形式,所以<input>这样的空标签需要闭合,可以是<input />这样的方式
事件
- weex中像click这样的事件默认是冒泡的,但是一旦链条上有元素监听了click事件,那么冒泡就到这个元素终止,像被自动调用了e.stopPropagation()一样;当然可以通过在根元素上设置bubble="true"来取消这种行为,让冒泡可以继续,同时通过e.stopPropagation()自行手动终止冒泡(App Store上下载的iOS版PlayGround自带的weex还是0.11版的,还没有这个函数)