微信小程序开发教程

一、开发前准备
申请账号、安装开发者工具
二、文件与目录结构
1、程序主体：
app.js
app.json 程序配置
1.1、程序配置

    pages 页面路径
     window 页面的窗口表现
     tabBar 底部tab切换
     networkTimeout
     debug
        {
                 "pages":[  //哪个写在上面，哪个就是入口文件
                        "pages/index/index",
                        "pages/movie/movie",
                        "pages/logs/logs"
                 ]
        }

app.wxss 公共样式
2、页面：
index.js
index.json 页面配置
2.1、页面配置
window 页面的窗口表现
index.wxss 页面样式
index.wxml 页面结构
三、注册程序与页面
1、注册app，只需要注册一次，可以得到一个程序的实例，可以被其他页面访问
在其他页面，通过getApp全局函数获取应用实例 const app = getApp(); 获取全局数据：app.gldData; //{a:1}

App({
    gldData:{ a:1 },
    onLaunch:function(){  //一运行小程序就会执行
        //初始化代码
    }
})
2、注册page，有几个页面，在每个页面内都需要注册
Page({
    data:{
        b:2
    },
    onLoad:function(){   //一进入页面就会执行
        console.log( this.data )  //{b:2}  通过this，获取单个页面内数据
    }
})

四、程序生命周期
1、App

App({

  //在小程序运行期间，只会执行一次
    //程序销毁之后(过了一段时间没有运行或者手动删除小程序)，再次启动小程序就会执行
    onLaunch(){
        console.log('小程序启动时执行')
    },
    //每次从后台切换出来就会执行
    onShow(){
        console.log('切换到小程序时执行')
    },
    //每次切换到后台就会执行
    onHide(){
        console.log('小程序被隐藏在后台时执行')
    }
})

2、Page

Page({
    //tab之间的切换，不会让页面重新加载，也不会卸载，只会让页面显示与隐藏
    //在进行NavigatorTo链接跳转的时候，目标页面会被加载onLoad，原始页面会被隐藏onHide
    //此时点击导航条上的回退按钮NavigatorBack，目标页面会onShow，不会onLoad，原始页面会被卸载onUnload

    //页面加载的时候执行，只会执行一次
    onLoad(){   },
    //页面第一次渲染完成之后执行，只会执行一次
    onReady(){  },
    //页面显示就会执行，会执行多次，比如tab切换从a页面切换到b页面，那么也就是等于b页面显示了
    onShow(){   },
    //页面隐藏就会执行，会执行多次，比如tab切换从a页面切换到b页面，那么也就是等于a页面隐藏了
    onHide(){   },
    //页面卸载的时候执行，只会执行一次
    onUnload(){ },
})

五、数据与列表渲染
1、数据在index.js里面的data里面定义，

Page({
    data:{ //数据类型，可以是字符串、数组、对象、数值等等
        name:'kate'
    }
})
要输出到页面上，直接就是<view>{{name}}</view>即可

2、渲染数组 wx:for wx:key

Page({
    data:{ 
        names:[ 'kate','jim','lily' ],
        age:['1','2','3']
    }
})
<view wx:for="{{names}}" wx:key="*this">{{item}}</view>

3、条件渲染 变量为true，即满足条件就进行渲染，反之就不进行渲染

<view wx:if="{{ score>60 && score<90 }}">等级B</view> 
<view wx:elif="{{ score<60 && score>0 }}">等级C</view>
<view wx:else>等级A</view>

4、块级渲染block，block是虚拟组件，不会出现在页面上
同时显示多个元素

<block wx:if="{{ score==80 }}">
    <view>{{ name }}</view>
    <view>{{ score }}</view>
    <view>等级A</view>
</block>
<block wx:else>
    <view>{{ name }}</view>
    <view>{{ score }}</view>
    <view>等级B</view>
</block>

5、使用模板

Page({
    data:{ 
        names:[ 'kate','jim','lily' ],
        age:['1','2','3'],
    score:80,
    name:'aaa'
    }
})
先定义模板：
<template name="myTemplate1">
    <view>我是模板</view>
    <view>{{name}}</view>
</template>

<template name="myTemplate2">
    <block wx:for="{{age}}" wx:key="*this">
        <view>{{item}}</view>   
        <view>啦啦啦</view>
    </block>
