001微信小程序入门

1 小程序代码的构成

1.1 项目构成

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

1.2 小程序页面的组成部分

每个页面由4个基本文件组成：

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

1.2.1 JSON配置文件

• JSON配置文件的作用：JSON是一种数据格式。

  • 项目根目录中的 aap.json 配置文件
  • 项目目录中的 project.config.json配置文件
  • 项目根目录中的sitemap.json配置文件
  • 每个页面文件夹中的.json配置文件

• app.json文件：是当前小程序的全局配置，包括所有页面路径、窗口外观、界面表现、底部tab等。

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

• project.config.json文件：是项目配置文件，用来记录对小程序开发工具所做的个性化配置

  • setting中保存了编译相关的配置
  • projectname中保存的是项目名称
  • appid中保存的小程序的账号ID

• sitemap.json文件：配置小程序页面是否允许文件索引。

• 页面的.json配置文件：对本页面的窗口外观进行配置，页面中的配置项会覆盖 app.json的 window中相同配置项。

• 新建小程序页面：app.json ->pages中添加页面路径

  {"pages": ["pages/index/index","pages/logs/logs"，"pages/list/list",]
  }
  

• 修改项目首页：只需要调整 app.json->pages数组中页面路径的前后顺序

  {"pages": ["pages/list/list","pages/index/index","pages/logs/logs" ]
  }
  

1.2.2 WXML

​ WXML(WeiXin Markup Language)是小程序框架设计的一套标签语言，用来构建小程序页面的结构。

WXML 和 HTML的区别

• 标签名称不同
  • HTML（div，span，img，a）
  • WXML（view，text，image，navigator）
• 属性节点不同
  • <a href=“#”>超链接</a>
  • <navigator url = “/pages/home/home”></navigator>
• 提供了类似于vue中模本语法
  • 数据绑定
  • 列表渲染
  • 条件渲染

1.2.3 WXSS样式

​ WXSS（WeiXin Style Sheets）是一套样式语言，用于描述WXML的组件样式

WXSS 于 CSS 的区别

• 新增了 rpx 尺寸单位
  • CSS中需要手动进行像素单位换算
  • WSXX在底层支持尺寸单位 rpx，在不同于大小的屏幕上小程序自动进行换算。
• 提供了全局的样式和局部样式
  • 项目根目录中的 app.wxss会作用域所有小程序页面
  • 局部页面的.wxx样式尽在当前页生效
• WXSS仅支持部分CSS选择器
  • .class 和 #id
  • element
  • 并集选择器、后代选择器
  • ::after 和 ::before 等伪类选择器

1.2.4 JS交互逻辑

​ 通过.js文件处理用户的操作。

.js文件分类

• app.js：是整个小程序项目的入口文件，通过调用App()函数来启动整小程序
• 页面.js文件：页面的入口文件，通过调用Page()函数创建并运行页面
• 普通.js文件：普通的功能模块文件，用来封装公共的函数或属性供页面的使用

2. 小程序的宿主环境

宿主环境（host environment）指的是程序运行所有必须的依赖环境。

小程序的宿主环境：手机微信是小程序宿主环境

2.1 小程序宿主环境包含的内容

• 小程序中通信的主体是渲染层和逻辑层
  • WXML模本和WXSS样式工作在渲染层
  • JS脚本工作在逻辑层
• 渲染层和逻辑层之间的通信
  • 由第三方服务器进行转发
• 逻辑层和第三方服务器之间的通信
  • 由微信客户端进行转发

2.2 运行机制

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

2.3 组件

• 视图容器
• 基础内容
• 表单组件
• 导航组件
• 媒体组件
• map地图组件
• canvas画布组件
• 开放组件
• 无障碍访问

2.3.1 常用的视图容器类组件

• view
  • 普通视图区域
  • 一个块级元素
  • 用于实现页面布局效果

<view class="view-container"><view>A</view><view>B</view><view>C</view>
</view>

