ASP.NET AJAX(UpdatePanel)執行部分頁面回發後,$(document).ready() **不會再次觸發**,導致 jQuery 綁定事件、UI 初始化失效。本文解釋根本原因,並提供標準解決方案:掛載 PageRequestManager.endRequest 事件重新執行初始化邏輯。
$(document).ready() 只在**文檔首次載入完成**觸發一次。<script type="text/javascript">
// 1. 取得 PageRequestManager 實例
var prm = Sys.WebForms.PageRequestManager.getInstance();
// 2. 註冊 endRequest 事件處理器
prm.add_endRequest(EndRequestHandler);
// 3. 封裝初始化邏輯為可重複呼叫的函數
function PageInit() {
// 在這裡放置原本在 ready() 內的所有代碼
$('.datepicker').datepicker();
$('.tooltip').tooltip();
$('#btnSubmit').off('click').on('click', handleSubmit);
// ...
}
// 4. endRequest 觸發時重新初始化
function EndRequestHandler(sender, args) {
if (args.get_error() === undefined) { // 無錯誤時才初始化
PageInit();
}
}
// 5. 頁面首次載入也要執行一次
PageInit();
</script>
<head> 中 → ScriptManager 尚未渲染,Sys 未定義。<body> 結尾(</body> 前),確保 ScriptManager 已初始化完成。function EndRequestHandler(sender, args) {
if (args.get_error()) return;
var updatedPanels = args.get_panelsUpdated();
updatedPanels.forEach(function(panel) {
var $panel = $('#' + panel.id);
// 僅在更新區域內重新初始化
$panel.find('.datepicker').datepicker();
$panel.find('.select2').select2();
});
}
| 問題 | 原因 | 解決 |
|---|---|---|
| 事件重複綁定 | 每次 endRequest 都 .on() 疊加 | 先 .off() 再 .on(),或用事件委派 $(document).on('click', '.selector', fn) |
| 外掛重複初始化報錯 | 如 datepicker、select2 不支援重複初始化 | 先 .destroy() 或檢查 .hasClass('hasDatepicker') |
| ScriptManager 未找到 | 腳本放在 Head 或 MasterPage 錯誤位置 | 移至 Body 結尾,或用 ScriptManager.RegisterStartupScript 從後端註冊 |
endRequest 重新初始化是標準修補方案。ASP.NET AJAX 部分回發破壞了 jQuery ready() 單次執行假設。掛載 PageRequestManager.endRequest 並在其中重新執行 PageInit(),是 WebForm + UpdatePanel + jQuery 共存的**標準修正模式**。記住:腳本放 Body 尾、初始化邏輯冪等化、善用事件委派避免重複綁定。