美文网首页玄机随录小程序
微信小程序API使用

微信小程序API使用

作者: duangdong | 来源:发表于2020-01-02 09:23 被阅读0次

[TOC]

小程序的执行流程

life.png

注册一个小程序(小程序的生命周期)

  • 注册App时,一般会做什么
    • 判断小程序的进入场景
    • 监听生命周期函数,在生命周期中执行对应的业务逻辑,比如在某个生命周期函数中获取微信用户的信息。
    • 因为App()实例只有一个,并且是全局共享的( 单例对象),所以我们可以将一些共享数据放在这里。
  • 小程序后台存活时间:
    htps://developers.weixin.qq.com/miniprogram/dev/framework/operating-mechanism.html
  • 小程序的打开场景较多:
  • 如何确定场景?
    • 在onLaunch和onShow生命周期回调函数中,会有options参数,其中有scene值

onLanch

  • 发请求

  • 获取用户的数据

    • wx.getUserInfo
    • button open-type = getUserInfo
    • open-data

onShow(option)

  • 获取场景,根据不同的场景做对应的逻辑处理

onHide

onError

注册一个页面(页面的生命周期)

page-life.png

onLoad

初次加载

onShow

页面显示

onReady

初次渲染完成

onHide

onUnLoad

onShareAppMessage

监听用户点击页面内转发按钮(button 组件 open-type="share"

右上角菜单“转发”按钮的行为,并自定义转发内容。

  • <button open-type="share">点击分享</button>
    
  • onShareAppMessage: function (res) {
        return {
          title: '自定义转发标题',
          path: '/pages'    // 用户点进分享所进入的页面
        }
     }
    

WXS作用以及语法

WXS(WeiXin Script)是小程序的一套脚本语言,结合 WXML,可以构建出页面的结构。
WXS 与 JavaScript 是不同的语言,有自己的语法,并不和 JavaScript 一致。
但基本是和js一样的
主要应用的场景是 时间格式化以及过滤器的使用,也可以写成js作成工具类,在我们的js文件中先使用

两种wxs的写法

  • wxml

      <wxs module="info"> 
        const sum = () => {
          
          };
          module.exports = {
              sum
          }
      </wxs>
      
    <view>{{info.sum}}</view>
    
  • .wxs文件中

    <wxs src="./wxs/demo.wxs" module="info" />
    

自定义组件

只能使用wx:if;无法使用hidden

父子间传值和vue相似

组件和页面通信

comp.png

父传子

通过属性绑定的形式将值传递给子组件

  • 获取子组件并调用其方法 selectComponent

    // this.selectComponent('.tab')   获取到子组件的示例对象this
    // setCurrentIndex 为组件的方法,可以直接setData({}) 。不推荐直接修改数据
    this.selectComponent('.tab').setCurrentIndex(e.detail.index)
    },
    

子传父

通过 triggerEvent 触发事件将数据传递给父组件

插槽slot

在组件的wxml中可以包含 slot 节点,用于承载组件使用者提供的wxml结构。

默认情况下,一个组件的wxml中只能有一个slot。需要使用多slot时,可以在组件js中声明启用。

  • 多插槽的组件声明

    Component({
      options: {
        multipleSlots: true // 在组件定义时的选项中启用多slot支持
      },
      properties: { /* ... */ },
      methods: { /* ... */ }
    })
    
  • 此时,可以在这个组件的wxml中使用多个slot,以不同的 name 来区分。

    <!-- 组件模板 -->
    <view class="wrapper">
      <slot name="before"></slot>
      <view>这里是组件的内部细节</view>
      <slot name="after"></slot>
    </view>
    
  • 使用时,用 slot 属性来将节点插入到不同的slot上。

    <!-- 引用组件的页面模板 -->
    <view>
      <component-tag-name>
        <!-- 这部分内容将被放置在组件 <slot name="before"> 的位置上 -->
        <view slot="before">这里是插入到组件slot name="before"中的内容</view>
        <!-- 这部分内容将被放置在组件 <slot name="after"> 的位置上 -->
        <view slot="after">这里是插入到组件slot name="after"中的内容</view>
      </component-tag-name>
    </view>
    

组件的样式

  • 组件内的样式对外部样式的影响

    • 组件内的class样式,只对组件wxml内的节点生效,对于引用组件的Page页面不生效。
    • 组件内不能使用id选择器、属性选择器、标签选择器
  • 外部样式 对组件内样式 的影响

    • 外部使用class的样式,只对外部wxml的class生效,对组件内是不生效的
    • 外部使用了id选择器、属性选择器不会对组件内产生影响
    • 外部使用了标签选择器,会对组件内产生影响
  • 组件内的class样式和组件外的class样式,默认是有一个隔离效果的;

  • 为了防止样式的错乱,官方不推荐使用id、属性、标签选择器;

  • 组件和页面的样式影响

    Component({
      options: {
        styleIsolation: 'isolated'
      }
    

})


+ 如果这个 [Component 构造器用于构造页面](https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/component.html) ,则默认值为 `shared` ,且还有以下几个额外的样式隔离选项可用:
  - `page-isolated` 表示在这个页面禁用 app.wxss ,同时,页面的 wxss 不会影响到其他自定义组件;
  - `page-apply-shared` 表示在这个页面禁用 app.wxss ,同时,页面 wxss 样式不会影响到其他自定义组件,但设为 `shared` 的自定义组件会影响到页面;
  - `page-shared` 表示在这个页面禁用 app.wxss ,同时,页面 wxss 样式会影响到其他设为 `apply-shared` 或 `shared` 的自定义组件,也会受到设为 `shared` 的自定义组件的影响。

+ **[页面向组件传递样式](https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/wxml-wxss.html#外部样式类)**

> **注意:在同一个节点上使用普通样式类和外部样式类时,两个类的优先级是未定义的,因此最好避免这种情况。**

+ ```js
  /* 组件 custom-component.js */
  Component({
    externalClasses: ['my-class']
  })
  
  <!-- 组件 custom-component.wxml -->
  <custom-component class="my-class">这段文本的颜色由组件外的 class 决定</custom-component>
  ```

+ ```js
  <!-- 页面的 WXML -->
  <custom-component my-class="red-text" />
  <custom-component my-class="large-text" />
  <!-- 以下写法需要基础库版本 2.7.1 以上 -->
  <custom-component my-class="red-text large-text" />
  ```

### [WX.API]( https://developers.weixin.qq.com/miniprogram/dev/api/ )

#### [网络]( https://developers.weixin.qq.com/miniprogram/dev/api/network/request/wx.request.html ) 

+ 请求 (request)

+ 我们一般会对

```js
import { baseUrl } from './config.js';
export default (options) => {
  wx.showLoading({
    title: '数据加载中',
  });
  return new Promise((resolve, reject) => {
    wx.request({
      url: `${baseUrl}/${options.url}`,
      method: options.method || 'get',
      data: options.data || {},
      success: resolve,
      fail: reject,
      complete: (res) => {
        wx.hideLoading();
      }
    });
  });
}
  • 对各个页面中封装请求方法

    import http from './index.js';
    const getHomeList = () => {
      return http({
        url: 'home/multidata'
      });
    }
    
    export {
      getHomeList
    }
    

开放接口

  • 登录 (wx.login)

  • api-login.jpg
  • 当我们不需要关心开发者服务器开发的时候,前端需要

    • 调用wx.login() 获取code
    • 调用wx.request发送code到服务器,返回一个登录状态的标识,比如token
    • 我们使用wx.setStorageSync/setStorage,将标识token进行存储
      • 这个和我们的localStorage一样
    • 携带token进行请求,获取返回的数据

导航

  • navigator

    // 通过url进行参数的传递
    <!-- sample.wxml -->
    <view class="btn-area">
      <navigator url="/page/navigate/navigate?title=navigate" hover-class="navigator-hover">跳转到新页面
     </navigator>
      <navigator url="../../redirect/redirect/redirect?title=redirect" open-type="redirect" hover-class="other-navigator-hover">在当前页打开
     </navigator>
     <navigator url="/page/index/index" open-type="switchTab" hover-class="other-navigator-hover">切换 Tab
     </navigator>
     <navigator target="miniProgram" open-type="navigate" app-id="" path="" extra-data="" version="release">打开绑定的小程序
     </navigator>
     <navigator url="/page/index/index" open-type="navigateBack" delta="2">回退 Tab
     </navigator>
    </view>
    
  • 接受传递过来的数据

    // 在跳转到的页面中
    Page({
     onLoad: function(options) {
       //在options中拿到
       console.log(options);
     }
    })
    
  • 跳转的页面向返回的页面回传数据

    • getCurrentPages()
    • 获取当前栈的所有页面。数组中第一个元素为首页,最后一个元素为当前页面。
    Page({
     onUnload() {
      const pages = getCurrentPages();
        // 获取首页页面对象
        const home = pages[pages.length-1];
        // 使用home页面中的方法修改数据
     }
    })
    

一些需要注意的地方

  • 因为WXML节点标签名只能是小写字母、中划线和下划线的组合,所以自定义组件的标签名也只能包含这些字符。

  • 自定义组件也是可以引用自定义组件的,引用方法类似于页面引用自定义组件的方式(使用
    usingComponents字段)。

  • 自定义组件和页面所在项目根目录名不能以"Wx-" 为前缀,否则会报错。

  • 如果在appjson的usingComponents声明某个组件,那么所有页面和组件可以直接使用该组件。

  • 如何获取每个自定义组件到顶部的距离

    • wx.createSelectorQuery()
    • 返回一个 SelectorQuery 对象实例。在自定义组件或包含自定义组件的页面中,应使用 this.createSelectorQuery() 来代替
    wx.createSelectorQuery().select('.tab').boundingClientRect((rect) => {
        this.setData({
            tabTop: rect.top
         })
      }).exec();
    //这里必须有exec()才能执行
    

相关文章

  • 微信小程序开发笔记(一)

    微信小程序官方文档 微信小程序示例,仅做练习微信小程序使用数据来自:免费开放接口API开放接口API peakch...

  • 微信小程序调用自定义接口

    微信小程序提供了wx.request方法发起请求,具体文档参照 微信小程序api。使用的api为自建api,使用n...

  • 微信小程序(上)

    微信小程序 微信小程序应用开发简介(大腿勿喷) 小程序api 微信小程序其实挺简单的,项目大多功能官方api都提供...

  • WordPress 微信小程序

    WordPress连接微信小程序介绍: 1. 使用WordPress的Api做微信小应用(实现了数据的读取、展示...

  • 微信小程序API使用

    [TOC] 小程序的执行流程 注册一个小程序(小程序的生命周期) 注册App时,一般会做什么判断小程序的进入场景监...

  • 微信小程序中腾讯位置API使用

    微信小程序中腾讯位置API使用 本例主要是针对于微信小程序的定位 准备工作 申请开发者密钥(key): 申请密钥 ...

  • 《微信小程序开发文档》使用指南

    微信小程序开发文档,主要介绍了微信小程序的开发教程,微信小程序的api文档,微信的应用号开发资料等。 一、关于微信...

  • 微信小程序基础

    微信小程序介绍微信小程序开发工具的使用微信小程序框架文件微信小程序逻辑层微信小程序视图层微信小程序组件介绍微信小程...

  • 微信小程序API相关知识科普

    微信小程序API(Application Programming Interface),即应用程序编程接口。API...

  • 微信小程序 Wi-Fi 功能使用及遇到的问题

    微信小程序提供了支持 Wi-Fi 功能的多个 Api 接口。查看 Api 接口详情,请移步:微信小程序 Wi-Fi...

网友评论

    本文标题:微信小程序API使用

    本文链接:https://www.haomeiwen.com/subject/soynoctx.html