.view-container view {width: 100px;height: 100px;text-align: center;line-height: 100px;
}.view-container view:nth-child(1) {background-color: lawngreen;
}.view-container view:nth-child(2) {background-color: lightblue;
}.view-container view:nth-child(3) {background-color: lightcoral;
}.view-container {display: flex;justify-content: space-around;
}.scroll-container view {width: 100px;height: 100px;text-align: center;line-height: 100px;
}

• scroll-vile
  • 可滚动的视图区域
  • 实现滚动列表

<scroll-view class="scroll-container" scroll-y><view>A</view><view>B</view><view>C</view>
</scroll-view>

.scroll-container view:nth-child(1) {background-color: lawngreen;
}.scroll-container view:nth-child(2) {background-color: lightblue;
}.scroll-container view:nth-child(3) {background-color: lightcoral;
}.scroll-container {border: 1px solid red;width: 100px;height: 120px;
}

• swiper 和 swiper-item

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

• 常用属性

属性	类型	默认值	说明
indicator-dots	boolean	false	是否显示面板指示点
indicator-color	color	rgba(0,0,0,.3)	指示点颜色
indicator-active-color	color	#000000	当前选中的指示颜色
autoplay	boolean	false	是否自动切换
interval	number	5000	自动切换时间间隔
circulat	boolean	false	是否采用衔接滑动

<swiper class="swiper-container" indicator-dots="true" indicator-color="while" indicator-active-color="gray" autoplay interval="3000" current><swiper-item><view class="item">A</view></swiper-item><swiper-item><view class="item">B</view></swiper-item><swiper-item><view class="item">C</view></swiper-item>
</swiper>

.swiper-containe{height:150px;
}.item{height: 100%;line-height: 150px;text-align: center;
}swiper-item:nth-child(1) .item{background-color: lightcoral;
}
swiper-item:nth-child(2) .item{background-color: lightgoldenrodyellow;
}
swiper-item:nth-child(3) .item{background-color: lightsalmon;
}

2.3.2 常用的基础内容组件

• text
  • 文件组件
  • 类似于 HTML 中的 span标签，一个行内元素

<view>
手机号支持长按选中效果:
<text selectable style="color: blue; text-decoration: underline;">23459291023</text>
</view>

• rich-text
  • 富文本组件
  • 支持把HTML字符串渲染为WXML结构

<rich-text nodes="<h1 style='color: red;'>标题</h1>"></rich-text>

2.3.3 其它常用组件

• button
  • 按钮组件
  • 通过 open-type属性可以调用微信提供的各种功能

<!-- 通过 type 指定按钮类型-->
<button>普通按钮</button>
<button type="primary">主色调按钮</button>
<button type="warn">警告按钮</button>
<!-- size="mini" 小尺寸按钮 -->
<button size="mini">普通按钮</button>
<button type="primary" size="mini">主色调按钮</button>
<button type="warn" size="mini">警告按钮</button>
<!-- plain  镂空按钮 -->
<button size="mini" plain>普通按钮</button>
<button type="primary" size="mini" plain>主色调按钮</button>
<button type="warn" size="mini" plain>警告按钮</button>

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

model值	说明
scaleToFill	（默认值）缩放模式，不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素
aspectFit	缩放模式，保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。
aspectFill	缩放模式，保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。
widthFix	缩放模式，宽度不变，高度自动变化，保持原图宽高比不变
heightFix	缩放模式，高度不变，宽度自动变化，保持原图宽高比不变

<image></image>
<image src="/images/1.png" mode="widthFix"></image>

image{border: 1px solid red;
}

2.4 API

• 事件监听API:
  • 特点：以 on 开头，用来监听某些事件的触发
• 同步API：
  • 特点1：以 Sync 结尾的 API 都是同步 API
  • 特点2：同步 API 的执行结果，可以通过函数返回值直接获取，如果执行出错会抛出异常
• 异步API:
• 特点：类似于 jQuery 中的 $.ajax(options) 函数，需要通过 success、fail、complete 接收调用的结果
• 举例：wx.request() 发起网络数据请求，通过 success 回调函数接收数据