手冊

DataTables 的既定目標是「增強 HTML 表格中資料的可存取性」。為了實現這一目標,我們認識到 DataTables 有兩類與軟體介面互動的使用者

  • 終端使用者 - 那些使用您使用 DataTables 在瀏覽器中建立的介面的人
  • 開發人員 - 您自己和其他與 DataTables 合作開發您的應用程式、網站、服務等的開發人員。

終端使用者需要能夠盡快從表格中獲取有用的資訊,為此 DataTables 內建了排序、搜尋和分頁等功能。本文件未詳細說明終端使用者如何使用該介面,假設這些控制項是不言自明的(例如,在搜尋輸入框中輸入即可搜尋表格)。

本文件著重於向您(使用 DataTables 的開發人員)提供您需要在應用程式中使用 DataTables 的資訊,自訂它以滿足您的確切需求,讓您的終端使用者受益於 DataTables 可以呈現給他們的功能。因此,本文件涵蓋了從如何在您的網站上首次安裝 DataTables、說明它如何為其建立的表格獲取資料,以及詳細說明如何自訂其終端使用者介面,一直到更進階的主題,例如建立您自己的 DataTables 外掛程式,以進一步增強其功能並與您的應用程式無縫介面。

儘管 DataTables 呈現的終端使用者和開發人員介面當然是完全不同的,但每個介面對 DataTables 達到其確保可以盡快、盡可能有效率地存取和使用 HTML 表格中的資料的目標都具有同等的重要性。

DataTables 手冊

安裝

如何在您的網站上啟動並執行 DataTables。本節詳細說明 DataTables 對您的 HTML 表格的要求,您需要包含哪些檔案才能讓 DataTables 增強您的表格、如何包含這些檔案以及如何執行 DataTables。您將在不到兩分鐘的時間內啟動並執行! 閱讀更多 »

資料

資料很複雜,而且所有資料都不同。因此,DataTables 具有豐富的選項,可用於配置它如何獲取要在表格中顯示的資料,以及如何處理該資料。本手冊的這一部分描述了配置 DataTables 從您的資料來源讀取資料的選項。 閱讀更多 »

Ajax

本手冊的這一部分詳細介紹了如何使用 JSON 資料來源將 Ajax 來源的資料載入到您的 DataTables 中。這主要由兩個任務組成 - JSON 中資料列陣列的位置以及用於每個欄位的資料點。 閱讀更多 »

選項

DataTables 的大量選項可用於自訂它向終端使用者呈現介面及其可用功能的方式。本手冊的這一部分詳細說明了如何執行此配置。可用選項的完整列表顯示在本網站的選項參考部分。 閱讀更多 »

API

DataTables API 提供了大量的選項,用於存取表格中包含的資料,以及以程式設計方式操作表格。這些功能範圍從選取列、欄位和儲存格以取得和設定其資料,到動態變更欄位可見性和將搜尋詞套用到表格。 閱讀更多 »

搜尋

搜尋是 DataTables 的關鍵部分,也是其使資料可存取的目標。因此,它內建了許多搜尋功能,並提供了自訂搜尋的選項以及允許進階和特定案例搜尋操作的 API。本文件將詳細討論如何在 DataTables 中執行搜尋。 閱讀更多 »

樣式

以適合您設計的方式設定 DataTables 增強表格的樣式非常重要,以便表格與您網站/應用程式的其餘部分無縫整合。為此,DataTables 提供了許多用於設定表格樣式的選項,包括其自己的可自訂 CSS、與 CSS 框架 Bootstrap 和 Foundation 的整合以及預先建立的主題。 閱讀更多 »

事件

了解 DataTables 何時執行操作通常在複雜且動態的網路應用程式中發揮重要作用。因此,DataTables 將觸發自訂 DOM 事件,可以使用 jQuery 的 on() 方法和 dt 名稱空間來監聽這些事件。 閱讀更多 »

伺服器端處理

伺服器端處理允許 DataTables 直接利用資料庫引擎的功能和強大功能,讓它們執行排序、搜尋和分頁資料的繁重工作。這是透過為 DataTables 顯示的每個頁面發出 Ajax 呼叫來完成的,適用於非常大的資料集。 閱讀更多 »

國際化

DataTables 在增強表格時會向文件新增多個控制項,其中許多控制項以某種方式利用語言字串將用法傳達給終端使用者。這些預設字串是英文的,但可以輕鬆翻譯成其他語言,或自訂字串。社群提供了 50 多種翻譯版本,可供使用。 閱讀更多 »

安全性

安全性是網路開發中的一個基本主題,也是任何開發人員(從實習生到技術長)都不應忽視的主題。高調的駭客攻擊案例經常成為世界各地的新聞頭條,但經過一些仔細的思考和規劃,您可以快速建立安全的應用程式。此頁面討論與 DataTables 直接相關的網路安全攻擊,以及您可以如何應對這些攻擊的方法。 閱讀更多 »

React

React 是一個廣泛用於建立反應式網路應用程式的 Javascript 函式庫。我們發佈了 datatables.net-react 套件,該套件提供 DataTables 用於 React 應用程式中的元件。 閱讀更多 »

Vue

Vue.js 是一個廣泛用於建立反應式網路應用程式的前端 Javascript 框架。我們發佈了 datatables.net-vue3 套件,該套件提供 DataTables 用於 Vue3 應用程式中的元件。 閱讀更多 »

外掛程式開發

儘管 DataTables 非常靈活,但有時您可能希望根據您的特定需求自訂某些方面。DataTables 具有許多外掛程式和擴充選項,本節將詳細介紹這些選項。 閱讀更多 »

技術說明

技術說明包含有關 DataTables 的資訊,這些資訊不太適合文件其餘部分的流程,說明錯誤訊息、有關 DataTables 實施的技術決策以及使用 DataTables 時其他一般感興趣的主題的詳細說明。 閱讀更多 »

開發

作為開放原始碼軟體,您可以免費研究 DataTables 的原始碼,並且我非常鼓勵您這樣做,並將您所做的任何變更貢獻回專案,以便其他人也能受益。本手冊的這一部分描述了如何從原始碼建立 DataTables、貢獻程式碼以及 DataTables 的計劃路線圖。 閱讀更多 »