init

public/frontend/layui-main/docs/table/detail/options.ajax.md

@@ -0,0 +1,181 @@
+<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>
+```
+!}}