1 - 微信小程序 - 起步

起步

1小程序代码的构成-项目结构

1.1项目的基本组成结构

• pages 用来存放所有小程序的页面
• utils 用来存放工具性质的模块（例如：格式化时间的自定义模块）
• app.js 小程序项目的入口文件
• app.json 小程序项目的全局配置文件
• app.wxss 小程序项目的全局样式文件
• project.config.json 项目的配置文件
• sitemap.json 用来配置小程序及其页面是否允许被微信索引

1.2 小程序页面的组成部分

每个页面由 4 个基本文件组成，它们分别是：、

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

2 小程序代码的构成-JSON配置文件

2.1JSON配置文件的作用

JSON 是一种数据格式，在实际开发中，JSON 总是以配置文件的形式出现。小程序项目中也不例外：通过不同的 .json 配置文件，可以对小程序项目进行不同级别的配置。

小程序项目中有 4 种 json 配置文件，分别是：
5. 项目根目录中的 app.json 配置文件
6. 项目根目录中的 project.config.json 配置文件
7. 项目根目录中的 sitemap.json 配置文件
8. 每个页面文件夹中的 .json 配置文件

2.2 app.json文件

app.json 是当前小程序的全局配置，包括了小程序的所有页面路径、窗口外观、界面表现、底部 tab 等。Demo 项目里边的 app.json 配置内容如下：

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

2.3 project.config.json 文件

project.config.json 是项目配置文件，用来记录我们对小程序开发工具所做的个性化配置，例如：
13. setting 中保存了编译相关的配置
14. projectname 中保存的是项目名称
15. appid 中保存的是小程序的账号 ID

2.4 页面的 .json 配置文件

小程序中的每一个页面，可以使用 .json 文件来对本页面的窗口外观进行配置，页面中的配置项会覆盖 app.json 的 window 中相同的配置项。例如：

3 小程序的宿主环境 - 组件

3.1 小程序中组件的分类

小程序中的组件也是由宿主环境提供的，开发者可以基于组件快速搭建出漂亮的页面结构。官方把小程序的组件分为了 9 大类，分别是：
16. 视图容器
17. 基础内容
18. 表单组件
19. 导航组件
20. 媒体组件
21. map 地图组件
22. canvas 画布组件
23. 开放能力
24. 无障碍访问

3.2 常用的视图容器类组件

1. view
   普通视图区域
   类似于 HTML 中的 div，是一个块级元素
   常用来实现页面的布局效果
2. scroll-view
   可滚动的视图区域
   常用来实现滚动列表效果
3. swiper 和 swiper-item
   轮播图容器组件 和 轮播图 item 组件

3.3 view 组件的基本使用

3.1 实现如图的 flex 横向布局效果：

3.3.2 scroll-view 组件的基本使用

实现如图的纵向滚动效果：

3.3.3 swiper 和 swiper-item 组件的基本使用

实现如图的轮播图效果：

3.3.4 swiper 组件的常用属性

3.3.5 常用的基础内容组件

1. text
   文本组件
   类似于 HTML 中的 span 标签，是一个行内元素
2. rich-text
   富文本组件
   支持把 HTML 字符串渲染为 WXML 结构

3.3.6 text 组件的基本使用

通过 text 组件的 selectable 属性，实现长按选中文本内容的效果：

3.3.7 rich-text 组件的基本使用

通过 rich-text 组件的 nodes 属性节点，把 HTML 字符串渲染为对应的 UI 结构：

3.3.8 其它常用组件

1. button
   按钮组件
   功能比 HTML 中的 button 按钮丰富
   通过 open-type 属性可以调用微信提供的各种功能（客服、转发、获取用户授权、获取用户信息等）
2. image
   图片组件
   image 组件默认宽度约 300px、高度约 240px
3. navigator
   页面导航组件
   类似于 HTML 中的 a 链接

3.3.9 button 按钮的基本使用

3.3.10 image 组件的基本使用

3.3.11 image 组件的 mode 属性

image 组件的 mode 属性用来指定图片的裁剪和缩放模式，常用的 mode 属性值如下：

3.4 小程序的宿主环境 - API

3.4.1 小程序 API 概述

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

3.4.2 小程序 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 回调函数接收数据