DIV CSS 佈局教程網

Bootstrap 智能表單實戰:渲染後的插件初始化處理
編輯:關於JavaScript     

動態生成的表單有個共同難題:那些在 DOMContentLoaded 時初始化的插件,會因為元素當時還不存在而失效。日期選擇器、下拉美化、驗證提示都屬於這一類。處理方式是把插件初始化搬到表單渲染完成之後。

核心做法

在 Render() 的回呼函數中進行所有「渲染後才能做」的初始化。以日期插件為例:

$("input.date-picker").datepicker({
  format: 'yyyy-MM-dd',
  autoclose: true
}).next("span.input-group-btn").bind("click", function () {
  $(this).prev(".date-picker").datepicker("show");
});

這段做了兩件事:把日期插件掛到所有 date-picker 類的輸入框上,並為其後方作為圖示的 input-group-btn 綁定點擊事件,讓使用者點圖示也能彈出日曆。autoclose: true 則是選完日期自動關閉面板,少了它多數使用者會抱怨還要再點一次別的地方。

此範例依賴 bootstrap-datepicker 插件,範例專案中並未引入,因此僅作示意。

為什麼時序這麼關鍵

典型的錯誤寫法是把插件初始化放在文件頂層:

$(function () {
  // 錯誤:此時表單尚未渲染,選擇器抓不到任何元素
  $("input.date-picker").datepicker({ format: 'yyyy-MM-dd' });

  var bsForm = new BSForm({ eles: eles }).Render('formContainer');
});

jQuery 的選擇器找不到元素時不會報錯,只會回傳空集合,後續的 datepicker() 也就靜默地什麼都沒做。這類「沒有錯誤訊息但功能不存在」的問題,在動態渲染場景中特別常見。

正確順序:

$(function () {
  var bsForm = new BSForm({ eles: eles, hides: hides })
    .Render('formContainer', function (bf) {
      // 表單 DOM 已就緒,這裡初始化所有插件
      $("input.date-picker").datepicker({ format: 'yyyy-MM-dd', autoclose: true });
      bf.InitFormData(model);
    });
});

把初始化收斂成一個函數

插件一多,回呼裡會變得很長。更好的做法是集中到一個初始化函數,讓回呼保持簡潔:

function initPlugins(container) {
  var $scope = $(container);

  // 日期
  $scope.find('input.date-picker').datepicker({ format: 'yyyy-MM-dd', autoclose: true });

  // 下拉美化
  $scope.find('select.selectpicker').selectpicker('refresh');

  // 檔案上傳
  $scope.find('input[type="file"]').each(function () { /* 掛上傳插件 */ });

  // 驗證
  $scope.validate({ /* rules */ });
}

傳入 container 做範圍限制有兩個好處:效能更好(不必搜尋整個文件),以及同一頁有多個表單時不會互相干擾。

一個容易忽略的細節

若表單內容會動態增減(例如「新增一列」按鈕),新加入的元素不會自動套上插件。此時有兩種策略:

一、事件委派。把事件綁在容器上而非元素上,新元素自動生效:

$(document).on('click', '.date-picker', function () {
  $(this).datepicker('show');
});

二、新增後重新初始化。在插入新列的程式碼後呼叫一次針對該列的初始化:

var $row = buildRow(index);
$('#tableBody').append($row);
initPlugins($row);   // 只初始化新列,範圍最小

策略二通常更可靠,因為多數插件(尤其需要建立複雜 DOM 結構的日期、下拉美化類)無法純靠事件委派運作。判斷標準很簡單:插件只是綁事件 → 委派即可;插件會改寫 DOM → 必須對新元素重新呼叫初始化。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved