簽到功能是許多網站用來提升使用者黏著度的常見設計。本文以 jQuery 搭配一段自架的日曆工具,示範如何做出「點擊簽到、日曆標記已簽到日期」的完整流程,並包含前端畫面、樣式、頁面前後端串接三個部分。
日曆的核心是一個 calUtil 物件,主要負責三件事:計算某月天數、建立月曆二維陣列、以及把日曆渲染成 HTML。其中 ifHasSigned 方法會比對已簽到清單,決定每一天要不要加上已簽到的樣式。
var calUtil = {
// 取得某年某月的天數
getDaysInmonth: function(iMonth, iYear) {
var dPrevDate = new Date(iYear, iMonth, 0);
return dPrevDate.getDate();
},
// 建立月曆矩陣(含星期抬頭)
bulidCal: function(iYear, iMonth) {
var aMonth = [];
for (var r = 0; r < 7; r++) aMonth[r] = new Array(7);
var dCalDate = new Date(iYear, iMonth - 1, 1);
var iDayOfFirst = dCalDate.getDay();
var iDaysInMonth = calUtil.getDaysInmonth(iMonth, iYear);
var iVarDate = 1, d, w;
aMonth[0] = ["日", "一", "二", "三", "四", "五", "六"];
for (d = iDayOfFirst; d < 7; d++) aMonth[1][d] = iVarDate++;
for (w = 2; w < 7; w++) {
for (d = 0; d < 7; d++) {
if (iVarDate <= iDaysInMonth) aMonth[w][d] = iVarDate++;
}
}
return aMonth;
},
// 判斷某天是否已簽到
ifHasSigned: function(signList, day) {
var signed = false;
$.each(signList, function(index, item) {
if (item.signDay == day) { signed = true; return false; }
});
return signed;
},
// 將月曆渲染為 HTML 字串
drawCal: function(iYear, iMonth, signList) {
var myMonth = calUtil.bulidCal(iYear, iMonth);
var htmls = [];
htmls.push("<div class='sign_main' id='sign_layer'>");
htmls.push("<div class='sign_succ_calendar_title'>");
htmls.push("<div class='calendar_month_span'>" + iYear + "年" + iMonth + "月</div>");
htmls.push("</div>");
htmls.push("<div class='sign' id='sign_cal'><table><tr>");
for (var d = 0; d < 7; d++) htmls.push("<th>" + myMonth[0][d] + "</th>");
htmls.push("</tr>");
for (var w = 1; w < 7; w++) {
htmls.push("<tr>");
for (d = 0; d < 7; d++) {
var cls = calUtil.ifHasSigned(signList, myMonth[w][d]) ? " class='on'" : "";
htmls.push("<td" + cls + ">" + (!isNaN(myMonth[w][d]) ? myMonth[w][d] : " ") + "</td>");
}
htmls.push("</tr>");
}
htmls.push("</table></div></div>");
return htmls.join('');
}
};
樣式部分主要負責日曆表格、簽到按鈕與已簽到日期的背景圖。已簽到的格子會套用 .on 類別,顯示對話框式的打勾背景。
.singer_r_img{display:block;width:114px;height:52px;line-height:45px;
background:url(images/sing_week.gif) right 2px no-repeat;cursor:pointer;}
.singer_r_img.current{background:url(images/sing_sing.gif) no-repeat 0 2px;}
.sign table{border-collapse:collapse;border-spacing:0;width:100%;}
.sign th,.sign td{width:30px;height:40px;text-align:center;line-height:40px;
border:1px solid #e3e3e3;}
.sign .on{background:url(images/sign_have.gif) no-repeat center;}
.calendar_month_span{display:inline;line-height:40px;font-size:16px;color:#656565;
letter-spacing:2px;font-weight:bold;}
.sign_main{width:400px;border-top:1px solid #e3e3e3;
font-family:"Microsoft YaHei",SimHei;display:none;}
頁面載入 jQuery、日曆腳本與彈窗元件,按下簽到按鈕後以 Ajax 呼叫後端 /sign/doSign。若今天已簽到則提示,否則顯示簽到成功,並以彈窗畫出當月日曆標記。
<script type="text/javascript">
var ctx = "${pageContext.request.contextPath}";
function week(){
var objDate = new Date();
var week = objDate.getDay();
week = ["周日","周一","周二","周三","周四","周五","周六"][week];
$("#sing_for_number").html(week);
}
$(function(){
week();
var current = new Date();
$(".singer_r_img").click(function(){
var s = this;
showLoading("正在簽到...");
$.ajax({
url: ctx + "/sign/doSign",
type: "POST",
dataType: "json",
success: function(data){
loadingComplete();
var draw = function(){
$(s).addClass("current");
var str = calUtil.drawCal(current.getFullYear(), current.getMonth()+1, data.signList);
$(str).layerModel({title:"簽到日曆"});
};
if (data.result == 1) { showError("今天您已經簽到,無須再次簽到!", draw); }
else { showSuccess("簽到成功!", draw); }
}
});
});
});
</script>
後端 SignController 負責判斷今天是否已簽到,若未簽到則寫入簽到紀錄(時間、日期、IP、簽到者),最後回傳結果與簽到清單:
@Controller
@RequestMapping("/sign")
public class SignController extends BaseController {
@Autowired private SignService signService;
@RequestMapping("/doSign")
public ModelAndView doSign(HttpServletRequest request, HttpServletResponse response) {
ModelAndView view = super.createJsonView();
try {
boolean ifHasSigned = signService.ifHasSigned();
if (ifHasSigned) {
view.addObject("result", "1");
} else {
SignEntity signEntity = new SignEntity();
Date signDate = new Date();
signEntity.setSignTime(signDate);
signEntity.setSignDay(Long.valueOf(signDate.getDate()));
signEntity.setSignIp(RequestUtil.getIpAddr(request));
signEntity.setSigner("zhoukun");
signService.signTX(signEntity);
view.addObject("result", "0");
}
view.addObject("signList", signService.listSign());
} catch (Exception e) { e.printStackTrace(); }
return view;
}
}
完成後,使用者點擊簽到鈕即可看到當月日曆,並以底色標示出自己已簽到的日期,形成清楚的簽到紀錄視覺回饋。
