小程序看似一种全新的东西,但好在基本上就是曾经HTML,CSS,JS的一个微变版本。
语法和之前一样。只是一些用法和名字(标签)发生了一些变化。
小程序主要就四种扩展名的文件:js,json,wxml,wxss
JS,小程序的功能实现文件,和普通的JavaScript没什么区别,更多的是加入了一些微信扩展的方法,可以与微信进行一些交互。
JSON,小程序的配置文件,也比较简单,格式和之前熟知的JSON文本文件没有区别,在小程序里主要也是用于配置环境和属性等。
WXSS,小程序的样式文件,语法和普通的CSS没啥区别,直接上手就用即可。
WXML,这个语法上和HTML没区别,也是标签类语言,只是标签名字有变化,同时不像HTML标签只是含义不同,默认样式不同,是真正具备一定的功能的。
所以,小程序理论上,了解了WXML标签读含义和功能,了解了微信提供的哪些接口交互。再了解一下小程序的机制,基本上就算是会小程序了。
这里,用微信小程序和百度地图提供的天气接口,来简单说一说,如何做一款自己的简单的微信小程序
一、准备工作
账号申请
※ 微信公众平台的账号申请:https://mp.weixin.qq.com/
※ 百度地图开放平台帐号申请:http://lbsyun.baidu.com/
开发微信小程序,是必须要在微信公众帐号平台注册的,并找到AppID(小程序ID),这个是核心所有小程序开发都要有。
这个是关键的东西,小程序需要在微信提供的“微信web开发者工具”,这个工具需要微信登录,所有小程序项目开发必须要输入AppID。
微信公众平台帐号申请完成之后,登录。
左菜单【开发->开发设置】中,就可以看到AppID,是一串类似于乱码的字符串。类似这样:wx123abc456bcd789cde
在微信开发工具中,需要的地方,填入这个AppID即可。
百度地图开放平台申请帐号的目的是为了获取一个访问应用(AK),这个AK是关键,任何调用百度地图相关接口时需要使用这个AK初始化接口。
进入控制台,应用列表里,就可以根据页面的提示,自行操作,创建一个或者多个AK,不同项目申请不同的AK。
这两部分准备工作做好之后,就可以正式开始开发小程序了。
二、第一个小程序
这个不需要做什么操作,只要打开“微信web开发者工具”,创建一个小程序项目,就会得到一个最基本的小程序项目
直接编译就可以通过模拟器部分看到一个hello world的小程序
自行调试,测试,看看这第一个程序源码即可。当然最基本的地方是非常简单的。代码有编程基础的人都能看懂。
其中,只有获取当前微信信息的部分稍微绕了一点。尤其是那个莫名奇妙的“回调程序”。
不过好在,短期内不理解,可以直接使用,随着日后逐渐开发反复调用,慢慢可以摸索。
三、微信小程序(百度地图API)天气预报
先说下大致的思路:
主要是两部分:定位授权和天气数据获取
在页面加载时,先验证当前是否有用户授权定位信息,如果没有,则提示,并引导用户授权定位信息。
接下来,如果用户已经授权定位信息之后,则调用一些列天气相关的接口,获取相应的数据,部分数据或许需要二次处理,然后保存到当前功能文件的data中。
页面渲染时,会根据data中的值,或显示显示,或隐藏标签,或者显示具体的数据。
开始说实例,首先,pages目录里的logs相关的都可以删除,app.json配置里的也同样,基本上和logs有关的这次都不需要,只保留index相关即可
当然根目录下的不要删除。
先说不是主要的部分
1、配置文件xxx.json文件
<loading hidden="{{loadingStatus}}">
加载中...
</loading>
<view wx:if="{{userLocation == 3}}" class="box weather_bg list_left">
<text class='tips' bindtap='refreshCurrentPage'>
定位异常,无法正确获取您的定位信息\n
1.请重新刷新页面\n
2.尝试换个地方重新刷新页面\n
3.晚些时候再刷新页面\n
4.非中国境内,无法正确获取\n
5.如果上述操作依然存在问题,请联系作者
</text>
</view>
<view wx:if="{{userLocation == 2}}" class="box city_title list_center">
<text class='tips' bindtap='refreshCurrentPage'>
没有授权获取定位信息,功能无法使用\n
确认授权后,请下拉或者点击文字刷新获取数据
</text>
<button class='btn' bindtap='gotoAuthPage'>点击开启授权</button>
</view>
<view wx:elif="{{userLocation == 1}}">
<view class="box city_title">
<view class="city">{{cityInfo.addressComponent.city}}</view>
<view class="pos">( {{cityInfo.location.lat}} , {{cityInfo.location.lng}} )</view>
</view>
<view class="box city_info">
<view>地址:{{cityInfo.formatted_address}}</view>
<view>邮编:{{cityInfo.addressComponent.adcode}}</view>
<view>周边:{{cityInfo.business}}</view>
</view>
<view class='box weather_title'>天气情况</view>
<view class="box weather_info">
<view class='f_red'>{{weatherInfo.date}}</view>
<view>
<text class='f_black'>{{weatherInfo.weatherDesc}}</text>
<text class='ml20'>{{weatherInfo.temperature}}</text>
<text class='ml20'>{{weatherInfo.wind}}</text>
</view>
<view>PM2.5:{{weatherInfo.pm25}}</view>
</view>
<block wx:for="{{weatherInfoExt}}" wx:key="index">
<block wx:if="{{index > 0}}">
<view class="box weather_info">
<image wx:if="{{currentTime >= '06' && currentTime < '18'}}" src='{{item.dayPictureUrl}}' mode="aspectFill" class='pic'></image>
<image wx:else src='{{item.nightPictureUrl}}' mode="aspectFill" class='pic'></image>
<text class='ml20'>{{item.date}}</text>
<text class='ml20'>{{item.temperature}}</text>
<text class='ml20'>{{item.weather}}</text>
<text class='ml20'>{{item.wind}}</text>
</view>
</block>
</block>
</view>
这个模板文件,主要分成四个部分:加载浮层、定位异常提示、未授权提示、正常天气预报展示
简单说明:
loading标签,效果是一个特效,一个“loading...”的浮层浮在手机页面上,数据和页面加载完成之后,可以控制其隐藏
wx:if="{{userLocation == 3}}"相关标签,这个部分是当获取定位信息失败,或者超出接口范围时,显示提示信息
wx:if="{{userLocation == 2}}"相关标签,这个部分是当前用户没有授权定位信息,展示的提示信息,并提供授权引导按钮
剩下的标签代码,就是正常的天气信息显示的部分。
页面上所有用{{}}这种双大括号括起来的都是变量标签,用于获取变量信息的,例如:{{userLocation == 2}}读出变量usesrLocation的值和2比较大小
这些变量的值,都来自于xxx.js文件的Page->data里边定义的变量。
3、样式文件xxx.wxss
page{
padding:;
background: #fdfdfd;
}
view{
font-size: 32rpx;
color: #333;
font-family: "微软雅黑";
}
image{
text-align: center;
vertical-align:middle;
}
/* 通用部分 */
.box{
margin: 24rpx;
padding: 24rpx;
line-height: 180%;
}
.box_bg {
background: #f0f6fa;
}
.list_left{
text-align: left;
line-height: 100%;
padding-left: 40rpx;
}
.list_center{
text-align: center;
line-height: 100%;
padding:;
}
/* 城市信息部分 */
.city_title{
align-items: center;
display: flex;
flex-direction: column;
margin: -8rpx 0 -20rpx 0;
padding-bottom:;
}
.city_title .btn{
margin-top: 30rpx;
font-size: 28rpx;
color: #000;
}
.city_title .city{
font-size: 36rpx;
color: #000;
}
.city_title .pos{
font-size: 32rpx;
}
.city_info{
border: 1px solid #efefef;
}
/* 天气信息部分 */
.weather_title{
margin-bottom: -16rpx;
padding-bottom:;
}
.weather_info{
color: #555;
border: 1px solid #efefef;
}
.weather_info .pic{
padding:;
margin:-4px 0 0 0;
width:22px;
height:16px
}
.weather_info .f_red{
color: red;
}
.weather_info .f_black{
color:black;
}
.weather_info .ml20{
margin-left: 20rpx;
}
// 获取全局app.js中的内容
const app = getApp();
// 引用工具文件
var util = require('../../utils/util.js');
// 引用百度地图提供的接口JS文件
var bmap = require('../../utils/bmap-wx.min.js'); Page({
// 数据初始化
data: {
loadingStatus: false,
userLocation: 0, // 0默认没有状态,1获取到用户定位,2用户拒绝提供定位信息,3无法获取正确定位
cityInfo: {}, //城市信息
weatherInfo: {}, //天气信息
weatherInfoExt: {}, //天气扩展信息
currentTime:'' // 当前时间
}, // 更新用户的位置获取的状态
updateUserLocation: function (v) {
this.setData({
loadingStatus: true,// 加载完成,隐藏加载动画
userLocation: v //更新当前页面的变量值
});
}, // 跳转到授权页面
gotoAuthPage: function(){
wx.openSetting({
fail: function () {
wx.showModal({
title: '操作失败',
content: '请到微信中自行设置授权操作',
confirmText: '知道了',
confirmColor: '#345391',
showCancel: false
})
}
});
}, // 刷新当前页面(相当于下拉刷新页面)
refreshCurrentPage: function(){
wx.startPullDownRefresh({});
}, // 获取地理位置和天气的方法
getLocationAndWeather: function () {
var that = this;
// 使用百度地图提供的ak标记,初始化地图数据
var BMap = new bmap.BMapWX({
ak: app.globalData.bmap_ak
});
// 失败执行的方法
var fail = function (data) {
if (data.errMsg == 'getLocation:fail auth deny') {
// 更新页面状态为2,用户拒绝提供位置信息
that.updateUserLocation(2);
}else{
// 更新页面状态为3,获取定位信息错误,或者定位不在大陆境内
that.updateUserLocation(3);
}
};
// 获取城市信息成功执行的方法
var regeocoding_success = function (data) {
// 获取地址数据
var city_info = data.originalData.result;
// 二次处理数据,将经纬度的数据,保留四舍五入保留五位小数
city_info.location.lat = city_info.location.lat.toFixed(5);
city_info.location.lng = city_info.location.lng.toFixed(5);
// 更新页面状态为1,用户允许授权定位信息
that.updateUserLocation(1);
// 将相关数据,写到初始化的data数据中
that.setData({
cityInfo: city_info
});
};
// 获取天气成功执行的方法
var weather_success = function (data) {
// 获取天气基本数据
var weatherInfo = data.currentWeather[0];
// 获取天气扩展信息
var weatherInfoExt = data.originalData.results[0].weather_data;
// 将天气预报数据写入定义(初始化)的变量中
that.setData({
weatherInfo: weatherInfo,
weatherInfoExt: weatherInfoExt
});
// 天气获取成功之后,再调用其他数据(regeocoding接口有BUG,没有数据依然返回成功状态)
// 调用接口获取城市地区信息
BMap.regeocoding({
fail: fail,
success: regeocoding_success
});
};
// 调用接口获取天气信息
BMap.weather({
fail: fail,
success: weather_success
});
}, // 加载执行
onLoad: function () {
app.checkUserLocation();
// 获取当前时间,并拆分成日期和时间两部分
var current_time = util.formatTime(new Date()).split(' ');
// 将时间部分记录,用于判断早晚
this.setData({
currentTime: current_time[1]
});
// 调用获取天气和地理位置的方法
this.getLocationAndWeather();
}, // 下拉页面执行页面刷新
onPullDownRefresh: function () {
wx.showNavigationBarLoading(); // 显示顶部刷新图标
this.getLocationAndWeather(); // 调用获取天气和地理位置的方法
wx.hideNavigationBarLoading(); // 隐藏导航栏加载框
wx.stopPullDownRefresh(); // 停止下拉动作
} })
基本上所有的功能都是在js文件中完成的。
简单说明:
将utils目录里的util.js文件引入到当前页面,同时,可以通过util这个变量访问该文件声明开放的方法。此文件默认自带
App({
globalData: {
userInfoAuth: 0,//0无状态,1用户已经授权用户信息,2用户拒绝授权用户信息
// 用户信息
userInfo: null,
// 百度地图提供的AK串
bmap_ak: '百度地图开放平台的AK值',
// cur_city_id: '' // 用于记录城市ID,在切换城市时,将目标城市ID记录,需要时读取
}, // 监听初始化
onLaunch: function () { }, onShow: function () { },//监听显示(进入前台)
onHide: function () { },//监听隐藏(进入后台:按home离开微信) // 设置所在地(城市)
// setLocal: function (id, val) {
// wx.setStorageSync(id, val);//API:设置本地缓存,将数据存储在本地缓存中
// }, // 用户位置授权验证及操作
checkUserLocation: function () {
var that = this;
// 获取授权信息
wx.getSetting({
success: function (res) {
// 判断是否已经操作过授权操作
if (res.authSetting.hasOwnProperty("scope.userLocation")) {
if (res.authSetting["scope.userLocation"] == true) {
// 已经授权位置信息,暂时无操作
} else {
// 没有授权位置信息,弹出选择框提示用户选择操作
wx.showModal({
title: '信息授权',
content: '提示:位置授权暂未开启,无法获取相关信息',
confirmText: '开启授权',
cancelText: '仍然拒绝',
// confirmColor: '#345391',
cancelColor: '#666',
success: function (res) {
if (res.confirm) {
// 用户选择“允许”,则开启授权页面
wx.openSetting({
fail: function () {
wx.showModal({
title: '操作失败',
content: '请到微信中自行设置授权操作',
confirmText: '知道了',
confirmColor: '#345391',
showCancel: false
})
}
})
}
// 用户选择“拒绝”,则弹层提示无法获取数据
if (res.cancel) {
wx.showModal({
title: '授权失败',
content: '无法使用定位权限,不能获取到数据',
confirmText: '知道了',
confirmColor: '#345391',
showCancel: false
})
}
}
})
}
} else {
// 还没有操作位置授权,暂时不做处理
}
}
})
} })
所有代码都是可以直接复制使用,放到小程序里就可以执行了。但是需要自己申请小程序AppID和百度的ak值。
附效果图: