天天看点

小程序学习---模块化编程

      只要是做过编程的童鞋都知道模块化的思想,这样写出的代码更加简洁明了。模块化的代码让你的思路更加清晰,有利于当前编程,同时还有利于后期的维护。另外,很多有公共作用的代码,理所应当的提炼出来,以提高代码利用率。很多时候一个模块不仅适用于当前的项目,其他项目中同样可以使用的。

一、文件的作用域

点击(此处)折叠或打开

// app.js

在app.js中定义全局变量

App({

  globalData: 1

})

//weather.js,在这个文件中你可以使用上面定义的全局变量

//首先,获取app实例,使用getApp()方法

var app = getApp()

//接着,你可以使用“.”方法来调用全局变量

app.globalData++

console.log(getApp().globalData)

二、使用模块化

可以将一些公共的代码抽离成为一个单独的 js 文件,作为一个模块。模块只有通过 module.exports 或者 exports 才能对外暴露接口。需要注意的是:

    1)exports 是 module.exports 的一个引用,因此在模块里边随意更改 exports 的指向会造成未知的错误。所以更推荐开发者采用 module.exports 来暴露模块接口,除非你已经清晰知道这两者的关系。

    2)小程序目前不支持直接引入 node_modules , 开发者需要使用到 node_modules 时候建议拷贝出相关的代码到小程序的目录中。来看下面提供的实例

// common.js 在这个js文件中定义两个函数,方便在其他js文件中使用

function sayHello(name) {

  console.log(`Hello ${name} !`)

}

function sayGoodbye(name) {

  console.log(`Goodbye ${name} !`)

//使用exports语法将上面定义的函数导出

//注意,另外一个js文件看到的是 sayHelloFun,不是sayHello

module.exports.sayHelloFun = sayHello

exports.sayGoodbyeFun = sayGoodbye

//weather.js 在这个文件中使用上面定义的函数

//实现要使用require语法来引用上面的js文件

//变量common中包含了上面导出的所有的东西

var common = require('common.js')

Page({

  helloMINA: function() {

     //使用”.”语法来调用导出的函数

    common.sayHelloFun('MINA')

  },

  goodbyeMINA: function() {

    common.sayGoodbyeFun('MINA')

  }

    注意:require目前不支持绝对路径,你使用相对路径

三、setData

   还记得每一个页面js文件吗,在它的Page中包含了一个data属性,我们说这个data里面放的就是页面的数据,如下:

  data: {

    temp: “28摄氏度”,

    array: [{msg: '1'}, {msg: '2'}]

    上面的代码很好,但是我们有一个问题,temp值不可能是预先定义好的,你可以看到temp这个key,但是它代表的温度值应该是动态加载的,会时刻发生变化。如何在js文件的其他地方来设置这个temp值呢?

   小程序提供setData方法来动态修改data内部的数据,它可以接收两个参数(ps:我们并不推荐直接使用“=”来赋值 )

    1)object 以 key,value 的形式表示将 this.data 中的 key 对应的值改变成 value。

    2)callback 是一个回调函数,在这次setData对界面渲染完毕后调用。

其中 key 可以非常灵活,以数据路径的形式给出,如 array[2].message,a.b.c.d,并且不需要在 this.data 中预先定义。

    需要注意下面几点

    1)直接修改 this.data 而不调用 this.setData 是无法改变页面的状态的,还会造成数据不一致。

    2)单次设置的数据不能超过1024kB,请尽量避免一次设置过多的数据。

    3)请不要把 data 中任何一项的 value 设为 undefined ,否则这一项将不被设置并可能遗留一些潜在问题。

    4)setData是异步执行的

    text: 'init data',

  //这是一个自定义函数,在这里我们可以修改data的数据

  changeText: function() {

    //

    this.setData({

       //修改text的内容

      text: 'changed data',

      //在data中增加了一个num,它对应的value是1

      num:1

    })

})

四、修改项目

1、之前的代码问题

   我们回顾一下之前的代码,可以看到weather.js文件中有大量的数据,这样让代码非常的不友好。首先,这样写让js文件很乱;其次,在一开始这是key并没有value,是后来动态获取的。

小程序学习---模块化编程

   2、提炼data

   我们将data中的数据单独提炼出来,放在另外一个js文件中(weather-data.js)。这里说一下我的习惯:

1)新建文件夹data,所有的数据文件都定义在这里

2)在data文件夹下面创建当前的weather-data.js文件

小程序学习---模块化编程

3)修改weather-data.js文件

//定义一个变量,这个变量包含了我们需要的所有的数据

var allData = {

    title: ["七天预报", "15天预报"],

    weatherData: [{

        date: "1-29",

        image: "/images/sun.png",

        state: "晴",

        temperature: "-11 ~ -1 ℃"

    },

    。。。。

    {

        date: "2-4",

        image: "/images/cloud.png",

        state: "阴",

        temperature: "-19 ~ -5 ℃"

    }]

};

 //将变量导出,名字为allData

//还是那句话,用户看到的是“=”左边的名字

module.exports.allData = allData

现在数据已经成功的提炼出来了,那么记下来就要使用这些数据了

   3、setData

//使用require语句引入js文件

//wData包含了weather-data.js中定义的所有的变量

var wData = require("../../data/weather-data.js");

    /**

     * 页面的初始数据

     */

    data: {

     * 生命周期函数--监听页面加载

    onLoad: function (options) {

        //给data中新增一个key→myData,它的value是wData.allData

        //注意,由于wData中不一定是一个变量,因此用“.”方法来调用其中的某一个

        this.setData({ myData: wData.allData});

继续阅读