微信小程序入门到实战(1)-基础知识

 1.微信小程序介绍

微信小程序,简称小程序,英文名Mini Program,是一种不须要下载安装便可使用的应用,它实现了应用“触手可及”的梦想,用户扫一扫或搜一下便可打开应用。html

1.1. 为何是微信小程序 ?

  1. 微信有海量用户,并且粘性很高,在微信里开发产品更容易触达用户;vue

  2. 推广app 或公众号的成本过高。node

  3. 开发适配成本低。react

  4. 容易小规模试错,而后快速迭代。git

  5. 跨平台。github

 

1.2. 微信小程序历史

  • 2016年1月11日,微信之父张小龙时隔多年的公开亮相,解读了微信的四大价值观。张小龙指出,愈来愈多产品经过公众号来作,由于这里开发、获取用户和传播成本更低。拆分出来的服务号并无提供更好的服务,因此微信内部正在研究新的形态,叫「微信小程序」 须要注意的是,以前是叫作 应用号web

  • 2016年9月21日,微信小程序正式开启内测。在微信生态下,触手可及、用完即走的微信小程序引发普遍关注。腾讯云正式上线微信小程序解决方案,提供小程序在云端服务器的技术方案。json

  • 2017年1月9日,微信推出的“小程序”正式上线。“小程序”是一种无需安装,便可使用的手机“应用”。不须要像往常同样下载App,用户在微信中“用完即走”。小程序

 

1.3. 疯狂的微信小程序

  1. 微信月活已经达到10.82亿。其中55岁以上的用户也达到6300万微信小程序

  2. 信息传达数达到450亿,较去年增加18%;视频通话4.1亿次,增加100%

  3. 小程序覆盖超过200+行业,交易额增加超过6倍,服务1000亿+人次,创造出了5000亿+的商业价值

 

1.4. 还有其余的小程序 不容忽视

  1. 支付宝小程序

  2. 百度小程序

  3. QQ小程序

  4. 今日头条 + 抖音小程序

 

1.5. 体验

1.5.1. 官方微信小程序体验

小程序示例源码

 

1.5.2. 其余优秀的第三方小程序
  • 拼多多

  • 滴滴出行

  • 欢乐斗地主

  • 智行火车票

  • 惟品会

  • 。。。

 

2. 环境准备

开发微信小程序以前,必需要准备好相应的环境

2.1. 注册帐号

建议使用全新的邮箱,没有注册过其余小程序或者公众号的。

访问注册页面,耐心完成注册便可。

2.2. 获取APPID

因为后期调用微信小程序的接口等功能,须要索取开发者的小程序中的APPID,因此在注册成功后,可登陆,而后获取APPID。

登陆,成功后可看到以下界面

而后复制你的APPID,悄悄的保存起来,不要给别人看到。

 

2.3. 开发工具

下载地址

微信小程序自带开发者工具,集 开发 预览 调试 发布 于一身的 完整环境。

可是因为编码的体验不算好,所以 建议使用 vs code + 微信小程序编辑工具 来实现编码

vs code 负责敲代码,微信编辑工具 负责预览。

 

3. 第一个微信小程序

3.1. 打开微信开发者工具

注意 第一次登陆的时候 须要扫码登陆

3.2. 新建小程序项目

3.3. 填写项目信息

3.4. 成功

 

4. 微信开发者工具介绍

详细的使用,能够查看官网

 

5. 小程序结构目录

小程序框架的目标是经过尽量简单、高效的方式让开发者能够在微信中开发具备原生 APP 体验的服务。

小程序框架提供了本身的视图层描述语言 WXMLWXSS,以及 JavaScript,并在视图层与逻辑层间提供了数据传输和事件系统,让开发者可以专一于数据与逻辑。

5.1. 小程序文件结构和传统web对比

 

经过以上对比得出,传统web 是三层结构。而微信小程序 是四层结构,多了一层 配置.json

5.2. 基本的项目目录

 

