Web 開發中,若要把「伺服器回傳的 JSON 物件」填進「頁面上現有的 DOM 表單欄位」,傳統做法是逐個欄位手動賦值。當 JSON 物件很大時,這種寫法既冗長又容易漏。本文示範一個遞迴遍歷、自動對號入座的簡便做法。
id 必須與 JSON 物件中的屬性名稱一致。<!doctype html>
<html>
<head>
<title>JSON 物件遍歷綁定示範</title>
<script type="text/javascript">
var obj = {
a: 'a1', b: 'b1',
c: { c1: 'c1' }, // 嵌套物件
d: 1, e: true,
f: new Date("2012/12/24")
};
// 先看看物件裡有什麼:遞迴印出屬性名、值與型別
function showJsonProperty(jsonObj) {
for (var o in jsonObj) {
console.log("屬性名:" + o + ",值:" + jsonObj[o] +
",型別:" + typeof jsonObj[o]);
if (typeof jsonObj[o] === "object") {
showJsonProperty(jsonObj[o]); // 遞迴深入
}
}
}
// 核心:遞迴綁定
function bindJson(jsonObj) {
for (var o in jsonObj) {
var domObj = document.getElementById(o.toString());
if (domObj != undefined) {
domObj.value = jsonObj[o].toString();
}
if (typeof jsonObj[o] === "object") {
bindJson(jsonObj[o]); // 嵌套物件也一併處理
}
}
}
function bindData() { bindJson(obj); }
</script>
<style type="text/css">
input { width:80px; height:18px; margin:0 10px 0 0; border:1px #999 solid; }
input:hover { border:1px #ff0000 solid; }
input[type=button] { background-color:#efefef; height:22px; }
</style>
</head>
<body>
<div>
a: <input id="a" />
b: <input id="b" />
c.c1: <input id="c1" />
d: <input id="d" />
e: <input id="e" />
f: <input id="f" />
<input type="button" value="綁定" id="btnBind" onclick="bindData()" />
</div>
</body>
</html>
關鍵是「屬性名即元素 id」這個約定,加上遞迴處理嵌套結構,於是一支十來行的函式就能取代幾十行手寫賦值。
但這個偷懶法也有明確邊界:
.value 賦值,因此只適合 input、textarea、select。若目標是 div、span,得改用 textContent 或 innerHTML。checked,不是 value。toString() 後放進輸入框,未必是使用者想看的格式,通常要另外格式化。innerHTML 插入伺服器資料時務必先轉義,否則有 XSS 風險。若專案已經在用前端框架,這類綁定正是 Vue 的 v-model、React 的受控元件天生要解決的問題,直接沿用框架機制會比自行拼湊更可靠。