在 ASP.NET 中撰寫 JavaScript 時,常會遇到「明明 ID 寫對了卻抓不到 DOM 元素」的狀況。這是因為伺服器控制項在瀏覽器端產生的實際 id,往往與你在 .aspx 中設定的 ID 不同。本文說明如何正確取得。
ASP.NET 的伺服器控制項在渲染成 HTML 時,為了避免命名衝突,會依命名容器自動加上前綴,導致客戶端實際的 id 與伺服器端設定的 ID 不一致,因此直接用 document.getElementById 抓不到。
透過伺服器控制項的 ClientID 屬性,可以取得它在瀏覽器端對應的 HTML id:
<%= newsId.ClientID %>
var newsId = $("#<%= newsId.ClientID %>");
取得元素後,就能對它進行各種 DOM 操作,例如設定值、綁定事件、切換樣式等。
如果嫌 ClientID 的動態前綴難以掌控,也可以為控制項設定 ClientIDMode="Static",讓它輸出固定的 id,如此一來前端就能直接用設定的 ID 抓取元素,不必每次都透過 ClientID。這是 ASP.NET 4.0 以後提供的便利特性,能大幅簡化前中端的協作。