6. 小程序配置文件

一个小程序应用程序会包括最基本的两种配置文件。一种是全局的 app.json 和 页面本身的 page.json

 注意:配置文件中不能出现注释。

6.1. 全局配置 app.json

app.json 是当前小程序的全局配置,包括了小程序的全部页面路径、界面表现、网络超时时间、底部 tab 等。普通快速启动项目里边的 app.json 配置。

{
  "pages":[
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window":{
    "backgroundTextStyle":"light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "WeChat",
    "navigationBarTextStyle":"black"
  }
}

字段的含义

  1. pages字段 —— 用于描述当前小程序全部页面路径,这是为了让微信客户端知道当前你的小程序页面定义在哪一个目录。

  2. window字段 —— 定义小程序全部页面的顶部背景颜色,文字颜色定义等。

  3. 完整的配置信息请参考 app.json配置

6.1.1. tabbar

6.2. 页面配置 page.json

这里的 page.json 其实用来表示页面目录下的 page.json 这类和小程序页面相关的配置。

开发者能够独立定义每一个页面的一些属性,如顶部颜色、是否容许下拉刷新等等。

页面的配置只能设置 app.json 中部分 window 配置项的内容,页面中配置项会覆盖 app.jsonwindow 中相同的配置项。

 

6.3.sitemap 配置-了解便可

小程序根目录下的 sitemap.json 文件用于配置小程序及其页面是否容许被微信索引。

 

7. 模板语法

WXML(WeiXin Markup Language)是框架设计的一套标签语言,结合基础组件事件系统,能够构建出页面的结构。

7.1. 数据绑定

7.1.1. 普通写法
<view> {{ message }} </view>

 

Page({
  data: {
    message: 'Hello MINA!'
  }
})

 

7.1.2. 组件属性
<view id="item-{{id}}"> </view>

 

Page({
  data: {
    id: 0
  }
})

 

7.1.3. bool类型

不要直接写 checked="false",其计算结果是一个字符串

<checkbox checked="{{false}}"> </checkbox>

 

7.2. 运算

7.2.1. 三元运算
<view hidden="{{flag ? true : false}}"> Hidden </view>

 

7.2.2. 算数运算
<view> {{a + b}} + {{c}} + d </view>

 

Page({
  data: {
    a: 1,
    b: 2,
    c: 3
  }
})

 

7.2.3. 逻辑判断
<view wx:if="{{length > 5}}"> </view>

 

7.2.4. 字符串运算
<view>{{"hello" + name}}</view>

 

Page({
  data:{
    name: 'MINA'
  }
})

 

7.2.5. 注意

花括号和引号之间若是有空格,将最终被解析成为字符串

 

7.3. 列表渲染

7.3.1. wx:for

项的变量名默认为 item wx:for-item 能够指定数组当前元素的变量名

下标变量名默认为 index wx:for-index 能够指定数组当前下标的变量名

wx:key 用来提升数组渲染的性能

wx:key 绑定的值 有以下选择

1. string 类型,表示 循环项中的惟一属性 如

list:[{id:0,name:"炒饭"},{id:1,name:"炒面"}]

wx:key="id"

 

2.保留字 *this ,它的意思是 item 自己 ,*this 表明的必须是 惟一的字符串和数组。

list:[1,2,3,4,5]

wx:key="*this"

代码

<view wx:for="{{array}}" wx:key="id">
  {{index}}: {{item.message}}
</view>

 

Page({
  data: {
    array: [{
      id:0,
      message: 'foo',
    }, {
      id:1,
      message: 'bar'
    }]
  }
})

 

7.3.2. block

渲染一个包含多节点的结构块 block最终不会变成真正的dom元素

<block wx:for="{{[1, 2, 3]}}" wx:key="*this" >
  <view> {{index}}: </view>
  <view> {{item}} </view>
</block>

 

7.4. 条件渲染

7.4.1. wx:if

