位置：首页-资讯-前端开发

小程序的基本使用知识点（非常全面，推荐！）

2024-04-02 19:55

短信预约 -IT技能 免费直播动态提醒

注册App时做什么呢？
注册page页面时，我们一般需要做什么呢？
关于wxml的template和include
wxs模块
小程序组件化相关
组件到页面间的函数调用
小程序组件插槽的使用
小程序组件的Component构造器有那些作用
小程序网络请求
小程序中的弹窗展示
小程序页面分享
关于小程序的跳转
总结

注册App时做什么呢？

判断小程序的进入场景
监听生命周期函数，在生命周期中执行对应的业务逻辑，比如在某个生命周期函数中获取微信用户的信息。
因为App()实例是全局共享的（单例对象），所以我们可以将一些共享数据放在这里。

注册page页面时，我们一般需要做什么呢？

在生命周期中发送网络请求，从服务器获取数据；
初始化一些数据，以方便被wxml引用展示
监听wxml中的一些事件，绑定对应的事件函数
其他一些监听，（比如页面滚动，上拉刷新，下拉加载更多等）

关于wxml的template和include

在wxml中是不能直接调用Page/Component中定义函数的

在wxml文件中定义template标签，template标签在没有调用的情况下是不会进行任何渲染

name属性和is属性对应；可以使用{{}}语法


<template name="compoent">
<view>哈哈哈</view>
  <text>嘿嘿嘿</text>
  <text>{{name}}</text>
  <text>{{age}}</text>
</template>
<template is="compoent"/>
<template is="compoent"/>
<template is="compoent"/>
<template is="compoent" data= "{{name: '小屏', age:'123'}}" />

关于wxml的导入有两种方式:

import导入：

1:主要是导入template

2：特点是不能进行递归导入

include引入：

1：将公共的组件抽取到一个文件中

特点：不能导入template/wxs/可以进行递归导入

wxs模块

wxs模块是小程序的一套脚本语言结合wxml,可以构建出页面的结构

wxs与javascript是不同的语言，有自己的语法，并不和JavaScript一致。（不过基本一致）

在wxml中是不能直接调用Page/Component中定义函数的

但是某些情况下，我们希望使用函数来处理wxml中的数据（类似Vue在的过滤器），这个时候就使用wxs了

wxl使用的限制和特点：

WXS的运行环境和其他的JavaScript代码是隔离的，wxs中不能调用其他Javascript文件中定义的函数，也不能调用小程序中的API

wxs不能作为数组的函数回调。

由于运行环境的差异，在ios设备上的小程序内的wxs会比JavaScript快2~20.倍，在android设备上二者运行效率无差异。

小程序组件化相关

小程序组件和调用该组件的页面样式互不影响。

调用组件需要在页面的json文件中加入组件名称和路径


{
  "usingComponents": {
    "my-cut":"/pages/compent/my-cut"  }
}

在有需要是页面和组件间的样式相互影响的时候，可以利用options的 styleIsolation属性

在组件的js文件Component({})下面


  // 在组件里面设置options的 styleIsolation: "apply-shared"会是页面设置的样式属性影响组件的样式
  // 在组件里面设置options的 styleIsolation: "shared"会是页面设置的样式属性影响组件的样式
  Component({
	options:{
    styleIsolation: "apply-shared"
  },
})

组件间的动态转值使用properties属性

在组件中可以利用externalClasses这个属性来动态设置设置css的样式


Component({
properties: {
    // title: String
    title:{
      type: String,
      value:"我是默认值",
      //监听新值和旧值
      observer: function(newVal,oldVal){
        console.log(newVal,oldVal)
      }
    },
    
  },
    // 在组件中可以利用这个属性来动态设置设置css的样式
  externalClasses:["tltleclass"]

})

在页面中调用属性


<my-cut title="哈哈" tltleclass="red"></my-cut>
<my-cut title="嘿嘿" tltleclass="green" />
<my-cut/>

页面css文件


.red{
  color: red;
}
.green{
  color: green;
}

组件到页面间的函数调用

