微信小程序基本语法

官网 https://developers.weixin.qq.com/miniprogram/dev/framework/
视频教程：尚硅谷微信小程序开发教程，2024最新微信小程序项目实战！
仿慕尚花坊项目源码：https://gitee.com/abcdfdewrw/flower-workshop

一，初识微信小程序

微信小程序是一种运行在微信内部的 轻量级 应用程序。

小程序的四大特性：无须安装，用完即走，无须卸载，触手可及。

二，文件和目录结构介绍

三，配置文件介绍

小程序中常见的配置文件有以下几种：
1，app.json : 小程序全局配置文件，用于配置小程序的一些全局属性和页面路由；
2，页面.json : 小程序页面配置文件，也称局部配置文件，用于配置当前页面的窗口样式，页面标题等；
3，project.config.json：小程序项目的配置文件，用于保存项目的一些配置信息和开发者的个人设置；
4，sitemap.json：配置小程序及其页面是否允许被微信索引，提高小程序在搜索引擎搜索到的概率。

四，尺寸单位rpx

rpx：是小程序新增的自适应单位，它可以根据不同的设备屏幕宽度进行自适应缩放；
小程序规定任何型号手机：屏幕宽都为750rpx

五，事件绑定和事件对象

【事件绑定】

【事件传参】

第一种方法：data-* 传参

第二种方法：mark：* 传参

六，事件/阻止事件冒泡

事件分为 冒泡事件 和 非冒泡事件；
冒泡事件：当一个组件的事件被触发后，该事件会向父节点传递；
非冒泡事件：当一个组件的事件被触发后，该事件不会向父节点传递。

<button catch:tap="btnHandler"></button> // 用catch来阻止事件冒泡

七，声明和绑定数据

// 展示内容
<text>{{scholle}}</test>

// 绑定属性值，如果需要动态绑定一个变量，属性值也需要使用双大括号进行包裹
<text id="{{id}}">{{scholle}}</test>

// 如果属性值是布尔值，也需要使用双大括号进行包裹
<checkbox checked="{ischecked}" /> 

八，setData修改数据

// 修改值
this.setData({key:value}) // key 是需要更新的数据；value 是最新的值

九，简易版双向数据绑定

十，列表渲染

  <swiper
    autoplay
    class="swiper"
    indicator-active-color="#FF734C"
    interval="2000"
    duration="1000"
    indicator-color="rgba(0, 0, 0, .3)"
    bindchange="getSwiperIndex"
  >
    <block wx:for="{{ bannerList }}" wx:key="index">
      <swiper-item class="swiper-item">
        <navigator
          class="navigator"
          hover-class="none"
          url="/modules/goodModule/pages/goods/detail/detail?goodsId={{ item.id }}"
        >
          <image class="img" src="{{ item.imageUrl }}"></image>
        </navigator>
      </swiper-item>
    </block>
  </swiper>

十一，条件渲染

十二，小程序的运行机制

十三，小程序更新机制

 // 检测冷启动版本更新
   onLaunch() {
    const updateManager = wx.getUpdateManager(); // 监听下载的状态

    // 当下载完成新版本以后,会触发 onUpdateReady 回调函数
    updateManager.onUpdateReady(function () {
      // 在回调函数中给用户提示
      wx.showModal({
        title: "更新提示",
        content: "新版本以及准备好,是否重启应用?",
        success: (res) => {
          if (res.confirm) {
            // 强制当前小程序使用新版本并且会重新启用当前小程序
            updateManager.applyUpdate();
          }
        },
      });
    });
  },

十四，小程序生命周期介绍

【应用生命周期】

【页面生命周期】

onReady 代表页面已经准备妥当，可以和视图层进行交互

【组件的生命周期】

// 组件生命周期声明对象
lifetimes {
    created() {},
    attached() {},
    ……
}

【组件所在页面的声明周期】

补充：

1，tabBar页面之间相互切换，页面不会被销毁；
2，点击左上角，返回上一个页面，会销毁当前页面。

总结：

十五，小程序API

【界面交互】

wx.showLoading() // 显示loading提示框
wx.hideLoading() // 关闭loading提示框
wx.showModal() // 模态对话框
wx.showToast() // 消息提示框

【本地存储】

【路由跳转】

【上垃加载/下拉刷新】

onReachBotoom() {} // 监听用户上拉加载
onPullDownRefresh(){} // 监听用户下拉刷新

在app.json或者page.json 中配置距离页面底部距离：onReachBottomDistance；默认50px

十六，插槽

十七，监听

在页面的的js中写上 observers{
    'key':(newValue) => {}
}

// 监听单个属性
observers: {
    'n1': function(newN1){
     ……
    }
  },