</template> 

<template name="myTemplate3">
    <block wx:if="{{score==80}}">
        <view>{{name}}</view>   
        <view>{{score}}</view>
        <view>等级A</view>
    </block>
    <block wx:else>
        及格
    </block>
</template> 

使用：
<view>
    <template is="myTemplate1" data="{{name:'kate'}}"></template>
    <template is="myTemplate2" data="{{age:age}}"></template>
    <template is="myTemplate3" data="{{name,score}}"></template> //data="{{name,score}}等价于data="{{name:name , score:score}}
</view>

6、import与include
可以把模板定义在专门的template.wxml里面
要使用里面的模板，只需要在对应的wxml里面
<import src="template.wxml" /> //import引入的模板，你需要在页面上告知使用的是哪一个模板，<template is="myTemplate1" data="{{name:'kate'}}"></template>
<include src="template.wxml" /> //include引入模板，在页面上什么位置写上，那么模板代码就在什么地方显示

六、事件
绑定事件

<view bind:tap="tabHandle" data-name="容器">
    <text>点击</text>
</view>
tabHandle(event){
    //event：是事件对象，里面有detail等属性
    //target：事件从哪里触发的
    //currentTarget：事件在哪个上面执行的，通过event.currentTarget.dataset.name可以获取到到"容器"这个自定义值
    //比如点击text，那么target就是text，currentTarget是外面的view，因为冒泡了，所以尽管点击text，tabHandle事件仍然会触发
}
如果要阻止事件冒泡，那么就使用catch，而不是bind，如：
<view catch:tap="tabHandle">
    <text>点击</text>
</view>

这样点击text，tabHandle事件仍然会触发，但是view上一级就不会冒泡上去了，因为阻止冒泡了
七、样式wxss
尺寸单位：rpx，只要设置宽度为750rpx，那么不管在什么手机上都是占满一整个屏幕
引入样式：@import '../style.wxss'
全局样式与局部样式：定义在 app.wxss 中的样式为全局样式，作用于每一个页面。在 page 的 wxss 文件中定义的样式为局部样式，只作用在对应的页面，并会覆盖 app.wxss 中相同的选择器。
八、微信小程序脚本语言wxs
不支持es6的语法，就当成es5的javascript

定义(写在模板页面内)：
<wxs module="tool">  
    function createName(names){
        return names.split(',')
    }
    module.exports = createName
    //tool就表示导出的函数createName
</wxs>
使用：
<view wx:for="tool('1,2,3,4')">{{item}}</view>

也可以将wxs代码写在一个单独的.wxs文件内，然后引入这个文件，类似于js
tool.wxs
function createName(names){
        return names.split(',')
    }
module.exports = createName
模板页引入：<wxs src="tool.wxs" module="tool"></wxs>
使用：<view wx:for="tool('1,2,3,4')">{{item}}</view>

九、更新页面data数据

data:{
    number:1
}
onTap(){
    this.data.number = 2;  //错误
    this.setData({
        number:2;  //正确
    })
}

总结：使用setData可以更改data里面的数据（同步更新），然后视图也会更新（异步更新）
不是更改一个data，视图就马上更新，而且确定data不会更改之后，将所有更改的data一次性渲染到视图（尽管是异步更新，时间间隔仍然很短）

十、组件
页面由组件组成
view、text就是一个组件，只不过没有样式
看文档学习微信小程序内置组件
https://developers.weixin.qq.com/miniprogram/dev/component/

十一、自定义组件
举例说明：新建magicNumber.组件
首先：创建magicNumber.文件夹，里面创建magicNumber.wxml、magicNumber.wxss、magicNumber.js和magicNumber.json文件

magicNumber.wxml文件：
<view class="pressBtn" id="view" data-name="容器">
        {{nowIn}}
    <view>{{magicNumber}}</view>
    <text id="text" data-name="文字" bind:tap="onTap">点击显示magicNumber值</text>
