DDWiki/实践/速e/走通/列表/列表基本功能.md

# 第一个列表

![](1.png)


基本配置
```
列表名称：
表名：
主键字段：ID
数据源类型：
数据源实例名：省份库2
Sql内容：

SELECT ID
	,NAME
	,CODE
	,SHORT_NAME
	,AREA_ID
	,COUNTRY_ID
	,RANGE_ID
	,REMARKS
	,VALID_FLAG
	,VALID_DATE_FROM
	,VALID_DATE_TO
	,DISPORDER
	,EDIT_FLAG
	,DELETE_FLAG
	,CREATE_TIME
	,CREATE_USER_ID
	,MODIFY_TIME
	,MODIFY_USER_ID
	,POP
FROM ea_province
WHERE 1=1
WHEREHOLDER
```

> 如果表名改成和数据库表名不一样会怎样？

报错：表架构信息不存在

![](2.png)

> 如果主键字段随便用一个会怎样？

报错：主键列没有在数据源里

![](3.png)

# 隐藏列

列表视图 > 编辑 > 列配置 > ID > 显示类型

> 列隐藏后可以支持查询吗？

可以。

> 隐藏数据什么时候使用？

不想在界面上显示，比如说可以通过js取值。

> 隐藏数据的本质是什么？

实际上是给列设置了`display:none`。

> 在表头合并的时候，是否需要算上隐藏数据这一列？

需要。因为隐藏数据列虽然界面上不可见，但界面还是渲染了。

> 需要新增、修改、删除主键列，是否可以设置为隐藏？

不可以。


# 修改数据库字段在列表界面上的显示名称

列表视图 > 编辑 > 列配置 > NAME > 显示名字

# 让字段AREA_ID显示洲名称

![](4.png)

列表视图 > 编辑 > 列配置 > AREA_ID > 编辑 > 基本配置
```
 列类型：带搜索的Bootstrap
 显示名称：勾选
```

列表视图 > 编辑 > 列配置 > AREA_ID > 编辑 > 数据源配置

```
值字段名：ID
显示字段名：NAME
数据源类型：数据库
数据源实例名：省份库2
SQL内容：

SELECT ID
	,NAME
FROM ea_area
WHERE 1=1
ORDER BY VALID_FLAG DESC, DISPORDER

```

# 让字段VALID_FLAG显示是否有效

![](5.png)

列表视图 > 编辑 > 列配置 > VALID_FLAG > 编辑 > 基本配置

```
绑定字段：VALID_FLAG
显示名称：有效性
列类型：复选列(编辑状态的时候是复选列)
显示名称：勾选(当需要原始字段值的显示名称时使用)
```

列表视图 > 编辑 > 列配置 > VALID_FLAG > 编辑 > 数据源配置、
```
数据源类型：固定值
固定值数据配置：
    1 有效
    0 无效
```

# 增加序号列

![](6.png)

列表视图 > 编辑 > 列配置

```
点击"行内新增列"
显示名称：序号
列类型：序号列
顺序：1
```