// 监听多个数据
observers: {
    'n1, n2': function(newN1, newN2){
      ……
    }
  },
  
  // 监听全部对象
  observers: {
    'obj.**': function(newObj){
     ……
    }
  },
  

十八，组件通信

一，父向子传参 Properties

二，子向父传参

子组件：
sendData() {
    this.triggerEvent('myevent',this.data)
}

父组件：
……
<customer bind:myevent="getData" /> // 子组件
……

getData(event) {
    ……
}

三，获取组件实例

// 在父组件中 获取 子组件的实例
……
<customer bind:myevent="getData" class='child' /> // 子组件
……

getChild() {
    const res = this.selectComponent('.child') // 类似于 ref
}

十九，小程序分包加载

 --app.json 
   // 分包设置
  "subPackages": [
    {
      "root": "modules/settingModule", // 分包根目录
      "name": "settingModule", // 分包别名
      "pages": [ // 分包路径
        "pages/address/add/index",
        "pages/address/list/index",
        "pages/profile/profile"
      ]
    }
  ],
  
  // 分包预下载
  "preloadRule": { // key：value的形式：key代表的是 当访问到这个目录的时候，预下载分包
    "pages/settings/settings":{ 
      "network": "all",
      "packages": ["settingModule"]
    }
  }

二十，获取微信头像

    <view class="avatar">
      <button
        hover-class="none"
        open-type="chooseAvatar"
        bind:chooseavatar="onChooseAvatar"
      >
        <image src="{{ userInfo.headimgurl || '/assets/images/avatar.png' }}" />
      </button>
    </view>


  async onChooseAvatar(e) {
      const { avatarUrl } = e.detail;

      const { data } = await reqUploadFile(avatarUrl, "file");
      this.setData({
        "userInfo.headimgurl": data.data,
      });
    },

   <form bindsubmit="getNickName">
      <input
        type="nickname"
        name="nickname"
        class="input-name"
        value="{{ userInfo.nickname }}"
      />
      <view class="dialog-content">
        <button class="cancel" bindtap="cancelForm" form-type="reset">取消</button>
        <button class="confirm" type="primary" form-type="submit">确定</button>
      </view>
    </form>

    getNickName(event) {
      // console.log('弹窗确定=》',event);
      const { nickname } = event.detail.value;
      this.setData({
        "userInfo.nickname": nickname,
        isShowPopup: false,
      });
    },

二十一，转发功能 / 分享朋友圈

  // 转发功能
  onShareAppMessage(){
    return {
      title:"只为你怦然心动",
      path:'/pages/index/index',
      imageUrl:'../../../../../assets/images/love.jpg'
    }
  },

  // 分享朋友圈
  onShareTimeline() {
   return {
     title:"只为你怦然心动",
     path:'/pages/index/index',
     imageUrl:'../../../../../assets/images/love.jpg'
   }
  },

二十二，手机号验证组件

二十三，客服功能

二十四，自定义导航栏

二十五，骨架屏

可在 微信开发者工具 中自动生成骨架屏

二十六，mobx-miniprogram

npm install --save mobx-miniprogram mobx-miniprogram-bindings

-- 创建一个Store对象 userStore
// observable 创建被检测的对象，对象中的属性会被转换为响应式数据
// action 函数是用来显示的定义 action 方法

import { observable, action } from "mobx-miniprogram";

export const userStore = observable({
  token: "",
  userInfo: {},

  setToken: action(function (token) {
    this.token = token;
  }),

  setUserInfo: action(function (userInfo) {
    this.userInfo = userInfo;
  }),
});


-- 页面中导入使用
import { userStore } from "../../../../stores/userstore";
ComponentWithStore({
  storeBindings: {
    store: userStore,
    fields: ["userInfo"],
    actions: ["setUserInfo"]
  },
  })

二十七，用户登录

二十八，地理位置功能

首先在 app.json 中声明地理位置方法

--app.json
 
   "requiredPrivateInfos": ["getLocation","chooseLocation"],
  "permission": {
    "scope.userLocation": {
      "desc": "获取地理位置信息用于填写收获地址" // 描述
    }
  }

wx.getLocation 方法

 // 获取用户地理位置信息
  async onLocation() {
    // 获取当前的地理位置（精度，纬度，高度）
    const res = await wx.getLocation();
    console.log("获取用户地理位置=》", res);
  },

如果用户拒绝授权，后面重新授权思路

wx.chooseLocation() 方法

  // 获取用户地理位置信息
  async onLocation() {
 // 打开地图让用户选择
    const res = await wx.chooseLocation()
    console.log("获取用户地理位置=》", res);
  },