傳統 tooltip 只能顯示寫死在 title 屬性裡的文字。搭配 Ajax,我們可以在滑鼠移過某個項目時才向伺服器索取細節資料,動態產生一個浮動提示層——既省流量,也不必有預先載入全部資料。
本範例以高爾夫球場為題材:左側列出球場名稱,滑鼠移入任一列時向後端請求該球場的標準桿數與長度,並在旁邊彈出提示框。
頁面上有兩個表格:courses 是球場清單,每個 <td> 帶有 id(1~4);另一個 courseData 放在絕對定位的 <div id="popup"> 裡,作為提示內容的容器。
var xmlHttp, dataDiv, dataTable, dataTableBody, offsetEl;
function createXMLHttpRequest() {
if (window.ActiveXObject) {
xmlHttp = new ActiveXObject("Microsoft.XMLHTTP");
} else if (window.XMLHttpRequest) {
xmlHttp = new XMLHttpRequest();
}
}
function initVars() {
dataTableBody = document.getElementById("courseDataBody");
dataTable = document.getElementById("courseData");
dataDiv = document.getElementById("popup");
}
// 滑鼠移入時觸發
function getCourseData(element) {
initVars();
createXMLHttpRequest();
offsetEl = element;
var url = "ToolTipServlet?key=" + escape(element.id);
xmlHttp.open("GET", url, true);
xmlHttp.onreadystatechange = callback;
xmlHttp.send(null);
}
function callback() {
if (xmlHttp.readyState == 4) {
if (xmlHttp.status == 200) {
setData(xmlHttp.responseXML);
}
}
}
function setData(courseData) {
clearData();
setOffsets();
var length = courseData.getElementsByTagName("length")[0].firstChild.data;
var par = courseData.getElementsByTagName("par")[0].firstChild.data;
dataTableBody.appendChild(createRow("Par: " + par));
dataTableBody.appendChild(createRow("Length: " + length));
}
function createRow(data) {
var row = document.createElement("tr");
var cell = document.createElement("td");
cell.setAttribute("bgcolor", "#FFFAFA");
cell.setAttribute("border", "0");
cell.appendChild(document.createTextNode(data));
row.appendChild(cell);
return row;
}
// 依觸發元素的位移決定提示框位置
function setOffsets() {
var end = offsetEl.offsetWidth;
var top = calculateOffsetTop(offsetEl);
dataDiv.style.border = "black 1px solid";
dataDiv.style.left = end + 15 + "px";
dataDiv.style.top = top + "px";
}
function calculateOffsetTop(field) {
return calculateOffset(field, "offsetTop");
}
function calculateOffset(field, attr) {
var offset = 0;
while (field) {
offset += field[attr];
field = field.offsetParent;
}
return offset;
}
function clearData() {
for (var i = dataTableBody.childNodes.length - 1; i >= 0; i--) {
dataTableBody.removeChild(dataTableBody.childNodes[i]);
}
dataDiv.style.border = "none";
}
</script>
值得注意的細節是 calculateOffset():提示框使用 absolute 定位,若只用 offsetTop 會得到相對於上層容器的值,因此必須沿著 offsetParent 鏈逐層累加,才能算出相對於視窗(文件)的正確座標。
Servlet 在 init() 中以 HashMap 預先載入四筆球場資料(par 與 length),doGet 依 key 取出對應物件,輸出成簡單的 XML:
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
Integer key = Integer.valueOf(request.getParameter("key"));
CourseData data = (CourseData) courses.get(key);
response.setContentType("text/xml; charset=UTF-8");
response.setHeader("Cache-Control", "no-cache");
PrintWriter out = response.getWriter();
out.println("<response>");
out.println("<par>" + data.getPar() + "</par>");
out.println("<length>" + data.getLength() + "</length>");
out.println("</response>");
}
CourseData 是 servlet 的內部類別,只包兩個整數欄位與 getter;doPost 直接轉呼 doGet,方便以 POST 測試。
把 setData 中的 DOM 組裝改成 innerHTML 可以少寫幾行,但用 createElement/createTextNode 建立節點較不易產生 XSS 風險,值得保留。此外,回應若可能被快取,記得送出 no-cache 標頭;若資料變動頻繁,也可考慮加上 Cache-Control 的 max-age 以降低請求量。