</view>
magicNumber.json文件：
{
    "component":true
}
magicNumber.js文件：
这里是注册组件，不是注册页面，所以不能是Page({})，而是：
Component({
    properties:{
        nowIn:String
    },
    data:{
        magicNumber:Math.random(),
    },
    attached(){  //默认一上来就触发一次getMagicNumber事件，这样父组件监听到触发了，也会马上触发他的getMagicNumberHandle事件，所以一上来就默认更新了
        this.triggerEvent('getMagicNumber',this.data.magicNumber)
    },
    methods:{  //子组件的事件写在methods里面
        onTap(event){
            this.setData({
                magicNumber:Math.random()
            })
            this.triggerEvent('getMagicNumber',this.data.magicNumber)  //第二个参数是传到父组件的值
            //子组件向父组件传值，通过自定义事件，使用triggerEvent，告知父组件，该修改某个值了，点击的时候，传达一些信息过去，这里传过去this.data.magicNumber这个值，也可以传递对象过去，作为第二个参数
            console.log(event.currentTarget.dataset.name)  //获取到data-name="文字"里面的"文字"
        }
    }
})

组件注册完毕，接下来是在某个页面进行使用
假如在index页面使用，首先在index文件夹下面创建index.json文件，里面配置：

{
  "usingComponents": {
    "magic-number":"/pages/magicNumber/magicNumber"
  }
}
使用：index.wxml

<view class="container">
  <magic-number  now-in="首页" bind:getMagicNumber="getMagicNumberHandle"></magic-number>
  <view>{{num}}</view>
</view>
index.js
Page({
    data:{
        num:Math.floor(maN*1000)
    },
    getMagicNumberHandle(event){  //监听子组件的getMagicNumber事件，一旦触发了，马上做出回应
                console.log(event.detail);  传过来的信息可以通过【事件对象】event.detail获取到
                this.setData({
                    num:Math.floor(event.detail*1000)  //这里就是处理了从子组件拿到的值
                })
        }
})

十二、路由
两种方式实现导航的跳转
1、navigator内置导航组件
url：要跳转的页面地址
open-type：跳转方式，有5种方式
navigate：默认跳转方式
redirect：重定向
switchTab：跳到某个tab
navigateBack：回退
reLaunch：重加载

• 页面切换，open-type="navigate"
  index.html

  <view>
  <navigator url="/pages/about/about" open-type="navigate">About</navigator>
  <navigator url="/pages/movie/movie" open-type="navigate">Movie</navigator>  
  <navigator url="/pages/logs/logs" open-type="switchTab">Logs</navigator>  //tab切换
  <navigator open-type="navigateBack">回退</navigator>  //回退到上一个页面
  <navigator url="/pages/movie/movie" open-type="redirect">重定向到Movie</navigator> 上方有回退按钮
  <navigator url="/pages/movie/movie" open-type="reLaunch">reLaunch</navigator> 上方没有回退按钮
  </view>

  ★logs属于底部tab，不可使用navigate跳转，只能使用下面的tab切换进行跳转

2、api跳转
wx.navigateTo(object) 跳转到
wx.redirectTo(object) 重定向
wx.switchTab(object) 跳到某个tab
wx.navigateBack(object) 回退
wx.reLaunch(object) 重加载

about.wxml
<view bind:tap="goMovie">使用api跳转到movie</view>
about.js
Page({
    goMovie(){
        wx.navigateTo({
            url:'/pages/movie/movie'
        })
    }
})

十三、授权与用户信息授权

• 获取用户昵称、性别，头像等等，需要在页面上先放置一个button，即授权button，用户点击确认之后才可以获取用户信息
  1、通过按钮来获取用户信息
  <button open-type="getUserInfo" bindgetuserinfo="onGetUserInfo">获取用户信息</button>
  如果开始用户没有点击授权，会弹出一个弹框，用户可以选择授权或者不授权，点击授权，通过回调函数onGetUserInfo，里面有事件对象event，可以获取到用户的信息

2、通过普通点击事件获取
在用户未授权过的情况下调用此接口，将不再出现授权弹窗，会直接进入 fail 回调。在用户已授权的情况下调用此接口，可成功获取用户信息。所以，最好先使用button来获取用户信息

<button bind:tap="getUserInfo">获取用户信息</button>
getUserInfo(ev){
    wx.getUserInfo({
        success:(msg)=>{
            console.log(msg)
        },
        fail:(err)=>{
            console.log(err)
        }
    })
  }

★通过普通点击事件获取用户api，不会出现提醒授权弹框

• 获取其他信息，如位置等等的，需要先调取wx.authorize(object)的api，获取用户的授权， 然后再调用相关的api，直接获取信息，未授权先进行授权
  

案例：获取用户地理位置

<button bind:tap="getAuthorize">授权位置</button>  //这时候，仅仅是得到用户授权可以获取地理位置，具体的信息还一无所知，需要通过其他的api来获取最终的位置信息
getAuthorize(){
    wx.authorize({
        scope:'scope.userLocation',
        success:(msg)=>{
            console.log(msg)
        },
        fail:(error)=>{
            console.log(error)
        }
    })
  }
<button bind:tap="getLocation">获取位置信息</button>
getLocation(){
    wx.getLocation({
        success:(msg)=>{
            console.log(msg)
        },
        fail:(error)=>{
            console.log(error)
        }
    })
  }
    <button bind:tap="getSetting">获取授权信息</button>  //查看哪些用户信息已经授权可以使用
    getSetting(){
        wx.getsetting({
            success:(msg)=>{
            console.log(msg,'授权相关信息')
        }
        })
    }
    <button bind:tap="openSetting">打开授权信息面板</button>  //用户第一次拒绝授权地理位置等信息，
    //后续授权确认弹框将不再出现，这里可以手动打开授权信息面板，如图所示，用户手动设置完成之后回退回去，会执行下面的方法
    openSetting(){
        wx.opensetting({
            success:(msg)=>{
            console.log(msg,'设置相关信息完成')
        }
        })
    }

十四、使用缓存
在movie页面缓存数据
使用缓存，多个页面从而可以共享一些数据，但是使用起来需要慎重
异步缓存数据：

<button bind:tap="onCache">缓存数据</button>
    wx.setStorage({
            key:'name',  //缓存数据的键名
            data:{  //可以是字符串或者对象
                p1:'lin'
            },
            success:()=>{  //有回调函数，成功的时候才执行
                console.log('存储名字成功');
                wx.getStorage({  //获取缓存，可以同步或者异步
                    key:'name',
                    success:(data)=>{
                        console.log(data)
                    }
                })
            }
        })
    }

同步缓存数据：

wx.setStorageSync('names','kate');
let names = wx.getStorageSync('names');
console.log(names);

在about页面获取缓存数据，同步获取缓存数据

{{name}}
<button bind:tap="getName">获取name</button>
Page({
    data:{
        name:''
    },
    getName(){
        let n = wx.getStorageSync('name');
        console.log(n);
        if(n){
            this.setData({
                name:n.p1
            })
        }
    }
})

移除缓存的数据，同步移除
<button bind:tap="removeName">移除缓存的name</button>
removeName(){
wx.removeStorageSync('names');
}

十五、请求与反馈，类似ajax，axios

<view bind:tap = "goRequest"></view>
goRequest(){
        wx.showLoading({ //一个loading动画，请求成功了会消失，下面已经定义了
            title:'请求中'
        });
        wx.request({
            url:''www.baidu.com,
            data:{  //给服务器传递请求数据
                name:‘joe’
            },
            methods:'post',  //默认是get请求
            success:(res)=>{
                console.log(res.data);
                //请求成功的反馈
                wx.showToast({
                    title:'请求已经成功'
                })
                //请求成功隐藏loading
                wx.hideLoading();
            },
            fail:(e)=>{
                wx.showToast({
                    title:e.errMsg
                })
            }
        })
    }

★详情-不校验域名合法域名

十六、微信小程序线上环境搭建

1、注册并且登录腾讯云-解决方案-微信小程序-关联账号
2、上传代码

【总结】：
父组件向子组件传值，通过properties传值
子组件向父组件传值，通过自定义事件，使用triggerEvent，告知父组件，该修改某个值了，点击的时候，传达一些信息过去，这里传过去this.data.magicNumber这个值，也可以传递对象过去，作为第二个参数

零碎知识点
1、对象被转为字符串就变成了[ object object ]
2、VM1878:1 Component "pages/magicNumber/magicNumber" does not have a method "onTap" to handle event "tap".
一直显示这个，因为把methods写在了data{}里面，作死！！

3、微信开发者工具：清缓存可以清除用户登录信息