在 ASP.NET Web Forms 裡寫 JavaScript 時,最常見的挫折莫過於:document.getElementById('newsId') 永遠抓不到元素。原因不是 JS 寫錯,而是伺服器控制項在渲染成 HTML 時,id 屬性會被自動加上命名容器的名稱前綴(例如 ctl00_ContentPlaceHolder1_newsId)。
ASP.NET 提供了 ClientID 屬性,正好就是該控制項在瀏覽器端實際生成的 id。用 <%= %> 即可在伺服器端把它輸出到 JS 中:
<%= newsId.ClientID %>
原生 document.getElementById 與 jQuery 都可以,這裡以 jQuery 示範:
var newsId = $("#<%= newsId.ClientID %>");
拿到元素之後,剩下的就是一般的 DOM 操作了:
var $newsId = $("#<%= newsId.ClientID %>");
$newsId.val('新的標題');
$newsId.addClass('highlight');
ClientID 是渲染到 HTML 的 id;UniqueID 則是用 $ 分隔、供伺服器端事件回傳(postback)辨識用的名稱,兩者不可混用。ClientIDMode 設為 Static,此後就能放心寫 $('#newsId')。這在 .NET 4.0 之後才提供。<%= %> 寫進外部 .js 檔:外部檔案不經過 ASP.NET 處理引擎,標籤不會被替換。若一定要分離,可在頁面中宣告變數再由外部腳本讀取:
<script>
window.__config = { newsId: '<%= newsId.ClientID %>' };
</script>
<script src="js/news.js"></script>
#newsId 即可。