layui/docs/table/detail/options.ajax.md

<table class="layui-table">
  <colgroup>
    <col width="150">
    <col>
  </colgroup>
  <thead>
    <tr>
      <th>属性名</th>
      <th>描述</th>
    </tr> 
  </thead>
  <tbody>
    <tr>
<td>url</td>
<td>

发送异步请求的 URL。默认会自动传递两个参数：`?page=1&limit=30`（该参数可通过 `request` 属性自定义）
<br>`page` 代表当前页码、`limit` 代表每页数据条数。

</td>
    </tr>
    <tr>
<td>method</td>
<td>

请求的方式，默认：`get`

</td>
    </tr>
    <tr>
<td>where</td>
<td>

请求的其他参数。如：`where: {token: 'sasasas', id: 123}`

</td>
    </tr>
    <tr>
<td>headers</td>
<td>

请求的数据头参数。如：`headers: {token: 'sasasas'}`

</td>
    </tr>
    <tr>
<td>contentType</td>
<td>

请求的内容编码类型。若要发送 `json` 内容，可设置：<br>
`contentType: 'application/json'`

</td>
    </tr>
    <tr>
<td>dataType <sup>2.7+</sup></td>
<td>

请求的数据类型，默认 `json`。

</td>
    </tr>
    <tr>
<td>jsonpCallback <sup>2.7+</sup></td>
<td>

设置当 `dataType: 'jsonp'` 时的回调函数名。

</td>
    </tr>
    <tr>
<td>request</td>
<td>

用于对默认的分页相关的请求参数 `page,limit` 重新设定名称。如：

```
request: {
  pageName: 'curr', // 页码的参数名称，默认：page
  limitName: 'nums' // 每页数据条数的参数名，默认：limit
}
```

那么请求数据时的参数将会变为 `?curr=1&nums=30`

</td>
    </tr>
    <tr>
<td>

[**parseData**](#options.parseData)

</td>
<td>

<div class="ws-anchor" id="options.parseData">
  数据格式解析的回调函数，用于将返回的任意数据格式解析成 table 组件规定的数据格式：
</div>

```
{
  "code": 0,
  "msg": "",
  "count": 1000,
  "data": [{}, {}]
} 
```

很多时候，您接口返回的数据格式并不一定都符合 table 默认规定的格式，比如：

```
{
  "status": 0,
  "message": "", 
  "total": 180, 
  "data": {
    "item": [{}, {}]
  }
}
```

此时我们可以借助 `parseData` 回调函数将数据解析并转换为默认规定的格式：

```
table.render({
  elem: '',
  url: '',
  parseData: function(res){ // res 即为原始返回的数据
    return {
      "code": res.status, // 解析接口状态
      "msg": res.message, // 解析提示文本
      "count": res.total, // 解析数据长度
      "data": res.data.item // 解析数据列表
    };
  },
  // … //其他参数
}); 
```

该函数非常实用


</td>
    </tr>
  </tbody>
</table>

<h4 id="data.reserved" class="ws-anchor ws-bold">返回数据中的特定字段</h4>

在返回的数据中，允许规定某些特定字段，以便 table 组件进行相应的特定解析。

| 特定字段名 | 描述 | 读写状态 |
| --- | --- | --- |
| LAY_CHECKED | 当前行的选中状态 | 可读可写 |
| LAY_DISABLED | 当前行是否禁止选择 | 可读可写 |
| LAY_INDEX | 当前行下标。每页重新从零开始计算 | 只读 |
| LAY_NUM | 当前行序号 | 只读 |
| LAY_COL | 当前列的表头属性配置项 | 只读 |

示例一: 在返回的数据中设置特定字段：

```
{
  "code": 0,
  "count": 1000,
  "data": [{},{
    LAY_DISABLED: true
  }]
}
```

示例二: 在模板中读取特定字段示例：

{{!
```
<script type="text/html" id="TPL-demo-xxx">
  当前行下标: {{= d.LAY_INDEX }} 
  当前列的某个表头属性:  {{= d.LAY_COL.field }}
</script>
```
!}}