### DataList（数据列表）

扩展自$.fn.datagrid.defaults。用于$.fn.datalist.defaults重写默认值对象。（该组件自1.4.2版开始可用）

datalist 组件专用于在列表数据上渲染，这是一个特殊的datagrid组件，专用于渲染1列数据时使用。您可以定义列当中每一行的展示格式及样式。

####

#### 依赖关系

- datagrid

####

#### 用法

使用标签创建数据列表。

1. <ul class="easyui-datalist" title="DataList" style="width:400px;height:250px">
2. <li value="AL">Alabama</li>
3. <li value="AK">Alaska</li>
4. <li value="AZ">Arizona</li>
5. <li value="AR">Arkansas</li>
6. <li value="CA">California</li>
7. <li value="CO">Colorado</li>
8. </ul>

使用Javascript创建分割按钮。

1. <div id="dl"></div>

1. $('#dl').datalist({
2. url: 'datalist_data1.json',
3. checkbox: true,
4. lines: true
5. });

#### 属性

数据列表属性扩展自datagrid，数据列表新增的属性如下：

属性名 | 属性值类型 | 描述 | 默认值
--- | --- | --- | ---
lines | boolean | 定义是否显示行号 | false
checkbox | boolean | 定义是否在每行开头显示复选框。 | false
valueField | string | 行绑定的字段值名称。 | value
textField | string | 行绑定的字段名名称。 | text
groupField | string | 指定分组字段名称。 |
textFormatter | function(value,row,index) | 字段名称格式化器，返回格式化后的字段内容，共3个参数： value：字段值 row：行记录数据 index：行索引 |
groupFormatter | function(value,rows) | 分组名称格式化器，返回格式化后的分组内容，共2个参数： value：通过“groupField”属性定义的分组字段名称 rows：指定分组字段名称对应的数据行记录数组 |

#### 事件

数据列表事件扩展自datagrid。

#### 方法

数据列表方法扩展自datagrid。