# 列表视图
列表视图是一个组合组件，可以灵活组合列表项的内容，并且根据实例化数据进行动态展示。
列表视图由上方列表区和下方的页码区组成。使用时，需要在"列表视图（List View）"上绑定数据模型，且数据类型必须为数组，如果要使用分页功能，分页组件需放在最外层"列表视图（List View Container）"内。
在标准页面设计界面，从"基本组件 \> 布局"中，拖拽"列表视图"组件至页面工作区域，如[图1]。
图1列表视图   
![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960285525.png "点击放大")
#### 查看组件帮助
将鼠标放在对应的组件上，单击![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960285513.png)，可查看组件说明。
图2查看组件说明   
![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960125713.png)
#### 属性
- 数据绑定：通过建立不同类型的视图模型，将各种数据源和组件的返回值或者属性值进行关联，实现动态数据效果。
  - 值绑定：设置组件绑定的数据模型，数据模型一般有以下几种。更多介绍，请参见[值绑定](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_0048.html#astrozero_05_0048__section1786195310514)。
    - 自定义：由用户自定义的前端模型，可以在模型树上快速创建自定义字段。
    
    - 对象：由后台对象模型映射创建，支持选择字段。
    
    - 服务：由后台服务的出入参数模型创建，分别生成inputParam和outputParam节点。
    
    - 事件：由后台事件的字段映射创建，并且支持websocket刷新模型数据。
     
  
  - 属性值绑定，用于对该组件所有属性的动态设置。当某一属性被动态绑定时，以绑定值为准。更多介绍，请参见[属性绑定](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_0048.html#astrozero_05_0048__section1923073313920)。
   
- 基本属性：基本属性通过数据绑定后，在运行时以数据绑定的值为准。
  - 无数据显示：无数据时，显示的名称。 ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960125701.png "点击放大")
    
  
  - 列数(PC)：设置PC端显示列数。
  
  - 列数(Mobile)：设置移动端显示列数。
  
  - 列数排列方式：选择列数排列方式，如居中、左对齐和右对齐等。
  
  - 显示加载中：当要展示的内容较多时，用户看到页面内容可能需要稍长时间，开启加载中效果，体验会更好。
   
- 移动端配置：列表视图在移动端的设置。
  - 下拉刷新：下拉是否刷新列表。
  
  - 默认数据条数：设置移动端列表视图，默认展示数据的数量。
  
  - 显示加载文字：是否显示上拉加载文字。
  
  - 异步加载：和事件（on-load-data）配合使用，上拉加载时，异步获取数据。
   
- 公共
  - 控件名称：当前组件的名称。
  
  - 隐藏：是否隐藏该组件。
   
- 样式
  - 布局：设置组件的宽度、高度等。
  
  - 字体：设置字体大小、字体样式、颜色等。
  
  - 背景：设置背景颜色、透明度。
  
  - 边框：设置边框颜色、宽度等，单位为px。
  
  - 阴影：设置阴影颜色、模糊、扩散等，单位为px。
  
  - 高级设置
    - 样式源码：组件具体样式代码，组件样式设置后，样式代码将自动显示在"样式源码"中。也可以自定义样式代码，对组件进行详细配置。自定义代码支持多行输入，并高亮显示样式参数。
    
    - 样式类：当前组件使用的CSS样式类名，可在CSS代码中进行引用。
     
   
 
#### 事件
在事件中，显示了组件暴露出来的一些常用事件，供用户实现，来扩展组件的交互。整个页面有加载（on-load）事件，该事件在页面渲染完成后执行，可进行数据初始化操作。更多关于事件的介绍，请参见[主要事件说明](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_0089.html)。
#### 库
在库中，可配置页面需要的依赖库，扩展页面功能。库分为系统预置库和自定义库两种，更多介绍请参见[如何引入第三方库](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_0058.html)。
#### 属性值绑定
1. 在列表视图的"属性"页签，单击"数据绑定"中的![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001933046380.png)，绑定数据模型。
   
   模型实例化必须为数组，详情请参见[绑定数据模型、增加查询条件、工具栏](https://support.huaweicloud.com/usermanual-astrozero/astrozero_05_0135.html#astrozero_05_0135__section15211635840)。
   图3绑定数据模型   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001932887004.png "点击放大")
   
   
2. 向列表视图中拖入栅格容器，将栅格容器设置为6行2列，再向前5行中拖入标签组件，并设置标签属性。
3. 属性值绑定。 
   1. 选择第一行、第二列中的标签，单击右侧"属性值绑定"的"+"，新增属性值绑定。 其中，"属性"设置为"文本内容"，再单击![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960285509.png)，添加模型字段，将模型字段绑定到当前标签上。
      图4属性值绑定   
      ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000002015436337.png "点击放大") 
   
   
   
   2. 重复上一步，为其他行的标签组件进行属性值绑定。
   
   
   
   
4. 在第6行拖入一个按钮，设置为"Handle"。
5. 在页面上方，单击![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001960125697.png)，保存页面。
6. 保存成功后，单击![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001933046376.png)，进入预览页面，预期效果是否符合预期。
   
   进行属性值绑定的标签组件，显示绑定的模型字段内容。
   图5通过属性值绑定获取模型中的数据   
   ![](https://support.huaweicloud.com/usermanual-astrozero/zh-cn_image_0000001933046396.png "点击放大")