微信小程序快速入门——搭建你的第一个小程序

一、小程序简介

小程序与普通网页开发的区别

1.运行环境不同
网页运行在浏览器，小程序运行在微信

2.API 不同
小程序中无法调用 DOM 和 BOM 。但是，小程序可以调用微信的 API，例如：定位、扫码、支付

3.开发模式不同
网页的开发模式：浏览器 + 代码编辑器
小程序的开发模式：申请开发账号、安装开发者工具、创建和配置项目

二、搭建第一个小程序

1.进入微信公众平台注册账号
2.选择小程序

3.填写相关信息注册成功后得到 小程序id（创建小程序时必须的）

4.安装微信开发者工具

5.安装后扫码登录，点击加号新建项目

6.填写项目信息

7.创建成功

三、小程序代码构成

1.项目结构

pages            		存放所有页面
utils             		存放工具模块
app.js 					入口文件
app.json				全局配置文件
app.wxss 				全局样式文件
project.config.json 	项目配置文件
sitemap.json			配置小程序及其页面是否允许被微信索引
1
2
3
4
5
6
7

2.页面组成部分

.js 文件（脚本文件，存放数据、事件处理函数等）
.json 文件（配置文件，配置窗口的外观、表现等）
.wxml 文件（模板结构文件）
.wxss 文件（页面的样式文件）
1
2
3
4

3.app.json 文件

pages：用来记录当前小程序所有页面的路径
window：全局定义小程序所有页面的背景色、文字颜色等
style：全局定义小程序组件所使用的样式版本
sitemapLocation：用来指明 sitemap.json 的位置
1
2
3
4

四、小程序的宿主环境

小程序的宿主环境
手机微信是小程序的宿主环境，如图所示

所以小程序借助宿主环境提供的能力，可以完成许多普通网页无法完成的功能
微信扫码、微信支付、微信登录、地理定位等

小程序宿主环境包含的内容：通信模型、运行机制、组件、API

1.通信模型

• 渲染层和逻辑层之间的通信：由微信客户端进行转发
• 逻辑层和第三方服务器之间的通信：由微信客户端进行转发
  

2.运行机制

启动过程如下

下载小程序的代码包到本地
解析 app.json 全局配置文件
执行 app.js 小程序入口文件，调用 App() 创建小程序实例
渲染小程序首页
小程序启动完成
1
2
3
4
5

页面渲染如下

加载解析页面的 .json 配置文件
加载页面的 .wxml 模板和 .wxss 样式
执行页面的 .js 文件，调用 Page() 创建页面实例
页面渲染完成
1
2
3
4

3.组件

视图容器
基础内容
表单组件
导航组件
媒体组件
map 地图组件
canvas 画布组件
开放能力
无障碍访问
1
2
3
4
5
6
7
8
9

常用的视图容器类组件

1. view

   普通视图区域，类似于 div，常用来实现页面的布局效果
   

2. scroll-view

   可滚动的视图区域，常用来实现滚动列表效果
   

3. swiper 和 swiper-item

   轮播图容器组件 和 轮播图 item 组件
   

常用的基础内容组件

1. text

   文本组件，类似于 span，是一个行内元素
   

2. rich-text

   富文本组件，支持把 HTML 字符串渲染为 WXML 结构
   

其它常用组件

1. button

   按钮组件，通过 open-type 属性可以调用微信提供的各种功能（客服、转发、获取用户授权、获取用户信息等）
   

2. image

   图片组件，image 组件默认宽度约 300px、高度约 240px
   

3. navigator

   页面导航组件，类似于 a 链接

4.API
小程序中的 API 是由宿主环境提供的，通过这些丰富的小程序 API，开发者可以方便的调用微信提供的能力，例如：获取用户信息、本地存储、支付功能等

小程序官方把 API 分为了如下 3 大类：

1. 事件监听 API

   特点：以 on 开头，用来监听某些事件的触发
   举例：wx.onWindowResize(function callback) 监听窗口尺寸变化的事件

2. 同步 API

   特点1：以 Sync 结尾的 API 都是同步 API
   特点2：同步 API 的执行结果，可以通过函数返回值直接获取，如果执行出错会抛出异常
   举例：wx.setStorageSync(‘key’, ‘value’) 向本地存储中写入内容

3. 异步 API

   特点：类似于 jQuery 中的 $.ajax(options) 函数，需要通过 success、fail、complete 接收调用的结果
   举例：wx.request() 发起网络数据请求，通过 success 回调函数接收数据

五、总结

1. 怎么创建小程序项目

   微信开发者工具的使用、appID 的获取

2. 小程序项目的基本组成结构

   app.js、app.json、app.wxss、pages 文件夹

3. 小程序页面由几部分组成

   wxml、wxss、json、js

4. 程序中常见的组件如何使用

   view、text、image