專案做完、進入測試驗收階段,使用者突然提出「查詢結果希望能直接修改,方便列印」。這種需求若改後端就要動到每一頁,成本很高。與其如此,不如在前端做文章——只要在共用的 JS 檔裡加幾個函式,所有列表就都能編輯了。
/*
頁面裝載時,為每個 td 增加單擊事件,這樣就可以不用對每個頁面進行更改。
*/
function ReWritable()
{
var tbmian=document.getElementById("tbmain");
for(var i=0;i<tbmain.rows.length;i++)
{
for(var j=0;j<tbmain.rows[i].cells.length;j++)
{
/*
添加單擊事件屬性。此處不可使用 setAttribute 方法。
*/
tbmain.rows[i].cells[j].onclick=AddObjOfText;
}
}
}
/*
單擊事件,將 Td 內容更新為一個 Div,其中裝載了一個 Text,用於用戶輸入新的 Td 的值,
一個確定按鈕,一個取消按鈕,用於儲存或取消用戶的輸入內容。
一個 Hidden,儲存用戶輸入新值前的 Td 的值,以便用戶取消時恢復。
*/
function AddObjOfText()
{
var tdcag=document.getElementById("tdcag");
if(tdcag!=null)
{
return;
}
var tdid=window.event.srcElement;
var tdtxt=tdid.innerText;
var str="<div id='tdcag'><input type='text' id='txtId' value='"+tdtxt+"'>";
str+="<input type='button' value='確定' onclick='ChangeTdText()'>";
str+="<input type='button' value='取消' onclick='CancelTdChanged()'>";
str+="<input type='hidden' id='tdInitValue' value='"+tdtxt+"'>";
str+="</div>";
tdid.innerHTML=str;
}
/*
取消更改,把 Hidden 值賦給 Td
*/
function CancelTdChanged()
{
var tdInitValue=document.getElementById("tdInitValue");
var tdtxt=tdInitValue.value;
var tdid=document.getElementById("tdcag").parentNode;
tdid.innerText=tdtxt;
}
/*
儲存用戶更改,把 Text 值賦值給 Td
*/
function ChangeTdText()
{
var txtId=document.getElementById("txtId");
var tdid=document.getElementById("tdcag").parentNode;
tdid.innerText=txtId.value;
}
在 body 加上 onload 事件,呼叫 ReWritable():
<body onload="ReWritable();"> <table id="tbmain" style="width:100%;" border="1"> <tr> <td>11 </td> <td>12 </td> <td>13 </td> </tr> <tr> <td>21 </td> <td>22 </td> <td>23 </td> </tr> <tr> <td>31 </td> <td>32 </td> <td>33 </td> </tr> </table> </body>
這樣每個 Td 就都掛上單擊事件了。
為什麼不能用 setAttribute。註解裡特別標了這一點。在 IE 中,用 setAttribute('onclick', ...) 設定的行為並不可靠,直接指派 element.onclick = fn 才是跨瀏覽器一致的寫法。
用一個隱藏 input 存原值。按下確定就直接把文字框的值寫回 td,按下取消則從 tdInitValue 取回原值。這比在 JavaScript 變數中維護一份狀態表簡單,因為狀態就存在 DOM 裡,跟著被編輯的元素一起存在。
用 tdcag 是否存在來防止重複編輯。同一時間只允許一個格子進入編輯狀態,這個哨戒機制避免多個編輯框同時存在互相干擾。
這個實作思路清晰,但以現代標準來看有幾處必須修正:
第一,window.event.srcElement 是 IE 專屬寫法,標準做法應是從事件參數取得 event.target。若直接沿用這段程式碼,在非 IE 瀏覽器中會完全失效。
第二,以字串拼接 innerHTML 有 XSS 風險。td 中的文字若含有單引號或角括號,就會破壞產生的 HTML 結構,甚至被注入程式碼。正確做法是用 document.createElement 建立元素,再以 value 屬性賦值。
第三,用 innerText 取值會把原本的 HTML 結構吃掉,且該屬性非標準。建議改用 textContent。
第四,用 id 當全域哨戒,多個表格並存時會衝突。若頁面有兩個 table,兩邊的編輯框 id 都是 tdcag,就會互相干擾。
最後,最重要的觀念問題:前端修改並不會真的存進資料庫。這個做法只能暫時改畫面上的顯示,重新整理後一切都會恢復原狀。若使用者的需求是「修改後要能列印」,這就够了;若是「修改後要保存」,就必須搭配 Ajax 把每個格子的新值送回伺服器。驗收時最好先跟使用者確認清楚是哪一種,否則做完才發現方向錯誤,返工成本更高。