开发前的装备
- 注册账号
- 下载开发者工具
- 注册登录微信公众平台并记下appID(在开发设置里)
快速开始
- 打开登陆开发者工具,创建小程序项目
-
默认打开后,会发现已经自动给我们写入了一些代码
页面是空白的,但是打开调试器发现有很多报错
点击右上角的详情,修改下配置,把调试基础库改成1.9.1,然后把不校验安全域名、web-view 域名、TLS 版本以及 HTTPS 证书勾选上,不然我们的请求就必须得是https的了
此时控制台没有报错了,页面展示如下,点击按钮,我们可以看到微信授权,点击允许,我们的头像和昵称就显示在页面上了
项目结构
我们主要看app.js、app.json、app.wxss三个文件和pages文件夹里面的wxml
- app.js 作为小程序的入口,里面有个app实例,每一个小程序都会有一个app实例,小程序启动后触发
onLaunch
函数,获取用户信息 - app.json 是小程序的全局配置,
page
字段放所有页面的路径,window
字段定义所有页面顶部的背景色,字体颜色 - app.wxss 是小程序的公用样式(小程序的选择器与CSS有一定出入,仅支持部分css选择器)
- wxml 就是我们的HTML文件,常用标签为
view
、text
等,没有所谓的div
、span
、p
一类的标签了,我们习惯称它们为组件
设计理念
小程序内部可以理解成一个mvvm的框架,分为逻辑层和视图层,逻辑层将数据进行处理后发送给视图层,同时接受视图层的事件反馈
// pages/test/index.js
Page({
data:{ // 页面的初始数据
text: 'hello world'
},
onLoad(){
console.log('hello')
},
change(){
this.setData({
text:'hello'
})
}
})
使用page
函数注册一个页面,接收一个Object
参数,使用了onLoad
函数来监听页面的加载并定义了change
函数使用setData
函数更改了text的值
更改data数据的时候必须调用setData函数进行更改
// pages/test/index.wxml
<view>{{text}}</view> // 显示hello world
<button bindtap="change">点击更改上面文字</button> // 显示hello
在button
上绑定了点击事件,触发change
函数
事件传递参数
我们触发事件的时候,可能需要传递一些参数,但是在小程序里无法像JS那样直接传递,我们需要将参数绑定到事件元素上
// index.wxml
<button data-test="哈哈" bindtap="change">点击我</button>
使用e.currentTarget.dataset
来获取值
// index.js
change(e){
e.currentTarget.dataset.test // 哈哈
}
setData函数拓展
- 修改嵌套多层的数据, 如果是写死的参数可以使用引号将参数包起来
this.setData({
'text.msg': 'hello'
})
- 如果是传递进来的值呢?很简单将data的key用[]括起来
// index.wxml
<button bindtap="change" data-key="text.msg">点击我</button>
// index.js
change(e){
var key = e.currentTarget.dataset.key
this.setData({
key: 'hello' // 数据不会更改
[key]: 'hello' // 数据会更改
})
}
路由
小程序里面所有的页面路由由框架进行管理
我们可以使用getCurrnetPages函数获取当前页面栈的实例,返回一个数组, 最后一个元素为当前页面
小程序定义了五个用于导航跳转的API,这里列举两个常用的
-
wx.navigateTo
保留当前页面,跳转到应用内的某个页面,使用wx.navigateBack
可以返回到原页面
wx.navigateTo({url:`/pages/text/index?text=${121212}`})
-
wx.redirectTo
关闭当前页面,跳转到应用内的某个页面
wx.navigateTo({url:`/pages/text/index?text=${121212}`})
通过上面的API跳转带的参数,在页面上我们需要怎么获取呢?
// text.js
Page({
data:{
... // 页面数据
},
onLoad(options){
console.log(options.text) // 121212 获取上个页面带过来的值
}
})
数据过滤 过滤器
如果你使用过vue、angular框架,对|管道符肯定不陌生,它用来对我们的数据进行转换,那小程序里面有没有过滤器呢,不过这个是真没有。
但是目前有两种方法,可以实现过滤。
- 获取数据的时候,直接改了,干脆利落、好不优雅。
- 使用最后我们要介绍的wxs
WXS
WXS是小程序的一套脚本语言,首先和js是不同的语言,其次运行环境和js也是隔离开的,wxs不能调用js文件中的函数,也不能调用小程序的API,它主要用来增强wxml。
wxs不能使用es6语法,人家不是js啦😷
接下来我们来实现一个使用wxs实现一个简单的过滤器
1、首先我们创建filter.wxs文件并写入以下内容
// filter.wxs
var Filter = {
getSatusStr: function(num){
var str = '';
switch (num) {
case 0:
string = '我是0的状态'
break;
case 1:
string = '我是1的状态'
break;
default:
string = '我是默认的状态'
break;
}
return str
}
}
module.exports = {
status: Filter.getSatusStr
}
同级下index.wxml使用
<wxs module="filter" src="./filter.wxs"></wxs>
<view wx:for="{{list}}">
<view>{{filter.status(item.status)}}</view>
</view>
- 每个wxs标签都有一个module 属性 ,wxs可以写在wxml里面的wxs标签里和.wxs文件里
- wxs文件中引入其他wxs文件时候,可以使用require函数,接受相对路径
- 在wxml标签里使用外部wxs文件的时候,src属性是相对路径
总结
- 使用sass写wxss文件,在目录下创建index.scss文件,当前目录下执行 sass --watch index.scss:index.wxss --style expanded
- wcss 文件里面不能使用本地图片,请使用base64、网上图片或者image
- 修改页面的背景,类似与css中设置body,可以直接设置page
- 不要直接操作this.data,使用this.setData函数,切记、切记
网友评论