從 1.6 版升級到 DataTables 1.7

與 DataTables 1.x 系列的其他版本一樣,1.7 版的重點是以前版本為基礎進行建構,且不破壞向下相容性。儘管如此,仍然有一些差異必須考慮。

常見的升級問題

  • 正規表示式篩選
    • bEscapeRegex 現在已被 bRegex 取代,其基本含義相同,但它是 bEscapeRegex 的布林 NOT。當 bRegex 為 true 時,篩選字串會被 DataTables 視為正規表示式;當它為 false 時,字串會被視為字面值,而不是模式。任何 bEscapeRegex 的實例都必須更新。這樣做的目的是在更廣泛的整理過程中,提供更易於理解的篩選 API。
  • 刪除列
    • 由於刪除列的內部處理方式變更,fnDeleteRow 無法再將 aoData(DataTables 用於儲存列資訊的內部物件)中的目標設為 'null'。因此,傳遞給 fnDeleteRow 的第三個參數已替換為布林指示器,用於指示是否應該重新繪製表格(與許多其他 API 函數一樣)。

外掛程式和 API 開發人員的變更

  • aoData
    • 在 aoData 陣列中,將條目設為 null 是無效的。這可能只會在使用 fnDeleteRow 刪除列時發生,但任何存取 aoData 的程式碼都必須處理 null 值。現在情況不再是這樣。

測試版期間的變更

  • bDestroy
    • 在 beta 5(含)之前的版本中,此參數的名稱錯誤地為 bDestory。已在 beta 6 中更正。

絕大多數 DataTables 使用者不會受到這些變更的影響,因此如果您尚未積極使用這些功能,DataTables 1.7 將是您的直接替代品。