在页面使用组件的时候，我们有时候会需要修改组件的数据，这就需要我们在页面的js文件调用到组件的data。

在小程序中有个selectComponent('.class/#xxx')可以拿到组件对象；

组件wxml


<view class="contention">
  <block wx:for="{{titled}}" wx:key="index">
    <view class="tit"> <text class="intext {{index == increat? 'active' : ''}}" data-count="{{index}}" bindtap="targetTap">{{item}}</text> </view>
  </block>
</view>

组件js


methods: {
    targetTap(e){
      const index  = e.currentTarget.dataset.count
      this.setData({
        increat:index
      })
        this.triggerEvent("targetCount" , {})
    },
    amend(){
      this.setData({
        titled: ["政治", "数学", "英语"]
      })
    }

  }

页面wxml


<switch titled="{{list}}" bind:targetCount="targetCount" class="sw-class"></switch>

页面js


  targetCount(){
  //获取组件对象
    const content = this.selectComponent('.sw-class') 
    console.log(content)
    // content.setData({
    //   titled:["政治", "数学", "英语"]
    // })
    // 开放规范一般不推荐这种直接在函数的修改方法，建议在组件内使用methods内部以方法的形式修改，在页面调用即可
    content.amend()
  },

小程序组件插槽的使用

单插槽

组件wxml


<view>
  我是一个标题
</view>
<slot></slot>
<view>
  我是一个内容
</view>

页面wxml使用


<my-slot>
<button size="mini"> 按钮</button>
</my-slot>
<my-slot>
 <image class="lazy" data-src="https://gimg2.baidu.com/image_search/class="lazy" data-src=http%3A%2F%2Fimg2.woyaogexing.com%2F2021%2F04%2F26%2F1b402c98095d452486508b8250b21f3f%21360x640.jpeg&refer=http%3A%2F%2Fimg2.woyaogexing.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1625711145&t=d9d310d5e9c878a9d4b7bc7057f2b754"/>
</my-slot>
<my-slot>
  <slider value="20"></slider>
</my-slot>

多个插槽的使用

需要给每一个插槽取一个名字使用name属性

必须在component对象下面的options对象下面的multipleSolts属性设置为true

组件wxml


<view>我是多插槽的标题</view>
<view> <slot name="slot1" ></slot> </view>
<view> <slot name="slot2" ></slot> </view>
<view> <slot name="slot3" ></slot> </view>
<view>我是多插槽的尾部</view>

组件js文件


Component({
  
  options:{
    multipleSlots:true
  }
  )}

页面的使用


<!-- 多插槽的使用 -->
<!-- 注意事项:
需要给每一个插槽取一个名字
必须在component对象下面的options对象下面的multipleSolts属性设置为true -->
<my-mslot>
<button slot="slot3">415461</button>
<slider slot="slot1" value="20"></slider>
<text slot="slot2">呵呵呵呵呵</text>
</my-mslot>

小程序组件的Component构造器有那些作用

1 properties 让使用者可以给组件传入数据


properties:{ 
	title: string,
	content:{
	type: array,
	value:[1,2.3],
	observer:function(newVal,oldVal){
        console.log(newVal,oldVal)
      }
	}
}

2.data 定义一些组件的初始化数据


data:{
	counter：0
}

3 methods 用于定义组件内部的函数


methods:{
foo(){
	
}
}

4 options 定义组件的配置选项


options:{
//在需要使用多插槽时设置为true
	multipleSlots:true,
	//设置样式的隔离方式
	styleIsolation: "apply-shared", //页面设置的样式属性影响组件的样式
   //styleIsolation: "shared"  页面设置的样式属性影响组件的样式
}

5 externalClasses 定义外部传入额外的样式


externalClasses:["on","tre"]

6 observers可以监听properties/data的改变


observers:{
	counter: function(newVal){
		console.log(newVal)
	}
}

7 监听所在页面的生命周期

在组件js文件


  pageLifetimes:{
    show(){
      console.log("监听组件所在页面显示出来的")
    },
    hide(){
      console.log("监听组件所在页面隐藏起来的时候")
    },
    resize(){
      console.log("监听页面尺寸的改变")
    }
  }