在框架中,使用 wx:if="{{condition}}" 来判断是否须要渲染该代码块:

 

  <view wx:if="{{false}}">1</view>
  <view wx:elif="{{true}}">2</view>
  <view wx:else>3</view>
7.4.2. hidden
<view hidden="{{condition}}"> True </view>

相似 wx:if

频繁切换 用 hidden

不常使用 用 wx:if

 

8. 小程序事件的绑定

小程序中绑定事件,经过bind关键字来实现。如 bindtap bindinput bindchange

不一样的组件支持不一样的事件,具体看组件的说明便可。

8.1. wxml

<input bindinput="handleInput" />

8.2. page

Page({
  // 绑定的事件
  handleInput: function(e) {
    console.log(e);
    console.log("值被改变了");
  }
})

8.3. 特别注意

1.绑定事件时不能带参数 不能带括号 如下为错误写法

<input bindinput="handleInput(100)" />

2.事件传值 经过标签自定义属性的方式 和 value

<input bindinput="handleInput" data-item="100" />

3.事件触发时获取数据

  handleInput: function(e) {
    // {item:100}
   console.log(e.currentTarget.dataset)
      
    // 输入框的值
   console.log(e.detail.value);
  }

 

9. 样式 WXSS

https://developers.weixin.qq.com/miniprogram/dev/framework/view/wxss.html

WXSS(WeiXin Style Sheets)是一套样式语言,用于描述 WXML 的组件样式。

CSS 相比,WXSS 扩展的特性有:

  • 响应式长度单位 rpx

  • 样式导入

9.1. 尺寸单位

rpx(responsive pixel): 能够根据屏幕宽度进行自适应。规定屏幕宽为750rpx。如在 iPhone6 上,屏幕宽度为375px,共有750个物理像素,则750rpx = 375px = 750物理像素1rpx = 0.5px = 1物理像素

建议: 开发微信小程序时设计师能够用 iPhone6 做为视觉稿的标准。

使用步骤:

  1. 肯定设计稿宽度 pageWidth

  2. 计算比例 750rpx = pageWidth px ,所以 1px=750rpx/pageWidth

  3. 在less文件中,只要把设计稿中的 px => 750/pageWidth rpx 便可。

9.2. 样式导入

wxss中直接就支持,样式导入功能。

也能够和 less中的导入混用。

使用@import语句能够导入外联样式表,只支持相对路径

示例代码:

/** common.wxss **/
.small-p {
  padding:5px;
}

 

/** app.wxss **/
@import "common.wxss";
.middle-p {
  padding:15px;
}

 

9.3. 选择器

特别须要注意的是 小程序 不支持通配符 * 所以如下代码无效!

*{
    margin:0;
    padding:0;
    box-sizing:border-box;
}

目前支持的选择器有:

9.4. 小程序中使用less

原生小程序不支持less,其余基于小程序的框架大致都支持,如wepympvuetaro等。可是仅仅由于一个less功能,而去引入一个框架,确定是不可取的。所以能够用如下方式来实现。

  1. 编辑器是vscode

  2. 安装插件 easy less

3. 在vs code的设置中加入以下,配置

    "less.compile": {
        "outExt":       ".wxss"
    }

 

在要编写样式的地方,新建 less文件,如 index.less,而后正常编辑便可。

 

10. 常见组件

https://developers.weixin.qq.com/miniprogram/dev/component/

重点讲解小程序中经常使用的布局组件 view,text,rich-text,button,image,navigator,icon,swiper,radio,checkbox

10.1. view

代替 原来的 div 标签

  <view hover-class="h-class">
  点击我试试
  </view>

10.2. text

  1. 文本标签

  2. 只能嵌套text

  3. 长按文字能够复制(只有该标签有这个功能)

  4. 能够对空格 回车 进行编码

10.2.1. 代码
  <text selectable="{{false}}" decode="{{false}}">&nbsp;通
  </text>

