「點擊地圖上的標記,右側顯示該店家資訊」——這個互動看似簡單,卻同時考驗後端資料存取與前端非同步渲染。以下用寵物醫院為題材,走完整個流程。
後端以 Node.js 加 Express 提供兩支 API:一支回傳所有門店及其座標,另一支依 ID 回傳單一門店詳情。前端用原生 XHR 取得 JSON,再動態組出標記與資訊卡。
CREATE DATABASE pet;
CREATE TABLE petmap (
pmId INT AUTO_INCREMENT PRIMARY KEY,
pmName NVARCHAR(60), /* 店名 */
pmCity NVARCHAR(20), /* 所在城市 */
pmAddress NVARCHAR(100), /* 詳細地址 */
pmImg VARCHAR(60), /* 圖片檔名 */
pmPhone VARCHAR(30), /* 電話 */
pmTop FLOAT, /* 標記的 top 座標 */
pmLeft FLOAT /* 標記的 left 座標 */
);
INSERT INTO petmap (pmName, pmCity, pmAddress, pmImg, pmPhone, pmTop, pmLeft) VALUES
('邛崃邛臨美多寵物服務部', '成都', '成都市邛崃市長松路296號', 'map1.png', '15202891690', 360, 320),
('諧和寵物醫院', '德陽', '德陽市旌陽區珠江西路300號', 'map2.png', '0838-6181255', 320, 350),
('天寧動物醫院', '西安', '西安市新城區韓森路', 'map3.png', '028-81836050', 260, 240),
('寵美康動物醫院', '烏魯木齊', '烏魯木齊市天山區幸福路774號', 'map4.png', '0991-2654158', 210, 170),
('綿陽康貝動物診所', '綿陽', '綿陽市游仙區東津路5-2號', 'map5.png', '0816-2987186', 315, 335),
('聖心動物醫院', '重慶', '重慶市九龍坡區大公館九龍大廈3-2', 'map6.png', '023-68820999', 360, 380);
var express = require("express");
var mysql = require("mysql");
var app = express();
app.use(express.static(__dirname + "/public"));
// 回傳全部门店與座標
app.get("/adress.do", function (req, res) {
var conn = mysql.createConnection({
host: "localhost", port: "3306",
user: "root", password: process.env.DB_PASSWORD,
database: "pet"
});
conn.connect();
conn.query("SELECT * FROM petmap", [], function (err, data) {
res.json(data);
});
conn.end();
});
// 依 ID 回傳單一門店
app.get("/adressMsg.do", function (req, res) {
var pmId = parseInt(req.query.pmId, 10);
if (isNaN(pmId)) { return res.status(400).json({ error: "invalid id" }); }
var conn = mysql.createConnection({
host: "localhost", port: "3306",
user: "root", password: process.env.DB_PASSWORD,
database: "pet"
});
conn.connect();
conn.query("SELECT * FROM petmap WHERE pmId = ?", [pmId], function (err, data) {
res.json(data);
});
conn.end();
});
app.listen(8888, function () {
console.log("express 監聽成功!");
});
這裡有兩處比原始寫法更值得採用:其一,資料庫連線資訊改由環境變數提供,避免帳號密碼寫死在原始碼中;其二,查詢使用預存參數(? 佔位符),徹底杜絕 SQL 注入——字串拼接 SQL 是 web 攻擊最常見的入口之一。
<style type="text/css">
.content_map { width: 1349px; height: 524px; float: left; margin-top: 100px; }
#maplist {
margin-top: 50px; width: 749px; height: 524px;
background: url("images/diru.png") no-repeat 0 0;
background-size: contain;
position: relative; float: left;
}
.mapShop img { position: absolute; }
#map_right {
float: left; width: 594px; height: 524px;
background-color: #f0f2fe; margin-top: 40px;
}
.shopMsg img { width: 450px; height: 300px; margin-left: 72px; margin-top: 40px; }
.shopMsg .pmname, .shopMsg .address, .shopMsg .phone {
color: #000; font-size: 20px; margin: 30px 0 0 72px;
}
</style>
<div class="content_map">
<div id="maplist"></div>
<div id="map_right">
<div class="shopMsg">
<img src="images/w_map.png" alt="">
<div class="pmname">寵物店名:Petjoy 寵物社區</div>
<div class="address">地址:長寧區機旋路1258號</div>
<div class="phone">電話:(021)53018000</div>
</div>
</div>
</div>
window.onload = function () { getMap(); };
function getMap() {
var httpReq;
if (window.XMLHttpRequest) {
httpReq = new XMLHttpRequest();
} else {
httpReq = new ActiveXObject("Microsoft.XMLHTTP");
}
var maplist = document.getElementById("maplist");
maplist.innerHTML = ''; // 清空初始佔位內容
httpReq.onreadystatechange = function () {
if (httpReq.readyState == 4 && httpReq.status == 200) {
var list = JSON.parse(httpReq.responseText);
for (var i = 0; i < list.length; i++) {
maplist.innerHTML +=
'<div class="mapShop">' +
'<img src="images/fi1.png" alt="" style="top:' + list[i].pmTop + 'px;left:' + list[i].pmLeft + 'px" />' +
'<div class="marker" data-id="' + list[i].pmId + '" ' +
'style="top:' + list[i].pmTop + 'px;left:' + list[i].pmLeft + 'px;' +
'position:absolute;padding-top:20px;cursor:pointer"' +
'onclick="getMessage(' + list[i].pmId + ')">' +
list[i].pmCity +
'</div>' +
'</div>';
}
}
};
httpReq.open("get", "adress.do", true);
httpReq.send(null);
}
function getMessage(a) {
var httpReq;
if (window.XMLHttpRequest) {
httpReq = new XMLHttpRequest();
} else {
httpReq = new ActiveXObject("Microsoft.XMLHTTP");
}
var panel = document.getElementById("map_right");
panel.innerHTML = '';
httpReq.onreadystatechange = function () {
if (httpReq.readyState == 4 && httpReq.status == 200) {
var list = JSON.parse(httpReq.responseText);
for (var i = 0; i < list.length; i++) {
var d = list[i];
panel.innerHTML +=
'<div class="shopMsg">' +
'<img src="images/' + d.pmImg + '" alt="' + d.pmName + '">' +
'<div class="pmname">寵物店名:' + d.pmName + '</div>' +
'<div class="address">地址:' + d.pmAddress + '</div>' +
'<div class="phone">電話號碼:' + d.pmPhone + '</div>' +
'</div>';
}
}
};
httpReq.open("get", "adressMsg.do?pmId=" + a, true);
httpReq.send(null);
}

一、別再用 innerHTML 組 HTML。把資料庫字串直接串進 innerHTML,只要有一筆店名含角括號就會破壞結構,也可能形成 XSS。改用 document.createElement 搭配 .textContent 與 .style,或用前端模板並開啟自動跳脫,是更安全的做法。
二、用事件委派取代 inline onclick。把 onclick="getMessage(n)" 寫進 HTML 字串,既不嚴謹也不便維護。改為在容器上綁一次事件,從被點元素的 dataset.id 讀取識別即可。
三、每次請求都新建連線並非必要。這個範例為了清楚,每次請求都建立並關閉連線;正式環境應改用連線池(mysql.createPool),並為 pmId 加上索引。
這個實例的價值在於把三件事串起來:資料庫提供結構化資料、後端把它轉為 JSON、前端用非同步請求渲染成互動介面。學會這條鏈路,替換成任何「清單加詳情」的場景都能沿用。