[TOC]
## 一、小程序代码构成
小程序包含一个描述整体程序的`app`和多个描述各自页面的`page`。
一个小程序主体部分由三个文件组成，必须放在项目的根目录，如下：
| 文件 | 必需 | 作用 |
| --- | --- | --- |
| app.js | 是 | 小程序逻辑 |
| app.json | 是 | 小程序公共配置 |
| app.wxss | 否 | 小程序公共样式表 |
一个小程序页面由四个文件组成，分别是：
| 文件类型 | 必需 | 作用 |
| --- | --- | --- |
| js | 是 | 页面逻辑 |
| wxml | 是 | 页面结构 |
| json | 否 | 页面配置 |
| wxss | 否 | 页面样式表 |
> **注意：为了方便开发者减少配置项，描述页面的四个文件必须具有相同的路径与文件名。**
```
├── pages 小程序页面
│ │── index
│ │ ├── index.wxml 模版文件
│ │ ├── index.js 页面逻辑
│ │ ├── index.json 页面配置
│ │ └── index.wxss 样式文件
│ └── logs
│ ├── logs.wxml
│ └── logs.js
├── utils 小程序通用工具包
├── app.js 小程序逻辑
├── app.json 小程序公共配置
├── app.wxss 小程序公共样式表
├── project.config.json 项目配置文件
└── sitemap.json 映射配置文件
```
## 二、JSON 配置
JSON 是一种数据格式，并不是编程语言，在小程序中，JSON扮演的静态配置的角色。
我们可以看到在项目的根目录有一个`app.json`和`project.config.json`，此外在`pages/logs`目录下还有一个`logs.json`，我们依次来说明一下它们的用途。
### 2.1 全局配置
`app.json`是当前小程序的全局配置，包括了小程序的所有页面路径、界面表现、网络超时时间、底部 tab 等。
```
{
"pages": [
"pages/index/index",
"pages/logs/logs"
],
"window": {
"backgroundTextStyle": "light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle": "black"
},
"style": "v2",
"sitemapLocation": "sitemap.json"
}
```
* `pages`字段：用于描述当前小程序所有页面路径，这是为了让微信客户端知道当前你的小程序页面定义在哪个目录。
* `window`字段：定义小程序所有页面的顶部背景颜色，文字颜色定义等。
### 2.2 工具配置
通常大家在使用一个工具的时候，都会针对各自喜好做一些个性化配置，例如界面颜色、编译配置等等，当你换了另外一台电脑重新安装工具的时候，你还要重新配置。
考虑到这点，小程序开发者工具在每个项目的根目录都会生成一个`project.config.json`，你在工具上做的任何配置都会写入到这个文件，当你重新安装工具或者换电脑工作时，你只要载入同一个项目的代码包，开发者工具就自动会帮你恢复到当时你开发项目时的个性化配置，其中会包括编辑器的颜色、代码上传时自动压缩等等一系列选项。
### 2.3 页面配置
如果你整个小程序的风格是蓝色调，那么你可以在`app.json`里边声明顶部颜色是蓝色即可。实际情况可能不是这样，可能你小程序里边的每个页面都有不一样的色调来区分不同功能模块，因此我们提供了`page.json`，让开发者可以独立定义每个页面的一些属性，例如刚刚说的顶部颜色、是否允许下拉刷新等等。
## 三、WXML 模版
从事过网页编程的人知道，网页编程采用的是 HTML + CSS + JS 这样的组合，其中`HTML`是用来描述当前这个页面的结构，`CSS`用来描述页面的样子，`JS`通常是用来处理这个页面和用户的交互。
同样道理，在小程序中也有同样的角色，其中`WXML`充当的就是类似`HTML`的角色。打开`pages/index/index.wxml`，你会看到以下的内容：
```
<view class="container">
<view class="userinfo">
<button wx:if="{{!hasUserInfo && canIUse}}" open-type="getUserInfo"
bindgetuserinfo="getUserInfo"> 获取头像昵称 </button>
<block wx:else>
<image bindtap="bindViewTap" class="userinfo-avatar"
src="{{userInfo.avatarUrl}}" mode="cover"></image>
<text class="userinfo-nickname">{{userInfo.nickName}}</text>
</block>
</view>
<view class="usermotto">
<text class="user-motto">{{motto}}</text>
</view>
</view>
```
和`HTML`非常相似，`WXML`由标签、属性等等构成。但是也有很多不一样的地方，我们来一一阐述一下：
* **标签名字有点不一样**
往往写 HTML 的时候，经常会用到的标签是`div`,`p`,`span`，开发者在写一个页面的时候可以根据这些基础的标签组合出不一样的组件，例如日历、弹窗等等。换个思路，既然大家都需要这些组件，为什么我们不能把这些常用的组件包装起来，大大提高我们的开发效率。
从上边的例子可以看到，小程序的`WXML`用的标签是`view`,`button`,`text`等等，这些标签就是小程序给开发者包装好的基本能力，我们还提供了地图、视频、音频等等组件能力。
* **多了一些`wx:if`这样的属性以及`{{ }}`这样的表达式**
在网页的一般开发流程中，我们通常会通过`JS`操作`DOM`(对应`HTML`的描述产生的树)，以引起界面的一些变化响应用户的行为。例如，用户点击某个按钮的时候，`JS`会记录一些状态到`JS`变量里边，同时通过`DOM`API 操控`DOM`的属性或者行为，进而引起界面一些变化。当项目越来越大的时候，你的代码会充斥着非常多的界面交互逻辑和程序的各种状态变量，显然这不是一个很好的开发模式，因此就有了 MVVM 的开发模式（例如 React, Vue），提倡把渲染和逻辑分离。简单来说就是不要再让`JS`直接操控`DOM`，`JS`只需要管理状态即可，然后再通过一种模板语法来描述状态和界面结构的关系即可。
小程序的框架也是用到了这个思路，如果你需要把一个`Hello World`的字符串显示在界面上。
WXML 是这么写 :
~~~
<text>{{msg}}</text>
~~~
JS 只需要管理状态即可:
~~~
this.setData({ msg: "Hello World" })
~~~
通过`{{ }}`的语法把一个变量绑定到界面上，我们称为数据绑定。仅仅通过数据绑定还不够完整的描述状态和界面的关系，还需要`if`/`else`,`for`等控制能力，在小程序里边，这些控制能力都用`wx:`开头的属性来表达。
## 四、WXSS 样式
`WXSS`具有`CSS`大部分的特性，小程序在`WXSS`也做了一些扩充和修改。
1. 新增了尺寸单位。在写`CSS`样式时，开发者需要考虑到手机设备的屏幕会有不同的宽度和设备像素比，采用一些技巧来换算一些像素单位。`WXSS`在底层支持新的尺寸单位`rpx`，开发者可以免去换算的烦恼，只要交给小程序底层来换算即可，由于换算采用的浮点数运算，所以运算结果会和预期结果有一点点偏差。
2. 提供了全局的样式和局部样式。和前边`app.json`,`page.json`的概念相同，你可以写一个`app.wxss`作为全局样式，会作用于当前小程序的所有页面，局部页面样式`page.wxss`仅对当前页面生效。
3. 此外`WXSS`仅支持部分`CSS`选择器。
## 五、JS 逻辑交互
一个服务仅仅只有界面展示是不够的，还需要和用户做交互：响应用户的点击、获取用户的位置等等。在小程序里边，我们就通过编写`JS`脚本文件来处理用户的操作。
~~~
<view>{{ msg }}</view>
<button bindtap="clickMe">点击我</button>
~~~
点击`button`按钮的时候，我们希望把界面上`msg`显示成`"Hello World"`，于是我们在`button`上声明一个属性:`bindtap`，在 JS 文件里边声明了`clickMe`方法来响应这次点击操作：
~~~
Page({
clickMe: function() {
this.setData({ msg: "Hello World" })
}
})
~~~
