**天气小程序开发教程?学习了一段时间小程序,大致过了两遍开发文档,抽空做个自己的天气预报小程序,全当是练手,在这记录下。小程序开发的安装、注册和接入等流程就不罗列了,在小程序接入指南已经写得很清楚了,以下只对开发过程常用到得一些概念进行简单梳理,类比 Vue 加强记忆,***后选取个人项目天气小程序中要注意的几点来说明。
初始化项目目录结构
安装好开发者工具,填好申请到的 AppID,选好项目目录,初始化一个普通小程序目录结构,得到:
--|-- pages
|-- index
|-- index.js // 首页js文件
|-- index.json // 首页json文件
|-- index.wxml // 首页wxml文件
|-- index.wxss // 首页wxss文件
|-- logs
|-- logs.js // ***志页js文件
|-- logs.json // ***志页json文件
|-- logs.wxml // ***志页wxml文件
|-- logs.wxss // ***志页wxss文件
|-- utils
|-- util.js // 小程序公用方法
|-- app.js // 小程序逻辑
|-- app.json // 小程序公共配置
|-- app.wxss // 小程序公共样式表
|-- project.config.json // 小程序项目配置
可以看到,项目文件主要分为 .json、 .wxml, .wxss和 .js类型,每一个页面由四个文件组成,为了方便开发者减少配置,描述页面的四个文件必须具有相同的路径与文件名。
JSON配置
小程序配置 app.json
app.json配置是当前小程序的全局配置,包括小程序的所有页面路径、界面表现、网络超时时间、底部 tab 等。
工具配置 project.config.json
工具配置在小程序的根目录,对工具做的任何配置都会写入这个文件,使得只要载入同一个项目代码包,开发则工具会自动恢复当时你开发项目时的个***设置。
页面配置 page.json
页面配置 是小程序页面相关的配置,让开发者可以独立定义每个页面的一些属***,比如顶部颜***,是否下拉等。
WXML 模板
WXML 充当类似 HTML 的角***,有标签,有属***,但是还是有些区别:
1、标签名不一样。
写 HTML 常用标签 <div>, <p>, <span>等,而小程序中标签更像是封装好的组件,比如 <scroll-view>, <swiper>, <map>,提供相应的基础能力给开发者使用。
2、提供 wx:if, {{}}等模板语法。
小程序将渲染和逻辑分离,类似于 React, Vue的 MVVM开发模式,而不是让 JS 操作 DOM。
下面针对小程序的数据绑定、列表渲染、条件渲染、模板、事件和应用跟 Vue 类比加深记忆。
数据绑定
WXML 中的动态数据均来自对应 Page(或 Component) 的 data,而在 Vue中来自当前组件。
小程序和Vue的数据绑定都使用 Mustache 语法,双括号将变量包起来。区别是 Vue 中使用 Mustache 语法不能作用在 HTML 特***上:
<div v-bind:id="'list-' + id">{{msg}}</div>
而小程序作用在标签属***上:
<view id="item-{{id}}">{{msg}}</view>
列表渲染
Vue 中使用 v-for 指令根据一组数组的选项列表,也可以通过一个对象的属***迭代进行渲染,使用 (item,index)initems 或 (item,index)of items 形式特殊语法。
<ul>
<li v-for="(item, index) in items">
{{ index }} - {{ item.message }}
</li>
</ul>
渲染包含多个元素,利用 <template>元素:
<ul>
<template v-for="(item, index) in items">
<li>{{ index }} - {{ item.message }}</li>
<li class="divider" role="presentation"></li>
</template>
</ul>
而在小程序中使用 wx:for 控制属***绑定一个数组(其实对象也可以),默认数组的当前项的下标变量为 index ,当前项变量为 item。
<view wx:for="{{items}}"> {{index}} - {{item.message}} </view>
也可以用 wx:for-item 指定数组当前元素的变量名,用 wx:for-index 指定数组当前下标的变量名。
<view wx:for="{{items}}" wx:for-index="idx" wx:for-item="itemName">
{{idx}}: {{itemName.message}}
</view>
渲染一个包含多节点的结构块,利用 <block> 标签:
<block wx:for="{{items}}">
<view> {{index}} - {{item.message}} </view>
<view class="divider" role="presentation"></view>
</block>
条件渲染
Vue 中使用 v-if、 v-else-if、 v-else指令条件渲染,多个元素使用 <template>包裹,而小程序中使用 wx:if、 wx:elseif、 wx:else来条件渲染,多个组件标签使用 <block>包裹。
模板
在 Vue 中定义模板一种方式是在 <script> 元素中,带上 text/x-template 的类型,然后通过一个id将模板引用过去。
定义模板:
<script type="text/x-template" id="hello-world-template">
<p>Hello hello hello</p>
<p>{{msg}}</p>
</script>
使用模板:
Vue.component('hello-world', {
template: '#hello-world-template',
data () {
return {
msg: 'this is a template'
}
}
})
而在小程序中,在 <template> 中使用 name 属***作为模板名称,使用 is 属***声明需要使用的模板,然后将模板所需的 data 传入。
定义模板:
<template name="hello-world-template">
<view>Hello hello hello</view>
<view>{{msg}}</view>
</template>
使用模板:
<template is="hello-world-template" data="{{...item}}"></template>
Page({
data: {
item: {
msg: 'this is a template'
}
}
})
事件
在 Vue 中,用 v-on 指令监听 DOM 事件,并在触发时运行一些 JavaScript 代码,对于阻止事件冒泡、事件捕获分别提供事件修饰符 .stop和 .capture的形式。
<!-- 阻止单击事件继续传播 -->
<a v-on:click.stop="doThis"></a>
<!-- 添加事件监听器时使用事件捕获模式 -->
<!-- 即元素自身触发的事件先在此处理,然后才交由内部元素进行处理 -->
<div v-on:click.capture="doThis">...</div>
而在小程序中,绑定事件以 key, value 的形式, key 以 bind 或 catch 开头,然后跟上事件的类型,如 bindtap、 catchtouchstart,也可紧跟一个冒号形式,如 bind:tap、 catch:touchstart。 bind事件绑定不会阻止冒泡事件向上冒泡, catch 事件绑定可以阻止冒泡事件向上冒泡。
<!-- 单击事件冒泡继续传播 -->
<view bindtap="doThis">bindtap</view>
<!-- 阻止单击事件冒泡继续传播 -->
<view catchtap="doThis">bindtap</view>
采用 capture-bind、 capture-catch 分别捕获事件和中断捕获并取消冒泡。
<!-- 捕获单击事件继续传播 -->
<view capture-bind:tap="doThis">bindtap</view>
<!-- 捕获单击事件阻止继续传播,并且阻止冒泡 -->
<view capture-catch="doThis">bindtap</view>
引用
在 Vue 中引用用于组件的服用引入:
import ComponentA from './ComponentA'
import ComponentC from './ComponentC'
在小程序中, WXML 提供两种引用方式 import 和 include。
在 item.wxml 中定义了一个叫item的template:
<!-- item.wxml -->
<template name="item">
<text>{{text}}</text>
</template>
在 index.wxml 中引用了 item.wxml,就可以使用item模板:
<import src="item.wxml" /> <template is="item" data="{{text: 'forbar'}}" />
include 可以将目标文件除了 <template> <wxs> 外整个代码引入:
<!-- index.wxml -->
<include src="header.wxml" /> <view> body </view> <include src="footer.wxml" />
<!-- header.wxml -->
<view> header </view>
<!-- footer.wxml -->
<view> footer </view>
WXSS 样式
WXSS(WeiXin Style Sheets) 具有 CSS 大部分的特***,也做了一些扩充和修改。
尺寸单位rpx
支持新的尺寸单位 rpx,根据屏幕宽度自适应,规定屏幕宽为750rpx,免去开发换算的烦恼(采用浮点计算,和预期结果会有点偏差)。
设备 rpx换算px(屏宽/750) px换算rpx(750/屏宽)
iPhone5 1rpx = 0.42px 1px = 2.34rpx
iPhone6 1rpx = 0.5px 1px = 2rpx
iPhone6 Plus 1rpx = 0.552px 1px = 1.81rpx
iPhone6上,换算相对***简单,1rpx = 0.5px = 1物理像素,建议设计师以 iPhone6 为设计稿。
样式导入
使用 @import 语句导入外联样式表,注意路径为相对路径。
全局样式与局部样式: app.wxss中的样式为全局样式,在 Page (或 Component) 的 wxss文件中定义的样式为局部样式,自作用在对应页面,并会覆盖 app.wxss 中相同选择器。
页面注册
小程序是以 Page(Object) 构造页面独立环境,app加载后,初始化某个页面,类似于 Vue 的实例化过程,有自己的初始数据、生命周期和事件处理回调函数。
初始化数据
和 Vue 一样,在构造实例属***上都有一个 data 对象,作为初始数据。
Vue 中修改 data 中某个属***值直接赋值即可,而在小程序中需要使用 Page 的实例方法 setData(Objectdata,Functioncallback) 才起作用,不需要在 this.data 中预先定义,单次设置数据大小不得超过1024kb。
支持以数据路径的形式改变数组某项或对象某项属***:
// 对于对象或数组字段,可以直接修改一个其下的子字段,这样做通常比修改整个对象或数组更好
this.setData({
'array[0].text': 'changed data'
})
生命周期回调函数
每个 Vue 实例在被创建时都要经过一系列的初始化过程,每一个阶段都有相应钩子函数被调用, created mounted updated destroyed。
对于小程序生命周期,分为 Page 的生命周期和 Component 的生命周期。
Page 的生命周期回调函数有:
onLoad 生命周期回调-监听页面加载
onShow 生命周期回调-监听页面显示
onReady 生命周期回调-监听页面初次渲染完成
onHide 生命周期回调-监听页面隐藏
onUnload 生命周期回调-监听页面卸载
onPullDownRefresh监听用户下拉动作
onReachBotton 页面上拉触底事件的处理函数
onShareAppMessage 用户点击右上角转发
onPageScroll 页面滚动触发事件的处理函数
onTabItemTap 当前是 tab 页时,点击 tab 触发
Component 的生命周期有:
created 在组件实例刚刚被创建时执行
attached 在组件实例进入页面节点树时执行
ready 在组件在视图层布局完成后执行
moved 在组件实例被移动到节点树另一个位置时执行
detached 在组件实例被从页面节点树移除时执行
error 每当组件方法抛出错误时执行
show 组件所在的页面被展示时执行
hide 组件所在的页面被隐藏时执行
resize 组件所在的页面尺寸变化时执行
wxs
WXS(WeiXinScript)是小程序的一套脚本语言,结合 WXML,可以构建出页面的结构。 wxs的运行环境和其他 JavaScript 代码是隔离的, wxs 中不能调用其他 JavaScript 文件中定义的函数,也不能调用小程序提供的API。从语法上看,大部分和 JavaScript是一样的,以下列出一些注意点和差别:
<wxs> 模块只能在定义模块的 WXML 文件中被访问。使用 <include> 或 <import> 时, <wxs> 模块不会被引用到对应的 WXML 文件中;
<template> 标签中,只能使用定义该 <template> 的 WXML 文件中定义的 <wxs> 模块;
Date对象,需要使用 getDate 函数,返回一个当前时间的对象;
RegExp对象,使用 getRegExp 函数;
使用 constructor 属***判断数据类型。
组件间通信
小程序组件间通信和 Vue 组件间通信很相似。
父组件传值到子组件
在 Vue 中,父组件定义一些自定义特***,子组件通过 props 实例属***获取,也可通过 wm.$refs 可以获取子组件获取子组件所有属***和方法。
<!-- 父组件 -->
<blog-post title="A title"></blog-post>
<!-- 子组件 -->
<h3>{{ postTitle }}</h3>
export default {
props: ['postTitle']
}
同样的,在小程序中,父组件定义一些特***,子组件通过 properties 实例属***获取,不同的是,提供了 observer 回调函数,可以监听传递值的变化。父组件还可以通过 this.selectComponent 方法获取子组件实例对象,这样就可以直接访问组件的任意数据和方法。
Component({
properties: {
myProperty: { // 属***名
type: String, // 类型(必填),目前接受的类型包括:String, Number, Boolean, Object, Array, null(表示任意类型)
value: '', // 属***初始值(可选),如果未指定则会根据类型选择一个
observer(newVal, oldVal, changedPath) {
// 属***被改变时执行的函数(可选),也可以写成在methods段中定义的方法名字符串, 如:'_propertyChange'
// 通常 newVal 就是新设置的数据, oldVal 是旧数据
}
},
myProperty2: String // 简化的定义方式
}
})
子组件传值到父组件
在Vue 中通过自定义事件系统触发 vm.$emit(eventName,[…args]) 回调传参实现。
<!-- 子组件 -->
<button v-on:click="$emit('enlarge-text')">
Enlarge text
</button>
<!-- 父组件 -->
<blog-post
...
v-on:enlarge-text="postFontSize += 0.1"
></blog-post>
同样的,在小程序中也是通过触发自定义事件 triggerEvent 回调传参形式实现子组件向父组件传递数据。
<!-- page.wxml -->
<my-component bindcustomevent="pageEventListener2"></my-component>
// my-component.js
Component({
methods: {
onTap () {
this.triggerEvent('customevent', {})
}
}
})
天气预报小程序
说了很多小程序开发的基础准备,下面就结合个人实际练手项目——天气预报小程序简单说明。
物料准备
从需求结果导向,天气程序首先要能获取到当前所在地天气状况,再次可以自由选择某地,知道其天气状况。这样就需要有获取天气的API和搜索地址API。
搜集了很多免费天气API,***终选中和风天气,原因很简单,它提供认证个人开发者申请,拥有更多使用功能和调用次数。
地址搜索和城市选择能力选用**自家产品腾讯位置服务**小程序JavaScript SDK。
开发前物料(服务能力)准备好了,接下来就是撸小程序了!
首页获取用户信息、布局相关
布局
**小程序的样式已支持大部分 CSS 特***,不用再去考虑太多传统浏览器兼容***问题了,布局方便直接选用 flex 布局。比如:
/**app.wxss**/
page {
background: #f6f6f6;
display: flex;
flex-direction: column;
justify-content: flex-start;
}
获取用户信息
首页首次加载获取用户,通常会弹窗提示是否允许获取用户信息,用户点击允许获取授权,才能成功获取用户信息,展示用户名和用户头像等,小程序为了优化用户体验,使用 wx.getUserInfo 接口直接弹出授权框的开发方式将逐步不再支持。目前开发环境不弹窗了,正式版暂不受影响。提倡使用 button 组件,指定 open-type 为 getUserInfo类型,用户主动点击后才弹窗。
天气小程序获取用户头像和用户名采用的是另一种方式,使用 open-data 可以直接获取用户基础信息,不用弹窗提示。
<!-- 用户信息 -->
<view class="userinfo">
<open-data type="userAvatarUrl" class="userinfo-avatar"/>
<text class="userinfo-nickname">{{greetings}},</text>
<open-data type="userNickName"/>
</view>
城市拼音首字母锚点
上下滑动城市列表,当滑过当前可视区的城市拼音首字母,右侧字母索引栏对应的字母也会切换到高亮显示。
要满足当前的这个场景需求,首先要为城市列表的拼音首字母标题添加标志( id),当 <scroll-view>滚动触发时获取各个标志位距离视窗顶部的位置,此处用到小程序 WXML 节点API NodesRef.boundingClientRect(functioncallback) 获取布局位置,类似于 DOM 的 getBoundingClientRect。距离大小为***小负数的标志位是当前刚滑过的,右侧索引栏对应字母应当高亮。
<!-- searchGeo.wxml -->
<scroll-view bindscroll="scroll" scroll-y="{{true}}">
<!-- 城市列表... -->
</scroll-view>
Page({
// ...
// 城市列表滚动
scroll () {
wx.createSelectorQuery().selectAll('.city-list-title')
.boundingClientRect((rects) => {
let index = rects.findIndex((item) => {
return item.top >= 0
})
if (index === -1) {
index = rects.length
}
this.setIndex(index - 1)
}).exec()
},
// ...
点击右侧字母索引栏的字母,城市列表自动滑动使得对应字母标题可视。
满足这个需求场景,可以利用 <scroll-view> 组件的 scroll-into-view 属***,由于已有拼音首字母标题添加标志( id),只需将当前点击的字母对应的元素 id滚动到可视即可。需要注意:
频繁 setData 造成***能问题,在这里过滤重复赋值;
由于设置了 <scroll-view> 为动画滚动效果,滚动到标志元素位置需要时间,途中可能会经过其它标志元素,不能立即设置索引焦点,要有一定延时(还没找到其它好解决方案,暂时这样)
// 点击索引条
tapIndexItem (event) {
let id = event.currentTarget.dataset.item
this.setData({
scrollIntoViewId: `title_${id === '#' ? 0 : id}`
})
// 延时设置索引条焦点
setTimeout(() => {
this.setData({
barIndex: this.data.indexList.findIndex((item) => item === id)
})
}, 500)
},
频繁触发节流处理
频繁输入,或者频繁滚动,回调触发会造成***能问题,而其接口也有限定调用频率,这样就需要做节流处理。节流是再频繁触发的***况下,在大于一定时间间隔才允许触发。
// 节流
const throttle = function(fn, delay) {
let lastTime = 0
return function () {
let nowTime = Date.now()
if (nowTime - lastTime > delay || !lastTime) {
fn.apply(this, arguments)
lastTime = nowTime
}
}
}
具体对一些场景,比如腾讯位置服务提供的关键字搜索地址,就限定5次/key/秒,很容易就超了,可以做节流处理。
Page({
// ...
// 输入搜索关键字
input: util.throttle(function () {
let val = arguments[0].detail.value
if (val === '') {
this.setData({
suggList: []
})
this.changeSearchCls()
return false
}
api.getSuggestion({
keyword: val
})
.then((res) => {
this.setData({
suggList: res
})
this.changeSearchCls()
})
.catch((err) => {
console.error(err)
})
}, 500),
// ...
})
对于上面城市列表滚动,获取标志元素位置也应用节流处理。本文摘自网络,侵删