使用mpvue开发小程序教程（五）

小灰灰 2024-04-17 05:32 72阅读 0赞

**【原文地址】**mpvue入门系列教程：

*  [如何在mpvue中正确的引用小程序的原生自定义组件][mpvue]
 *  [使用mpvue开发小程序教程（六）][mpvue 1]
 *  [使用mpvue开发小程序教程（五）][mpvue 2]
 *  [使用mpvue开发小程序教程（四）][mpvue 3]
 *  [使用mpvue开发小程序教程（三）][mpvue 4]
 *  [使用mpvue开发小程序教程（二）][mpvue 5]
 *  [使用mpvue开发小程序教程（一）][mpvue 6]

[在上一章节中][Link 1]，我们了解了组件的三个基本特性以及组件的基本使用方法。在实际的小程序开发中，我们应该以组件的思维去设计每个小程序的功能页面，对其进行合理的组件拆分，让每个部分都保持功能简洁、条理清楚、各司其职，这样会让代码变得更易理解和维护，间接的也提升了代码的健壮性，降低出现Bug的几率，即使出现Bug，也会更容易进行定位和调试。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BlbmdqdW5sZWU_size_16_color_FFFFFF_t_70][]

由于mpvue采用的是Vue框架的基础设施，所以大部分的功能都是和[Vue][]一致的。但是，mpvue的代码毕竟最终还是要转译成小程序原生框架下的代码的，由于小程序框架本身存在的一些功能限制，导致有些功能不能被翻译过去，也就是说有些标准的Vue功能在mpvue下是不可以使用或有特殊限制的。

今天我们就来罗列一下，在使用mpvue的时候那些需要特别注意的点。

**1. 在模板中，动态插入HTML的`v-html`指令不可用**

这条很好理解，小程序的界面并不是基于浏览器的BOM/DOM的，所以不能动态的在界面模板里直接插入HTML片段来显示。

题外话，如果有在小程序里插入html片段的需求怎么办？可以用`<rich-text>`组件或者`wxParse`([https://github.com/icindy/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)][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将是：

但是在mpvue下面这个特性也不能用，按官方说法是由于涉及到一些性能相关的原因。那如果要动态改变组件的`class`该怎么写呢？官方给出的方式是这样的：

其实改动不大，稍微多打了一些字而已，相当于在模板的`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: 0,
          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`等来进行。

[mpvue]: https://www.jianshu.com/p/1b3b9e17ac88
[mpvue 1]: https://www.jianshu.com/p/462494e458c2
[mpvue 2]: https://www.jianshu.com/p/579035fc9c18
[mpvue 3]: https://www.jianshu.com/p/32997f74c828
[mpvue 4]: https://www.jianshu.com/p/2c363ea29cda
[mpvue 5]: https://www.jianshu.com/p/2e98cc166dbd
[mpvue 6]: https://www.jianshu.com/p/6f8d74be3ff8
[Link 1]: https://blog.csdn.net/pengjunlee/article/details/100017997
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BlbmdqdW5sZWU_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/11/220936ee8d0f49d98aec316c4f8e4499.png
[Vue]: https://cn.vuejs.org/v2/guide/
[https_github.com_icindy_wxParse]: https://github.com/icindy/wxParse
[computed]: https://cn.vuejs.org/v2/guide/computed.html