很多系統需要在頁面上掛一個提醒:「您有 3 筆審核待處理」。這類數字會隨時間變動,不可能靠後端在頁面輸出時寫死,常見做法是前端定時向後端問一次,再決定要不要顯示。
把容器交給插件即可,容器裡的內容由插件自己產生:
$("#todo_tip").pull_todo_count();
最精簡的 JSON 就夠了:
{"todo_count":3}
(function ($) {
var element;
$.fn.pull_todo_count = function () {
// 先放一個預設佔位連結,並把 href 指向待辦清單
var a = $('<a>0個審核待申請</a>');
a.attr("href", "/process/todo_list");
a.appendTo($(this));
$(this).hide(); // 沒資料前先藏起來,避免閃一下 0
element = $(this);
timerRequestData();
};
function timerRequestData() {
$.ajax({
url: '/pull_todo_count',
type: 'get',
data: null,
dataType: 'json',
success: function (data) {
var count = data["todo_count"];
if (count > 0) {
element.children("a").html(count + "個審核待申請");
element.show();
} else {
element.hide(); // 歸零就整塊隱藏
}
}
});
// 60 秒後再問一次,形成輪詢
setTimeout(timerRequestData, 60000);
}
})(jQuery);
{% if user.is_authenticated %}
<span id="todo_tip" style="display: none;"></span>
{% endif %}
這裡用 setTimeout 而非 setInterval 其實是對的:它會等上一次請求排程完才再排下一次,較不會因為網路變慢而堆疊請求。不過仍有幾處值得補強:
success,一旦請求失敗不會有任何提示,建議補上 error 或改用 .fail()。document.hidden 判斷,切到別的分頁時跳過輪詢,省下不必要的請求。html() 時,若文字模板固定其實無妨;但若訊息可能含使用者內容,請改用 text()。