小程序代码构成
项目的基本组成结构
- pages 用来存放所有小程序页面
- utils 用来存放工具性模块
- app.js 小程序项目的入口文件
- app.json 小程序项目的全局配置文件
- app.wxss 小程序项目的全局样式文件
- project.config.json 项目的配置文件
- sitmap.json 用来配置小程序是及其页面是否允许被微信索引
小程序页面的组成部分
小程序官方建议把所有小程序的页面,都存放在pages目录中,以单独的文件夹存在
其中每个页面由4个基本文件组成
- .js文件 (页面的脚本文件,存放页面的数据,事件处理函数等)
- .json文件 (当前页面的配置文件,配置窗口的外观,表现等)
- .wxml文件(页面的模板结构文件)
- .wxss文件 (当前页面的样式表文件)
.json配置文件
JSON配置文件的作用
JSON是一种数据格式,在实际开发中json总是以配置文件的形式出现。
小程序项目也不例外,通过不同.json配置文件,可以对小程序项目进行不同级别的配置。
小程序中.json配置文件
app.json文件
当前小程序的全局配置,包括了小程序的所有页面路径,窗口外观,界面表现,底部tab等
{
"pages":[
"pages/list1/list1",
"pages/list/list",
"pages/index/index",
"pages/logs/logs"
],
"window":{
"backgroundTextStyle":"light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "Weixin",
"navigationBarTextStyle":"black"
},
"style": "v2",
"sitemapLocation": "sitemap.json"
}
4个配置项的作用
- pages 用来记录当前小程序所有页面的路径
- windows 全局定义小程序的背景色、文字颜色等
- style 全局定义小程序组件所使用的样式版本
- sitemapLocation 用来指明sitmap.json位置
project.config.json文件
项目配置文件,用来记录我们对小程序开发工具所做的个性化配置
中间代码对应左边的按键配置信息
sitmap.json
sitmap.json页面用来配置小程序是否能够被微信索引
当开发者允许微信索引时,微信会通过爬虫的形式,为小程序的页面内容建立索引。当用户的搜索词和页面的索引匹配时,小程序可能会展示在用户的搜索结果中
sitmap.json的索引是默认开启的,
可以在 project.config.json的setting中配置字段checkSiteMap为false去禁用
页面.json
可以使用单当前页面.json文件来对当前页面的窗口外观进行配置,页面中的配置项会覆盖掉app.json的window中相同的配置项
WXML模板
WXML (WeiXin Markup Language)是小程序框架设计的一套标签语言,用来构建小程序页面的结构,其作用类似于网页开发中的HTML
HTML和WXML的区别
- 标签名称不同
- HTML (div, span, img, a)
- wxML ( view, text, image, navigator)
- 属性节点不同
<a href="#">超链接</a>
<navigator url="/pages/home/home"></navigator>s
- 提供了类似于vue中的模板语法
- 数据绑定
- 列表渲染
- 条件渲染
WXSS样式
WXSS (WeiXin Style Sheets)是一套样式语言,用于描述WXML的组件样式,类似于网页开发中的CSS.
WXSS和CSS的区别
- 新增了rpx尺寸单位
- CSS中需要手动进行像素单位换算,例如rem
- WXSS在底层支持新的尺寸单位rpx,在不同大小的屏幕上小程序会自动进行换算
- 提供了全局的样式和局部样式
- 项目根目录中的app.wxSs会作用于所有小程序页面
- 局部页面的.WXSS样式仅对当前页面生效
- WXSS仅支持部分CSS选择器
- .class和#id
- element
- 并集选择器、后代选择器
- : :after 和 ::before等伪类选择器
JS逻辑交互
一个项目仅仅提供界面展示是不够的,在小程序中,我们通过.js文件来处理用户的操作。例如:响应用户的点击、获取用户的位置等等。
小程序中.js 文件的分类
小程序中的JS文件分为三大类,分别是:
- app.js
是整个小程序项目的入口文件,通过调用App()函数来启动整个小程序 - 页面的.js 文件
是页面的入口文件,通过调用Page()函数来创建并运行页面 - 普通的.js 文件
是普通的功能模块文件,用来封装公共的函数或属性供页面使用
小程序的宿主环境
宿主环境(host environment)指的是程序运行所必须的依赖环境。
小程序宿主环境包含的内容
- 通信模型
- 运行机制
- 组件
- APl
通信的主体
小程序中通信的主体是渲染层和逻辑层,其中:
- WXML模板和WXSS样式工作在渲染层
- JS脚本工作在逻辑层
小程序中组件的分类
小程序中的组件也是由宿主环境提供的,开发者可以基于组件快速搭建出漂亮的页面结构。官方把小程序的组件分为了9大类,分别是:
- 视图容器
- 基础内容
- 表单组件
- 导航组件
- 媒体组件
- map地图组件
- canvas画布组件
- 开放能力
- 无障碍访问
组件
view
普通视图区域
类似于HTML中的div,是一个块级元素常用来实现页面的布局效果
.wxml
<!--pages/list/list.wxml-->
<view class = "container1">
<view>A</view>
<view>B</view>
<view>c</view>
</view>
.wxss
/* pages/list/list.wxss */
.container1 view{
width:100px;
height:100px;
text-align:center;
line-height: 100px;
}
.container1 view:nth-child(1){
background-color: lightgreen;
}
.container1 view:nth-child(2){
background-color: lightpink;
}
.container1 view:nth-child(3){
background-color: lightskyblue;
}
.container1{
display: flex;
justify-content: space-around;
}
表示横屏显示
display: flex;
scroll-view
可滚动的视图区域
常用来实现滚动列表效果
<!--pages/list/list.wxml-->
<scroll-view class = "container1" scroll-y>
<view>A</view>
<view>B</view>
<view>c</view>
</scroll-view>
/* pages/list/list.wxss */
.container1 view{
width:100px;
height:100px;
text-align:center;
line-height: 100px;
}
.container1 view:nth-child(1){
background-color: lightgreen;
}
.container1 view:nth-child(2){
background-color: lightpink;
}
.container1 view:nth-child(3){
background-color: lightskyblue;
}
.container1{
broder:1px solid red;
width:100px;
height:120px;
}
swiper
swiper和swiper-item
轮播图容器组件和轮播图item组件
常用属性
- indicator-dots 是否显示面板指示点 (默认是否)
- indicator-color 面板指示点颜色
- indicator-active-color 当前选中页面指示点的颜色
- autoplay 是否自动轮播
- interval 每次轮播的时间 类型是Number 默认是5000 单位是毫秒
- circular 是否采用衔接滑动 (如果不写这个属性,到了最后一张会倒着滑动,写了就是连接第一张图片播放)
<!--pages/list1/list1.wxml-->
<swiper class="swiper-container">
<!-- 轮播图1 -->
<swiper-item>
<view class="item">A</view>
</swiper-item>
<!-- 轮播图2 -->
<swiper-item>
<view class="item">B</view>
</swiper-item>
<!-- 轮播图3 -->
<swiper-item>
<view class="item">C</view>
</swiper-item>
</swiper>
/* pages/list1/list1.wxss */
.swiper-container{
height: 150px;
}
.item{
height:100%;
line-height: 150px;
text-align: center;
}
swiper-item:nth-child(1){
background-color: lightgreen;
}
swiper-item:nth-child(2){
background-color: lightpink;
}
swiper-item:nth-child(3){
background-color: lightblue;
}
常用的基础内容控件
text
- 文本组件
- 类似于HTML中的span标签,是一个行内元素
- 可以通过text组件的selectable属性,实现长按选中文本内容的效果
.wxml
<view>
手机号支持长按选中效果
<text selectable>3r427165236152</text>
</view>
rich-text
- 富文本组件
- 支持把HTML字符串渲染为WXML结构
- 通过rich-text组件的nodes属性节点,把HTML字符串渲染为对应的UI结构
<rich-text nodes="<h1 style='color:red;'>标签</h1>"></rich-text>
其它常用组件
button
- 按钮组件
- 功能比HTML中的button按钮丰富
- 通过open-type 属性可以调用微信提供的各种功能(客服、转发、获取用户授权、获取用户信息等)
.wxml
<!-- 按钮组件的基本使用 -->
<button>普通按钮</button>
<!-- 通过type属性指定按钮颜色类型 -->
<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
- image组件的mode属性用来指定图片的裁剪和缩放模式,常用mode属性值如下:
- scaleToFill 默认值 缩放模式,不保持纵横比缩放图片,使图片的宽高完全拉伸至填满image元素
- aspectFill 缩放模式,保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。
- aspectFill 缩放模式 保持纵横比缩放图片,只能保证图片地短边能完全显示出来,也就是说,图片通常只能在水平或垂直方向是完整地,另一个方向将会发生截取
- widthFix 缩放模式,宽度不变,高度自动变化,保持原图宽高比不变
- heightFix 缩放模式,高度不变,宽度自动变化,保持原图宽高比不变
<!--pages/list3/list3.wxml-->
<!-- image图片组件 -->
<!-- 空图片也占位置 -->
<image></image>
<image src="/images/测试.png" mode="widthFix"></image>
/* pages/list3/list3.wxss */
/* 给图片加个边框线 */
image{
border:1px solid red;
}
navigator (后续补充)
- 页面导航组件
- 类似于HTML中的a链接
小程序的宿主环境-API
概述
小程序中的API是由宿主环境提供的,通过这些丰富的小程序API,开发者可以方便的调用微信提供的能力
小程序API的3大分类
事件监听API
特点:以on开头,用来监听某些事件的触发
同步API
- 特点1:以Sync结尾的API都是同步API
- 特点2:同步API的执行结果,可以通过函数返回值直接获取,如果执行出错会抛出异常
异步API
特点:类似于jQuery中的$.ajax(options)函数,需要通过success、fail、complete接收调用的结果
协同工作和发布
协同工作和发布-协同工作
小程序开发流程
协同工作和发布-小程序成员管理
小程序成员管理体现在管理员对小程序项目成员及体验成员的管理
项目成员
- 表示参与小程序开发、运营的成员
- 可登录小程序管理后台
- 管理员可以添加、删除项目成员,并设置项目成员及体验成员的管理
体验成员
- 表示参与小程序内测体验的成员
- 可使用体验版小程序,但不属于项目成员
- 管理员及项目成员均可添加、删除体验成员
不同项目成员对应的权限
开发者权限说明
- 开发者权限: 可使用小程序开发者工具及对小程序的功能进行代码开发
- 体验者权限: 可使用体验版小程序
- 登录权限: 可登录小程序管理后台,无需管理员确认
- 开发设置: 设置小程序服务器域名、消息推送、及扫描普通链接二维码打开小程序
- 腾讯云管理: 云开发相关设置