只要是做过编程的童鞋都知道模块化的思想,这样写出的代码更加简洁明了。模块化的代码让你的思路更加清晰,有利于当前编程,同时还有利于后期的维护。另外,很多有公共作用的代码,理所应当的提炼出来,以提高代码利用率。很多时候一个模块不仅适用于当前的项目,其他项目中同样可以使用的。
一、文件的作用域
在 JavaScript 文件中声明的变量和函数只在该文件中有效;不同的文件中可以声明相同名字的变量和函数,不会互相影响。通过全局函数 getApp() 可以获取全局的应用实例,如果需要全局的数据可以在 App() 中设置。来看下面的代码
点击(此处)折叠或打开
- // 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里面放的就是页面的数据,如下:
点击(此处)折叠或打开
- Page({
- 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是异步执行的
点击(此处)折叠或打开
- Page({
- data: {
- 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");
-
- Page({
-
- /**
- * 页面的初始数据
- */
- data: {
-
- },
-
- /**
- * 生命周期函数--监听页面加载
- */
- onLoad: function (options) {
- //给data中新增一个key→myData,它的value是wData.allData
- //注意,由于wData中不一定是一个变量,因此用“.”方法来调用其中的某一个
- this.setData({ myData: wData.allData});
- },
-
- })