由于mpvue采用的是Vue框架的基础设施,所以大部分的功能都是和Vue一致的。但是,mpvue的代码毕竟最终还是要转译成小程序原生框架下的代码的,由于小程序框架本身存在的一些功能限制,导致有些功能不能被翻译过去,也就是说有些标准的Vue功能在mpvue下是不可以使用或有特殊限制的。
今天我们就来罗列一下,在使用mpvue的时候那些需要特别注意的点。
1. 在模板中,动态插入HTML的v-html
指令不可用
这条很好理解,小程序的界面并不是基于浏览器的BOM/DOM的,所以不能动态的在界面模板里直接插入HTML片段来显示。
题外话,如果有在小程序里插入html片段的需求怎么办?可以用<rich-text>
组件或者wxParse
(https://github.com/icindy/wxParse)来实现。
2. 在模板中,用于数据绑定的双括号语法{{}}
中的表达式功能存在诸多限制
在Vue本身的模板内双括号语法中,我们可以对绑定变量进行比较丰富的处理,比如:
- 可以调用
methods
下的函数, 例如:
<template>
<div>{{ formatMessage(msg) }}</div>
</template> <script>
export default {
data() {
return {
msg: "Hello,World"
}
},
methods: {
formatMessage(str) {
return str.trim().split(',').join('#')
}
}
}
</script>
- 如果变量是对象的话,也可以调用对象的成员方法
<div>{{ msg.trim().split(',').join('#') }}</div>
- 可以使用过滤器来处理变量,最有用的场景算是格式化数据了
<div>{{ msg | format }}</div>
以上这些好用的功能,在mpvue中,记得都是通通不能用的哦!!!
我们只能在双括号中使用一些简单的运算符运算(+ - * % ?: ! == === > < [] .
)。
但是也得找些可用的替代方案呐,大伙先考虑使用计算属性(computed)来做吧。
3. 在模板中,除事件监听外,其余地方都不能调用methods
下的函数
在Vue中,模板里调用methods
部分定义的函数是非常常见的,比如下面这段代码所示,在v-if
指令中调用函数getErrorNum()
:
<div v-if="getErrorNum() > 0 && code == 10001" class="error">{{ errorMsg }}</div>
可是,在mpvue里就是不可以用!因为在小程序原生模板wxml
里就不支持这种函数调用,导致mpvue没有很好的方式转译过去(虽然小程序有wxs
,但是感觉翻译过去mpvue要做的工作会比较复杂)。
所以,可用的替代方案可能还是计算属性了。
4. 在模板中,不支持直接绑定一个对象到style
或class
属性上
在Vue中我们可以为HTML元素的class
或style
绑定一个对象,并按照对象内的属性值来决定是否添加对应的属性名到HTML元素的样式名。示例如下:
<template>
<div :class="classObject"></div>
</template> <script>
export default {
data() {
return {
classObject: {
active: true,
'text-danger': false
}
}
}
}
</script>
上面这段代码的运行后生成的HTML将是:
<div class="active"></div>
但是在mpvue下面这个特性也不能用,按官方说法是由于涉及到一些性能相关的原因。那如果要动态改变组件的class
该怎么写呢?官方给出的方式是这样的:
<div :class="{ active: classObject.active, 'text-danger': classObject['text-danger']}"></div>
其实改动不大,稍微多打了一些字而已,相当于在模板的class
里再定义一个对象罢了。但是据文档中说这样会提升性能。好吧,为了性能,这点麻烦还是能忍受的。但是它又说了:从性能考虑,建议不要过度依赖此......看来即使这样,也还是有性能问题。
看来最好一点的方案,还是得使用计算属性,直接生成一串样式的字符串,绑定到class
或style
上:
<template>
<div :class="classStr"></div>
</template> <script>
export default {
data() {
return {
classObject: {
active: true,
'text-danger': false
}
}
},
computed: {
classStr() {
let arr = []
for (let p in this.classObject) {
if (this.classObject[p]) {
arr.push(p)
}
}
return arr.join(' ')
}
}
}
</script>
5. 在模板中,嵌套使用v-for
时,必须指定索引index
通常,我们在Vue模板中嵌套循环渲染数组的时候,一般是这个样子的:
<template>
<ul v-for="category in categories">
<li v-for="product in category.products">{{product.name}}</li>
</ul>
</template>
但在mpvue中使用这种嵌套结构的v-for
时,则必须每层的v-for
上都给出索引,且索引需取不同名字:
<template>
<ul v-for="(category, index) in categories">
<li v-for="(product, productIndex) in category.products">{{product.name}}</li>
</ul>
</template>
6. 事件处理中的注意点
在mpvue中,一般可以使用Web的DOM事件名来绑定事件,mpvue会将Web事件名映射成对应的小程序事件名,对应列表如下:
// 左侧为WEB事件 : 右侧为对应的小程序事件
{
click: 'tap',
touchstart: 'touchstart',
touchmove: 'touchmove',
touchcancel: 'touchcancel',
touchend: 'touchend',
tap: 'tap',
longtap: 'longtap',
input: 'input',
change: 'change',
submit: 'submit',
blur: 'blur',
focus: 'focus',
reset: 'reset',
confirm: 'confirm',
columnchange: 'columnchange',
linechange: 'linechange',
error: 'error',
scrolltoupper: 'scrolltoupper',
scrolltolower: 'scrolltolower',
scroll: 'scroll'
}
除了上面的之外,Web表单组件<input>
和<textarea>
的change事件会被转为blur事件。
然后,像keydown
、keypress
之类的键盘事件也没有了,因为小程序没有键盘,所以不需要这些事件。
还有,Vue里面绑定事件的时候,可以指定事件修饰符,但是在mpvue里,官方给出了一些注意信息:
.stop 的使用会阻止冒泡,但是同时绑定了一个非冒泡事件,会导致该元素上的 catchEventName 失效!【这个亲测了一下,感觉是最新版本里修复了还是怎么的,没有文档里说的这个问题了】
.prevent 可以直接干掉,因为小程序里没有什么默认事件,比如submit并不会跳转页面【也就是不需要支持】
.capture 支持 1.0.9 【也就是在 mpvue 1.0.9及以后版本支持】
.self 没有可以判断的标识 【也就是不支持】
.once 也不能做,因为小程序没有 removeEventListener, 虽然可以直接在 handleProxy 中处理,但非常的不优雅,违背了原意,暂不考虑【也就是不支持】
所以呢,总之当你在遇到事件相关的问题,请回来查看一下文档,看看自己是否已经掉在坑里了。
7. 对于表单,请直接使用小程序原生的表单组件
一句话,表单组件又多又复杂,框架可能Hold不住。所以在实际开发中,推荐直接使用小程序的表单组件标签来写,而不是使用Web的表单组件标签来写。当然了,在mpvue中使用了小程序的组件标签,数据绑定功能还是完全可以用的。给个示例:
<template>
<div>
<picker @change="handlePickerChange" :value="selectedIndex" :range="messages">
<view class="picker">当前消息:{{ messages[selectedIndex] }}</view>
</picker>
</div>
</template> <script>
export default {
data () {
return {
selectedIndex: ,
messages: ['Hello', 'World', 'Haha']
}
},
methods: {
handlePickerChange (e) {
console.log(e)
}
}
}
</script>
其他注意事项
另外,在Vue开发Web应用的时候,通常使用vue-router
来进行页面路由。但是在mpvue小程序开发中,不能用这种方式,请使用<a>
标签和小程序原生API wx.navigateTo
等来做路由功能。
还有就是请求后端数据,我们通常在Web开发中使用axios
等ajax库来实现,但是在小程序开发中也是不能用的,也请使用小程序的原生API wx.request
等来进行。