本文詳細記錄了一個容易讓人誤入歧途的問題:當 JavaScript 的函數名稱與 form 表單元素的 id 相同時,會觸發難以察覺的錯誤。有類似困惑的朋友不妨參考一下。
事情始於一次 Excel 匯出功能。當時我用了 form 表單裡的 hidden 隱藏輸入框來區分「匯出」與「搜尋」兩種行為,並且讓 onClick 事件觸發的函數名稱與該 hidden 元素的 id 保持一致。結果頁面直接拋出錯誤:調用函數的那一行提示「對象不支持此屬性」。
我反覆檢查了很久,起初一直以為是某個字母拼錯,直到發現 JS 函數根本沒有被執行。無奈之下我改調另一個函數,這才恢復正常,於是把矛頭指向了函數名稱。改名之後確實好了,可一旦我把 input 的 id 又改回與函數同名,錯誤便再次出現。此時我甚至懷疑是 ThinkPHP 模板解析的 bug,直到寫了一個最小示例反覆驗證,才確認結論:JavaScript 中的函數名稱不能與元素的 id 相同。
示例代碼如下:
<html> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> <title>ceshi</title> <script> function a() { document.getElementById('a').value="test"; alert(document.getElementById('a').value); return false; } </script> </head> <body> <form> <input type="hidden" id="a" name="a" value="" /> <input type="button" value="excel" onClick="javascript:a();"/> </form> </body> </html>頁面返回的錯誤訊息如下:
用戶代理: Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 5.1; Trident/4.0; CIBA; .NET CLR 2.0.50727)
消息: 對象不支持此屬性或方法
行: 17
字符: 1
代碼: 0
根本原因是:當函數名與元素 id 同名時,瀏覽器在解析時會優先把該名稱綁定到 DOM 元素上,導致原本期望調用的函數被元素對象覆蓋,於是「函數調用」實際變成了「對元素執行函數操作」,自然報錯。養成良好習慣,避免函數名與元素 id 撞名,就能規避這類隱形陷阱。