DIV CSS 佈局教程網

jQuery 插件實作:定時輪詢待處理任務數量
編輯:JQuery特效代碼     

很多系統需要在頁面上掛一個提醒:「您有 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 判斷,切到別的分頁時跳過輪詢,省下不必要的請求。
  • 避免 XSS:把後端數字塞進 html() 時,若文字模板固定其實無妨;但若訊息可能含使用者內容,請改用 text()。
  • 登出後停止:使用者登出應清除計時器,否則會持續發出無效請求。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved