/约定/ 让我们轻装上阵
一个功能页(Page)的开发通常需要四大块:配置、代码、布局、样式。
这四大块承载不同的方面,要独立不混杂,又要整体融合。于是有了以下约定:
每一块 --> 独立的文件、相同的文件名、不同的扩展名。
按约定行事,自动融合。
于是,一个小程序的功能页 Page,就这样形成了。
- index.json
- index.js
- index.wxml
- index.wxss
而 app.js,app.json,app.wxss 则作为全局定义。
再继续来看代码部分
它少不了这三大块:数据、生命周期、功能过程。
不需要额外的配置,约定一种结构方式即可。
Page({ data, on阶段, func... })
再来看四大块中的交互
通过约定之后,可谓我中有你,你中有我,wxss 定义的名称,wxml 可以根据需要使用,js 定义的数据,wxml 可以灵活呈现,数据变,呈现自动变。
常用表达
1.点击事件
通过 bindtap 属性指定一个功能函数名称即可。以下示例中,{{ msg }}
绑定代码中定义的数据属性 msg,按钮点击事件,执行代码中的 clickMe 功能函数,它改变了 msg 的值,则页面也会相应的呈现新的值。
<view>{{ msg }}</view>
<button bindtap="clickMe">点击我</button>
Page({
data: { msg : null },
clickMe: function() {
this.setData({ msg: "Hello World" })
}
})
2.页面跳转
wx.navigateTo({
url: '../mypage',
})
当存在参数时,如:
/mypage?id=123
可通过 onLoad 里 options 可取得参数,如 options.id
Page({
onLoad: function (options) {
console.log(options.id);
},
3.获取输入值
输入控件 bindinput
指定输入事件,在传递的参数(如参数名为 e)中通过 e.detail.value
可以取到值。
<input id="ipt" bindinput='iptInput'></input>
iptInput: function(e){
this.setData({ iptValue : e.detail.value});
}
4.JSON转换
stringify(object)
: 将 object 对象转换为 JSON 字符串,并返回该字符串。
parse(string)
: 将 JSON 字符串转化成对象,并返回该对象。
5.WEB 请求
普通请求
在调试阶段,项目可以设置:开发环境不校验安全域名TLS版本与HTTPS证书。这样可以使用 http 做测试,正式环境要求使用 https。
wx.request({
url: 'http://.../test.php',
data: {
x: ''
},
header: {
'content-type': 'application/json' // 默认值
},
success: function(res) {
console.log(res.data)
}
})
文件上传
wx.uploadFile({
url: 'http://.../upload',
filePath: this.data.fileinfo.path,
name: 'myfile',
formData: {
id: "busiid",
},
success: function (resu) {
console.log(resu);
wx.showToast({
title: '请求成功',
})
},
fail: function(err){
wx.showToast({
title: '错误' + err.errMsg
})
console.log(err);
}
})
6.消息提示
wx.showModal({
title: '消息',
content: '您点击了',
showCancel: false
})
wx.showToast({
title: '错误' + err.errMsg
})
7.引入weui-wxss
两个步骤
7.1下载
https://github.com/Tencent/weui-wxss/blob/master/dist/style/weui.wxss
7.2引用
将weui.wxss 放在与 app.wxss 同一目录下。在app.wxss 中最前边引用即可。
@import 'weui.wxss';
文档:https://github.com/Tencent/weui/wiki
8.其它
当异步方法中要更新数据时,不能直接使用 this.setData
,此时,可以在异步发起代码前加上 let that = this;
,然后使用 that.setData
来操作。
在 app.json 配置 tabBar 可以直接定义底部导航。
{
"tabBar": {
"color": "#ddd",
"selectedColor": "#3cc51f",
"backgroundColor": "#fff",
"borderStyle": "black",
"list": [
{
"pagePath": "pages/index/index",
"text": "首页"
},
{
"pagePath": "pages/profile/profile",
"text": "我的"
}
]
}
}
其它组件、模板,WXS(WeiXin Script)参考官方开发文档。