10.3. image

  1. 图片标签,image组件默认宽度320px、高度240px

  2. 支持懒加载

 

mode 有效值:

mode 有 13 种模式,其中 4 种是缩放模式,9 种是裁剪模式。

10.4.swiper

微信内置轮播图组件

 

默认宽度 100% 高度 150px

10.4.1. swiper

 滑块视图容器。

10.4.2. swiper-item

滑块,默认宽度和高度都是100%

10.5. navigator

 导航组件 相似超连接标签

open-type 有效值:

10.6. rich-text

富文本标签

能够将字符串解析成 对应标签,相似 vue中 v-html功能

 

代码

// 1   index.wxml  加载 节点数组
<rich-text nodes="{{nodes}}" bindtap="tap"></rich-text>
// 2 加载 字符串
<rich-text nodes='<img src="https://developers.weixin.qq.com/miniprogram/assets/images/head_global_z_@all.png" alt="">'></rich-text> 
 
    
// index.js
    
Page({
  data: {
    nodes: [{
      name: 'div',
      attrs: {
        class: 'div_class',
        style: 'line-height: 60px; color: red;'
      },
      children: [{
        type: 'text',
        text: 'Hello&nbsp;World!'
      }]
    }]
  },
  tap() {
    console.log('tap')
  }
})
10.6.1. nodes属性

nodes属性支持 字符串标签节点数组

文本节点:type = text

  • nodes 不推荐使用 String 类型,性能会有所降低。

  • rich-text 组件内屏蔽全部节点的事件。

  • attrs 属性不支持 id ,支持 class 。

  • name 属性大小写不敏感。

  • 若是使用了不受信任的 HTML 节点,该节点及其全部子节点将会被移除。

  • img 标签仅支持网络图片。

10.7. button

<button
  type="default"
  size="{{defaultSize}}"
  loading="{{loading}}"
  plain="{{plain}}"
>
  default
</button>

 

 size 的合法值

type 的合法值

form-type 的合法值

open-type 的合法值

open-type 的 contact的实现流程

  1. 将小程序 的appid 由测试号改成 本身的appid

  2. 登陆微信小程序官网,添加 客服 - 微信

  3. 为了方便演示,我本身准备了两个帐号

    1. 普通用户 A

    2. 客服-微信 B

  4. 就是干!

10.8. icon

 

 

 代码:

 js

Page({
  data: {
    iconSize: [20, 30, 40, 50, 60, 70],
    iconType: [
      'success', 'success_no_circle', 'info', 'warn', 'waiting', 'cancel', 'download', 'search', 'clear'
    ],
    iconColor: [
      'red', 'orange', 'yellow', 'green', 'rgb(0,255,255)', 'blue', 'purple'
    ],
  }
})

wxml

<view class="group">
  <block wx:for="{{iconSize}}">
    <icon type="success" size="{{item}}"/>
  </block>
</view>

<view class="group">
  <block wx:for="{{iconType}}">
    <icon type="{{item}}" size="40"/>
  </block>
</view>

<view class="group">
  <block wx:for="{{iconColor}}">
    <icon type="success" size="40" color="{{item}}"/>
  </block>
</view>

 

10.9. radio

能够经过 color属性来修改颜色

须要搭配 radio-group 一块儿使用

10.10. checkbox

能够经过 color属性来修改颜色

须要搭配 checkbox-group 一块儿使用

 

11. 自定义组件

https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/

相似vue或者react中的自定义组件

小程序容许咱们使用自定义组件的方式来构建页面。

11.1. 建立自定义组件

相似于页面,一个自定义组件由 json wxml wxss js 4个文件组成.

能够在微信开发者工具中快速建立组件的文件结构

 

 

在文件夹内components/myHeader,建立组件 名为 myHeader

11.1.1. 声明组件

首先须要在组件的 json 文件中进行自定义组件声明

myHeader.json

{
  "component": true
}
11.1.2. 编辑组件

同时,还要在组件的 wxml 文件中编写组件模板,在 wxss 文件中加入组件样式。

slot表示插槽,相似vue中的slot

myHeader.wxml

<!-- 这是自定义组件的内部WXML结构 -->
<view class="inner">
  {{innerText}}
    <slot></slot>
</view>

在组件的 wxss文件中编写样式

注意:在组件wxss中不该使用ID选择器、属性选择器和标签名选择器。

myHeader.wxss

/* 这里的样式只应用于这个自定义组件 */
.inner {
  color: red;
}
11.1.3. 注册组件

在组件的 js 文件中,须要使用 Component() 来注册组件,并提供组件的属性定义、内部数据和自定义方法

 

myHeader.js

Component({
  properties: {
    // 这里定义了innerText属性,属性值能够在组件使用时指定
    innerText: {
      // 指望要的数据是 string类型
      type: String,
      value: 'default value',
    }
  },
  data: {
    // 这里是一些组件内部数据
    someData: {}
  },
  methods: {
    // 这里是一个自定义方法
    customMethod: function(){}
  }
})

11.2. 声明引入自定义组件

首先要在页面的 json 文件中进行引用声明。还要提供对应的组件名和组件路径。

index.wxml

{
    // 引用声明
  "usingComponents": {
      // 要使用的组件的名称     // 组件的路径
    "my-header":"/components/myHeader/myHeader"
  }
}

11.3. 页面中使用自定义组件

<view>
  <!-- 如下是对一个自定义组件的引用 -->
  <my-header inner-text="Some text">
    <view>用来替代slot的</view>
    </my-header>
</view>

11.4. 定义段与示例方法

Component构造器可用于定义组件,调用Component构造器时能够指定组件的属性、数据、方法等。

11.5. 组件-自定义组件传参

  1. 父组件经过属性的方式给子组件传递参数

  2. 子组件经过事件的方式向父组件传递参数

11.5.1. 过程
  1. 父组件 把数据 {{tabs}} 传递到 子组件的 tabItems 属性中

  2. 父组件 监听 onMyTab 事件

  3. 子组件 触发 bindmytap 中的 mytap 事件

    1. 自定义组件触发事件时,须要使用 triggerEvent 方法,指定事件名detail对象

  4. 父 -> 子 动态传值 this.selectComponent("#tabs");

 父组件代码

// page.wxml 

<tabs tabItems="{{tabs}}" bindmytap="onMyTab" >
  内容-这里能够放插槽
</tabs>

// page.js
  data: {
    tabs:[
      {name:"体验问题"},
      {name:"商品、商家投诉"}
    ]
  },
  onMyTab(e){
    console.log(e.detail);
  },

子组件代码

// com.wxml
<view class="tabs">
  <view class="tab_title"  >
    <block  wx:for="{{tabItems}}" wx:key="{{item}}">
      <view bindtap="handleItemActive" data-index="{{index}}">{{item.name}}</view>
    </block>
  </view>
  <view class="tab_content">
    <slot></slot>
  </view>
</view>

// com.js
Component({
  properties: {
    tabItems:{
      type:Array,
      value:[]
    }
  },
  /**
   * 组件的初始数据
   */
  data: {
  },

  /**
   * 组件的方法列表
   */
  methods: {
    handleItemActive(e){
      this.triggerEvent('mytap','haha');
    }
  }
})

11.6. 小结

  1. 标签名 是 中划线的方式

  2. 属性的方式 也是要中划线的方式

  3. 其余状况可使用驼峰命名

    1. 组件的文件名如 myHeader.js 的等

    2. 组件内的要接收的属性名 如 innerText

  4. 更多。。

 

12. 小程序生命周期

分为应用生命周期页面生命周期

 

关于小程序先后台的定义和小程序的运行机制,请参考运行机制章节。

12.1. 应用生命周期

12.2. 页面生命周期

12.3. 页面生命周期图解

相关文章
相关标签/搜索