現象:頁面初始載入時 jQuery 效果正常(如下拉菜單、Tab 切換、驗證提示),點擊 UpdatePanel 內按鈕觸發部分回發後,原有 jQuery 綁定的事件/效果全部失效。
$(document).ready() 中綁定事件/初始化插件ASP.NET AJAX 提供 Sys.WebForms.PageRequestManager 客戶端生命週期事件,endRequest 在每次部分回發完成後觸發。
<script type="text/javascript">
// 1. 提取初始化邏輯為獨立函數
function initJQueryPlugins() {
// 這裡放置所有原本在 $(document).ready() 中的代碼
$("select.chosen").chosen();
$(".datepicker").datepicker();
$(".tooltip").tooltip();
$("#tabs").tabs();
// ... 其他插件初始化、事件綁定
}
// 2. 頁面首次載入執行
$(document).ready(function() {
initJQueryPlugins();
// 3. 註冊 EndRequest 監聽器
var prm = Sys.WebForms.PageRequestManager.getInstance();
prm.add_endRequest(function(sender, args) {
// 部分回發完成後,重新初始化
initJQueryPlugins();
});
// 可選:處理回發錯誤
prm.add_endRequest(function(sender, args) {
if (args.get_error()) {
console.error("Partial postback error:", args.get_error().message);
args.set_errorHandled(true); // 阻止預設錯誤彈窗
}
});
});
</script>
若 UpdatePanel 範圍較小,全量重跑初始化可能影響性能或產生副作用。可針對性處理:
prm.add_endRequest(function(sender, args) {
// 獲取本次更新的 UpdatePanel ClientIDs
var updatedPanels = args.get_panelsUpdated();
updatedPanels.forEach(function(panelId) {
var $panel = $("#" + panelId);
if ($panel.length) {
// 僅在更新區域內重新初始化
$panel.find("select.chosen").chosen({width: "100%"});
$panel.find(".datepicker").datepicker();
// 事件委託綁定 (推薦) - 無需重綁
// $panel.on("click", ".dynamic-btn", handler);
}
});
});
| 策略 | 適用場景 | 優點 | 缺點 |
|---|---|---|---|
全量重綁 initJQueryPlugins() |
簡單頁面、插件少、UpdatePanel 少 | 代碼簡單、一次性解決 | 性能開銷大、可能重複綁定導致 Bug |
針對性重綁 $panel.find(...) |
複雜頁面、多 UpdatePanel、性能敏感 | 精準、高效、可控 | 需維護選擇器映射、代碼較多 |
事件委託 $(document).on('click', '.selector', fn) |
動態新增元素、列表操作、按鈕點擊 | 一次綁定、永久生效、無需重綁 | 不適用於需初始化的插件 (datepicker 等) |
插件銷毀重建 .destroy() → .init() |
複雜插件 (DataTables, Select2, Chosen 等) | 狀態乾淨、避免殘留 | 需插件支援 destroy 方法 |
新項目建議避開 UpdatePanel + jQuery 混用模式:
PageLifecycleManager 模塊,集中管理 init/destroy/reinit,配合 Source Map 調試