ajax

在最简单的情况下，ajax，当作为字符串给出时，只会简单地从给定的远程文件加载数据。请注意，DataTables 期望表格数据是对象 data 参数中的项目数组（如果您的数据格式不同，请使用 ajax.dataSrc 选项作为对象）。

{
    "data": [
        // row 1 data source,
        // row 2 data source,
        // etc
    ]
}

DataTables 可以通过使用 columns.data 选项，将几乎任何格式的对象或数组用作每行的數據源。默认情况下，使用数组数据源。

简单示例

new DataTable('#myTable', {
  "ajax": "data.json"
} );

从 DataTables 2 开始，此选项可以作为空字符串给出，以指示 DataTables 它是一个 Ajax 源表格，但不要在给出 URL 之前发出 Ajax 请求，这可以通过 ajax.url().load() 来完成。例如，如果您使用 DataTables 来显示通过 Ajax 获取的搜索结果，这将很有用。

作为对象，ajax 对象将传递给 jQuery.ajax，允许您对 Ajax 请求进行精细控制。DataTables 有许多默认参数，您可以使用此选项覆盖它们。有关可用选项的完整描述，请参阅 jQuery 文档，尽管以下参数在 DataTables 中提供其他选项或需要特殊考虑

• data (ajax.data) - 与 jQuery 一样，data 可以作为对象提供，但作为扩展，它也可以作为函数提供，用于操作 DataTables 发送到服务器的数据。该函数接受一个参数，该参数是一个对象，其中参数是 DataTables 已准备发送的名值对。可以返回一个对象，该对象将用作发送到服务器的数据（因此，如果您希望使用 DataTables 设置的参数，您必须将它们合并到您的函数中），或者您可以将项目添加到传递进来的对象中，并且不从函数中返回任何内容。这取代了 DataTables 1.9- 中的 fnServerParams。
• dataSrc (ajax.dataSrc) - 默认情况下，DataTables 将在从 Ajax 源获取数据或进行服务器端处理时查找属性 data（或与 DataTables 1.9- 兼容的 aaData）- 此参数允许更改该属性，通过两种不同的形式
  • 作为字符串 - 定义要从中读取的属性。请注意，如果您的 Ajax 源只是返回要显示的数据数组，而不是对象中的数组，请将此参数设置为一个空字符串。此外，您可以使用 Javascript 点对象表示法来获取多个级别的对象/数组嵌套的数据源。
  • 作为函数 - 作为函数，它接受一个参数，即从服务器返回的 JSON，可以根据需要进行操作。函数返回的值将由 DataTables 用作表格的数据源。
  • 这取代了 DataTables 1.9- 中的 sAjaxDataProp。
• success - 必须不被覆盖，因为它在 DataTables 中用于内部。要操作/转换服务器返回的数据，请使用 ajax.dataSrc（上面），或者使用 ajax 作为函数（下面）。

简单示例

new DataTable('#myTable', {
  "ajax": {
    "url": "data.json",
    "type": "POST"
  }
} );

作为函数，Ajax 调用的执行留给您自己，允许您完全控制 Ajax 请求。实际上，如果需要，可以使用除 Ajax 之外的其他方法来获取所需的数据，例如 Web 存储或 Firebase 数据库。

当数据已从数据源获取时，应使用第二个参数（这里的 callback）调用一个参数 - 用于绘制表格的数据。

简单示例

new DataTable('#myTable', {
  "ajax": function (data, callback, settings) {
    callback(
      JSON.parse( localStorage.getItem('dataTablesData') )
    );
  }
} );

请注意，从 DataTables 1.10.6 开始，xhr 事件将在使用函数作为 ajax 时触发（即使没有 Ajax 请求）。在 1.10.6 之前，不会触发任何事件。