在微信开发H5页面的时候,往往借助于WeUI或者Jquery WeUI等基础上进行界面效果的开发,由于本人喜欢在Asp.net的Web界面上使用JQuery,因此比较倾向于使用 jQuery WeUI,本篇随笔结合官方案例和自己的项目实际开发过程的经验总结,对在H5页面开发过程中设计到的界面控件进行逐一的分析和总结,以期能够给大家在H5页面开发过程中提供有用的参考。
本篇随笔继续上篇随笔《基于Jquery WeUI的微信开发H5页面控件的经验总结(1)》进行介绍其他部分的内容。
7)条码、二维码生成****
在我们做一些扫码操作的时候,我们可能需要根据一些参数生成一些URL,然后生成一个二维码的方式,方便手机扫码直接查看,或者给一些条码设备进行条码的读取,那么这两种情况结合起来就是二维码和条码的处理场景。
例如下面的处方信息展示里面,就需要这样的场景。
二维码QRCode使用的地址是:https://github.com/davidshimjs/qrcodejs
条码JsBarcode使用的地址是:https://github.com/lindell/JsBarcode
使用前,我们引入所需要的qrcodejs和JsBarcode的JS库文件。
二维码和条码的处理脚本很简单,如下JS代码所示。
//条码
JsBarcode("#barcode", "@ViewBag.Info.PrescriptionNo", {
format: "CODE128",
lineColor: "#0aa",
height: 50,
displayValue: false
});
//二维码
var url = '@ViewBag.WebsiteDomain/h5/[email protected]';
var qrcode = new QRCode(document.getElementById("qrcode"), {
text: url, //"@ViewBag.Info.PrescriptionNo",
width: 128,
height: 128,
colorDark : "#000000",
colorLight : "#ffffff",
correctLevel : QRCode.CorrectLevel.H
});
使用脚本处理的方式非常不错。
8)JQuery的Ajax/Post/Get等相关处理
在我们前面很多案例代码里面,都采用了JQuery的Ajax/Post/Get/getJSON等函数,它们之间很多时候可以相互替代,差异只是很少的部分。
.get( url [, data] [, callback] )。如下代码所示。
$.getJSON()是专门为ajax获取json数据而设置的,并且支持跨域调用,其语法的格式为:getJSON(url,[data],[callback])。
var flowUsers = [];
var url = '/qyh5flow/GetCorpUser';
$.getJSON(url, function (data) {
$.each(data, function (i, item) {
flowUsers.push({
title: item.name, value: item.userid
});
});
$("#txtSelectSignUser").select({
title: "选择会签人员",
items: flowUsers,
multi: true,
//min: 2,
//max: 3,
});
});
.getJSON()两种方法,后者比前者多了一个对返回数据进行JSON转换对象的处理,$.get()方法需要使用下面代码进行JSON的转换。
var data = $.parseJSON(json);
.post(url,[data],[callback],[type]),这个相对于$.get()的操作,使用POST方式提交。
其中的type:type为请求的数据类型,可以是html,xml,json等类型,如果我们设置这个参数为:json,那么返回的格式则是json格式的,如果没有设置,就和$.get()返回的格式一样,都是字符串的。
如下代码是我们使用.parseJSON进行返回值JSON转换对象的处理。
$.post(url, postData, function (json) {
//转义JSON为对象
var data = $.parseJSON(json);
if (data.Success) {
$.toptip("删除成功!", 'success');
//在界面上找到对应控件ID,移除控件
RemoveImg();
}
else {
$.toast("操作失败:" + data.ErrorMessage, "forbidden");
}
});
.ajax(options),其中options是一个object类型,它指明了本次ajax调用的具体参数。
一般在使用FormData对象的时候,我倾向于使用$.ajax进行处理,以便更多的弹性化设置。
//提交表单数据和文件
var url = "/qyH5Flow/[email protected]";
$.ajax({
url: url,
type: 'post',
processData: false,
contentType: false,
data: formData,
success: function (json) {
//转义JSON为对象
var data = $.parseJSON(json);
if (data.Success) {
$.toast("保存成功,稍后请到列表界面查看。");
}
else {
$.toast("保存失败:" + data.ErrorMessage, "forbidden");
}
}
});
以上就我进行在案例里面使用的各种操作,有时候可以相互替换,根据需要选择不同的操作方式即可。
9)JS脚本的数组对象处理
上面我们使用了各种异步的操作,如JQuery的Ajax/Post/Get/getJSON等函数操作,经常会涉及对数组的遍历处理或者插入处理。
JS数组是一个很的强大的数组对象,支持很多复杂的操作,对数组的操作也是我们经常处理的方式之一。
例如对于返回的数据,我们一般需要进行数组的遍历,然后逐一追加到界面显示,这里就需要使用$.each()函数。
//动态处理图片绑定
$.getJSON("/Qyh5Flow/GetImageList2?attachGuid=" + info.AttachGUID, function (data) {
$.each(data, function (i, item) {
$("#imgAttach").append(``);
});
});
$.each()函数另一个经常使用的场景就是根据JQuery选择器进行元素集合的遍历处理。
var itemCount = 0;
//计算单选框的选中数量
$("input[type='radio']:checked").each(function(){
itemCount += 1;
});
//复选框选中算一个
var chkName = []
$("input[type='checkbox']:checked").each(function () {
var name = $(this).attr('name');
if (chkName.indexOf(name) < 0) {
itemCount += 1;
chkName.push(name);
}
});
我们在需要加入对象的时候,就需要使用push()函数操作了,有时候往往和$.each()函数配合使用。
var items = [];
$.each(data, function (i, item) {
items.push({
title: item.Text, value: item.Value
});
});
或者进行元素遍历查询的时候,如下代码所示。
//构建选中的列表内容
var list = [];
//计算单选框
$("input[type='radio']:checked").each(function () {
list.push($(this).val());
});
//计算复选框
$("input[type='checkbox']:checked").each(function () {
list.push($(this).val());
});
如果我们需要判断某个对象是否在集合里面,我们就会用到$.inArray() 函数进行判断,如下代码所示。
if ($.inArray(key, addKeyList) == -1) {
addKeyList.push(key);
addValueList.push(value);
sendList.push({ key: key, value: value});
$('#tagsToSend').addTag(value);
}
另外,我们对数组还需要了解,如何移除单个或者所有的集合,这个就用到了splice()函数,如下代码所示。
addKeyList.splice(i, 1);//移除某个对象
addValueList.splice(i, 1);//移除某个对象
sendList.splice(i, 1);//移除某个对象
如果需要清空数组,常用的做法如下所示,也是使用splice()函数。
//清空用户选择
function ClearChoice() {
$('#tagsToSend').importTags('');
sendList.splice(0, sendList.length);//待发送的部门、标签、用户列表
addKeyList.splice(0, addKeyList.length);//键的集合
addValueList.splice(0, addValueList.length);//值的集合
}
以上就是我们操作数据的时候,经常使用的一些方法。
10)查询即时列表展示
有时候,我们需要根据查询的条件,对数据库的信息进行检索,然后即时的显示在列表中,供选择使用,如下界面所示。
上图是我项目中,根据拼音码或者名称对药品进行检索,返回的数据进行显示的处理。
为了使用搜索栏,我们使用了微信WeUI定义的搜索栏样式,以下是界面定义的搜索栏DIV层,如下代码。
我们在JS代码上执行对应事件的处理,如下所示。
主要就是监控Input控件的内容变化,进行及时的查询和内容展示。
//查询框输入内容触发事件
$('#searchInput').bind('input propertychange', function () {
var name = $("#searchInput").val();
//获取Json对象集合,并生成数据显示内容
var url = "/h5/FindDrugWithPager?page=1&rows=5&Name=" + encodeURI(name);
$.getJSON(url, function (data) {
$("#searchContent").html("");
var html = "";
$.each(data.rows, function (i, item) {
var background = (i % 2 == 0) ? "background-color:Highlight" : "";
html += `
` + item.CommonName + ``+ item.Specification +`
商品名:` + item.ProductName + `
厂 家:`+item.Manufacturer +`
`;
});
$("#searchContent").html(html);
});
});
function cancel() {
$("#searchContent").empty();
}
function clear() {
$('#searchInput').val('')
$("#searchContent").empty();
}
这里的HTML模板,我们有时候也使用代码块的方式,在模板代码里面插入变量,如下所示。
$.getJSON("/Qyh5Flow/GetImageList2?attachGuid=" + info.AttachGUID, function (data) {
$.each(data, function (i, item) {
$("#previewImage").append(``);
});
});
这里的代码块,开始和结束符使用了 符号块,其中插入了变量{item.Value}等变量字符串,并没有打断模板的内容,如果多行,我们一样的处理,非常方便。
$.getJSON(url, function (data) {
var html = "";
$.each(data.rows, function (i, item) {
html += `
${item.FormName}:${item.EditorName},${item.Edittime}
${GetStatus(item.Status)}
标题:${item.Title}
当前处理类型:${item.Proc_TypeName}
当前处理人:${item.Proc_UserName}
`;
});
$("#" +divname).html(html);
});
这是我们推荐使用的JS代码块,整块代码都不影响阅读,而且可以换行排版,非常直观。
11)界面弹窗处理
在微信Weui里面定义了几种常规的弹窗处理。
对话框只能通过 JavaScript 进行调用,微信WeUI提供了三种常用的对话框 Alert, Confirm, Prompt 和 Login。我们也可以通过 $.modal
来自定义对话框
实际上, Alert, Confirm, Prompt 和 Login 都是 Modal 的一种定制而已。
一般的JS调用代码如下所示。
//常规提示窗口
$.alert("自定义的消息内容", "自定义的标题");
//确认提示窗口
$.confirm("自定义的消息内容", "自定义的标题", function() {
//点击确认后的回调函数
}, function() {
//点击取消后的回调函数
});
例如我们在流程表单处理里面,会在操作前进行提示用户是否确认处理。
//退回拟稿人重新处理
function ApplyCancel(opinion) {
var tipMessage2 = "数据检查完毕,如确认无误将【退回拟稿人重新处理】,您确实要提交吗?";
$.confirm(tipMessage2, "退回拟稿人重新处理?", function () {
var userid = "@ViewBag.userid";
var applyid = "@Request["id"]";
var url = "/QyH5Flow/SkipFirstApply";
//构造参数发送给后台
var postData = {
userid: userid,
applyId: applyid,
opinion: opinion
};
$.post(url, postData, function (json) {
var data = $.parseJSON(json);
if (data.Success) {
//console.log(data);
//提示处理结果
$.toast("您已经退回经办人进行修改。");
$.closePopup();
initControls();//重新加载
}
else {
$.toast("操作失败:" + data.ErrorMessage);
}
});
}, function () {
//取消操作
});
}
登陆窗口界面效果如下所示。
$.login("自定义的消息内容", function(username, password) {
// 这里进行登录操作
}, function() {
});
//如果参数过多,建议通过 object 方式传入
$.login({
title: '标题',
text: '内容文案',
username: 'tom', // 默认用户名
password: 'tom', // 默认密码
onOK: function (username, password) {
//点击确认
},
onCancel: function () {
//点击取消
}
});
我们可以利用登录框进行一个系统账号的绑定,如下是实际项目的处理代码。
$(document).on('click', '#btnBind', function() {
$.login({
title: '登录',
text: '请输入用户名和密码',
onOK: function (username, password) {
var url = "/H5/[email protected]";
var postData = {
username: username,
password: password
};
$.post(url, postData, function (json) {
//转义JSON为对象
var data = $.parseJSON(json);
if (data.Success) {
$.toptip('登录成功!');
location.reload();//刷新页面
//WeixinJSBridge.call('closeWindow');//关闭窗口
}
else {
$.toptip("登录失败:" + data.ErrorMessage, "forbidden");
}
});
},
onCancel: function () {
$.toptip('取消登录!', 'cancel');
}
});
});
上述的几种对话框都是 .modal 来定制对话框
$.modal({
title: "Hello",
text: "我是自定义的modal",
buttons: [
{ text: "支付宝", onClick: function(){ console.log(1)} },
{ text: "微信支付", onClick: function(){ console.log(2)} },
{ text: "取消", className: "default", onClick: function(){ console.log(3)} },
]
});
默认情况下,点击对话框的按钮都会先关闭对话框再触发回调函数。可以通过JS来关闭任何正在显示的对话框:
$.closeModal();
除了上面的几种情况的模态对话框,还有一种是Popup弹出遮盖下面页面的场景,如常规的购物车的情况。
Popup 是一个覆盖式的弹出层,可以完全盖住当前页面或者遮盖一半。
例如我在流程处理页面中,往往需要进行审核、会签处理的时候,弹出对应的处理内容,这个就是Popup的使用场景。
我们通过JS进行调用显示窗口。
$("#SignAction").popup();//主动弹出窗口
其中SignAction层就是一个popup的窗口层,视图HTML代码如下所示。
我们只需要注意到 class='weui-popup__container popup-bottom' 的说明,就知道它的样式了,从底部弹出的Popup窗口。
如果没有加上Popup-bottom的样式,那么就是全屏覆盖的模式。
关闭 Popup
给任何链接加上 class='close-popup'
则点击之后可以关闭当前打开的 popup. 你也可以通过 $.closePopup()
来关闭。
12)微信JSSDK的整合等处理
微信JSSDK提供了很多丰富的功能,我们可以利用JSSDK实现图片的上传、预览、扫码等操作,图片上传由于我使用了附件上传的方式,因此不在介绍较为繁琐的JSSDK图片上传模式,有兴趣可以参考我之前随笔《微信开发中使用微信JSSDK和使用URL.createObjectURL上传预览图片的不同处理对比》了解下不同。
a) 图片预览
一般我们在一些查看内容的视图界面里面,往往对图片进行预览操作,这时候可以利用JSSDK的图片预览接口,在使用JSSDK接口前,需要进行接口的初始化,然后才能调用,下面是初始化和调用的案例代码。
而图片的初始化,我们可以在HTML代码进行处理即可。
@if (ViewBag.PresImages != null)
{
for (var i = 0; i < ViewBag.PresImages.Count; i++)
{
}
}
b) 调用扫码处理
我们可以利用JSSDK调用手机的扫码操作,让其进行相应的扫码处理,如下是使用JSSDK进行扫码的JS代码。
上面扫码后,识别判断URL,如果是URL,那么页面地址自动调整到相应的界面上去。
以上就是一些实际项目中运用到的各种界面处理和JS处理代码,抛砖引玉,希望大家多多支持和鼓励。