监听组件内生命周期


lifetimes:{
    created(){
      console.log("组件被创建")
    },
    attached(){
      console.log("组件被添加到页面中")
    },
    ready(){
      console.log("组件被渲染出来")
    },
    moved(){
      console.log("组件被移动到节点树的另一个位置")
    },
    detached(){
      console.log("组件")
    }
  }

小程序网络请求


onReady: function () {
    wx.request({
      url: 'http://httpbin.org/post',
      method:'post',
      data:{
        name:"wangshuai",
        age:19
      },
      success:function(res){
          console.log(res)
      }
    })
  },

比较关键的几个属性

url: 必传
data: 请求参数
method:请求的方式
success:成功时的回调
fail:失败时的回调

一般情况下为了降低网络请求和wx.request的耦合度，我们会Promise的方法获取回调结果

使用promise封装


export default function request(option) {
    return new Promise( (resolve, reject) => {
      wx.request({
        url: option.url,
        method: option.method || 'get',
        data: option.data || {},
        success: function (res) {
            resolve(res)
        },
        fail: function (res) {
          reject(res)
        }
      })
    })
}

页面调用


 onReady: function () {
    //小程序原生网络请求
    // wx.request({
    //   url: 'http://httpbin.org/post',
    //   method:'post',
    //   data:{
    //     name:"wangshuai",
    //     age:19
    //   },
    //   success:function(res){
    //       console.log(res)
    //   }
    // })
    request({url: 'http://httpbin.org/post',method:"post"}).then(res=>{
      console.log(res)
    }).catch(err =>{
      console.log(err)
    })
  },

小程序中的弹窗展示

页面wxml


<button size="mini" bindtap="showToast">showToast</button>
<button size="mini" bindtap="showModal">showModal</button>
<button size="mini" bindtap="showLoading">showLoading</button>
<button size="mini" bindtap="showAction">showAction</button>
<button size="mini" open-type="share">分享</button>

页面js文件


Page({
	showToast(){
    wx.showToast({
      title: '我是showToast',
    })
  },
  showModal(){
    wx.showModal({
      title:'是否删除',
      cancelColor: 'cancelColor',
      success:function (params) {
          console.log(params)
          if (params.cancel) {
              console.log("点击了取消删除")
          } 
      } 
    })
  },
  showLoading(){
    wx.showLoading({
      title: '等待中',
      mask: true //给一个遮罩，防止其他操作
    })
    setTimeout(()=>{
      wx.hideLoading({
        success: (res) => {},
      })
    },1500)
  },
  showAction(){
    wx.showActionSheet({
      itemList: ['拍照','文件'],
    })
  }
})

小程序页面分享

小程序的分享方式有两种，一种是点击按钮分享，另一种是点击右上角的菜单选项选择分享。

我们分享小程序的时候需要通过onShareAppMessage来展示分享信息

监听用户点击页面内转发按钮（button 组件 open-type=“share”）或右上角菜单“转发”按钮的行为，并自定义转发内容。

注意：只有定义了此事件处理函数，右上角菜单才会显示“转发”按钮
此事件处理函数需要 return 一个 Object，用于自定义转发内容，返回内容如下：

关于小程序的跳转

navigator标签

关于navigator跳转使用url.


<navigator url="/pages/home/home">跳转home</navigator>

跳转属性open-type有如下取值

redirect：关闭当前页面，跳转到应用内的某个页面。但是不允许跳转到tabBer页面，并且不能返回

switchTab：跳转到tabBer页面，并关闭其他非tabber页面（需要在tabBer中定义）

reLaunch：关闭所有页面，打开某个页面（直接展示某个页面，斌切可以跳转到tabBer页面）


<navigator url="/pages/home/home">跳转home</navigator>
<navigator url="/pages/home/home" open-type="redirect">跳转home(redirect)</navigator>
<navigator url="/pages/home/home" open-type="reLaunch">跳转home(reLaunch)</navigator>
<navigator url="/pages/home/home" open-type="switchTab">跳转home(switchTab)</navigator>