DIV CSS 佈局教程網

用 JS 判斷客服 QQ 在線狀態並動態切換圖標
編輯:關於JavaScript     

網站懸浮客服欄通常需要根據客服是否在線顯示不同圖標。早期大家用 QQ 官方提供的在線狀態代碼,後來發現它經常顯示不準。這裡介紹一種自己動手判斷的做法。

實現原理

騰訊提供了一個在線狀態查詢接口,以 script 標籤形式引入後,會在頁面裡生成一個名為 online 的數組,數組每項對應一個查詢的 QQ 號:0 表示離線,非 0 表示在線。拿到這個數組,就能逐個替換對應客服的頭像圖。

基礎結構

<script src="JS/jquery-1.5.1.min.js"></script>

<div class="kfli" onclick="openQQ('111111')"><img src="/onlinekf/online.gif" border="0" /> 客服一</div>
<div class="kfli" onclick="openQQ('222222')"><img src="/onlinekf/online.gif" border="0" /> 客服二</div>
<div class="kfli" onclick="openQQ('333333')"><img src="/onlinekf/online.gif" border="0" /> 客服三</div>

<script>
  var online = new Array();
</script>
<script type="text/javascript" src="https://webpresence.qq.com/getonline?Type=1&111111:222222:333333:"></script>
<script type="text/javascript">
  for (var i = 0; i < online.length; i++) {
    if (online[i] == 0) {
      $(".kfli img").eq(i).attr("src", "/onlinekf/offline.gif");
    } else {
      $(".kfli img").eq(i).attr("src", "/onlinekf/online.gif");
    }
  }
</script>

關鍵在於接口 URL 的格式:QQ 號之間用冒號分隔,末尾也帶一個冒號;返回的 online 數組順序與 URL 中 QQ 號的順序嚴格對應,因此可以用同一個下標 i 去定位 DOM 中的第 i 個客服。

加上懸浮窗與伸縮交互

<script src="JS/jquery-1.5.1.min.js"></script>

<style>
  #divMenu {position:fixed;top:220px;right:0px;_position:absolute; _top: expression(eval(document.documentElement.scrollTop)+220)+"px"; cursor:pointer; display:none}
  #rightad {position:fixed;top:190px;right:7px;width:95px;height:180px;_position:absolute; font-size:12px;}
  #scrollto {position:fixed;bottom:100px; width:30px;right:0px;background:#368bcc;color:#FFF;cursor:pointer; text-align:center;_position:absolute; display:none}
  .kfli {height:30px; line-height:30px; color:#FFF; text-align:center;cursor:pointer; border-bottom:1px solid #fff}
  #leftad span,#rightad span{cursor:pointer;}
</style>

<div id="divMenu"><img src="/onlinekf/onlinerkf.png" class="press" alt="在線咨詢"></div>

<div id="rightad">
  <span style="color:#0f8ed2">關閉</span>
  <div style="height:351px; background:url(/onlinekf/onkf.jpg) #368bcc; background-position:center top; background-repeat:no-repeat;width:91px">
    <div style="height:90px; width:91px">
      <div style="width:91px; height:91px; cursor:pointer"></div>

      <div class="kfli" onclick="openQQ('111111')"><img src="/onlinekf/online.gif" border="0" /> 客服一</div>
      <div class="kfli" onclick="openQQ('222222')"><img src="/onlinekf/online.gif" border="0" /> 客服二</div>
      <div class="kfli" onclick="openQQ('333333')"><img src="/onlinekf/online.gif" border="0" /> 客服三</div>
      <div class="kfli" onclick="openQQ('444444')"><img src="/onlinekf/online.gif" border="0" /> 市場一</div>
      <div class="kfli" onclick="openQQ('555555')"><img src="/onlinekf/online.gif" border="0" /> 市場二</div>
      <div class="kfli" onclick="openQQ('666666')"><img src="/onlinekf/online.gif" border="0" /> 市場三</div>
      <div class="kfli" onclick="openQQ('777777')"><img src="/onlinekf/online.gif" border="0" /> 市場四</div>
      <div class="kfli" onclick="openQQ('888888')"><img src="/onlinekf/online.gif" border="0" /> 市場五</div>
    </div>
  </div>
</div>

<script>
  var online = new Array();
</script>
<script type="text/javascript" src="https://webpresence.qq.com/getonline?Type=1&1844565410:363576965:2193744200:1315797152:1609979008:2690151979:3130711794:2825956442:"></script>
<script type="text/javascript">
  for (var i = 0; i < online.length; i++) {
    if (online[i] == 0) {
      $(".kfli img").eq(i).attr("src", "/onlinekf/offline.gif");
    } else {
      $(".kfli img").eq(i).attr("src", "/onlinekf/online.gif");
    }
  }

  // 關閉浮動窗
  $(document).ready(function () {
    $("#rightad span").click(function () {
      $("#rightad").hide(300);
      $("#divMenu").show(300);
    });

    $("#divMenu").click(function () {
      $("#rightad").slideDown(300);
      $("#divMenu").hide(200);
    });
  });

  window.onscroll = function () {
    if (document.documentElement.scrollTop + document.body.scrollTop > 100) {
      document.getElementById("scrollto").style.display = "block";
    }
    else {
      document.getElementById("scrollto").style.display = "none";
    }
  }

  function OpenSmallWindows(strURL, scrollbar, width, height, left, top) {
    window.open(strURL, "_blank",
      "status=no,resizable=0,toolbar=no,menubar=no,scrollbars=" + scrollbar +
      ",width=" + width + ",height=" + height + ",left=" + left + ",top=" + top + "");
  }

  function openQQ(qq) {
    window.location.href = "tencent://message/?uin=" + qq + "&Site=gbgjs.com&Menu=yes";
  }
</script>

tencent://message/?uin=xxx 是 QQ 的自定義協議,點擊後會喚起本機客戶端並打開對話窗口,這是「點擊客服直接聊天」的實現方式。

實務上的幾點提醒

接口依賴風險。這個方案完全依賴第三方接口的可用性與返回格式,一旦對方調整,頁面上的狀態顯示就全失效,而且前端無法感知失敗。穩妥的做法是通過自己的後端代理這個請求,由後端做緩存與容錯,前端只請求自己的接口。

順序耦合脆弱。用數組下標去對應 DOM 元素,意味著增刪客服時必須同步維護兩處順序。改成把 QQ 號寫在 data-qq 屬性上,然後按屬性查找對應元素,會健壯很多。

協議與業務變化。騰訊已逐步調整其在線狀態服務,QQ 在企業客服場景中的佔比也在下降。新項目接入前建議先驗證接口是否仍然可用,並考慮同時支持企業微信等渠道。

無障碍。狀態目前只靠圖片顏色區分,對色覺障礙用戶不友好,應同時給 img 加上有意義的 alt 文本(如「客服在線」/「客服離線」)。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved