更新时间:2024-08-08 GMT+08:00
分享

列表视图

列表视图是一个组合组件,可以灵活组合列表项的内容,并且根据实例化数据进行动态展示。

列表视图由上方列表区和下方的页码区组成。使用时,需要在“列表视图(List View)”上绑定数据模型,且数据类型必须为数组,如果要使用分页功能,分页组件需放在最外层“列表视图(List View Container)”内。

在标准页面设计界面,从“基本组件 > 布局”中,拖拽“列表视图”组件至页面工作区域,如图1

图1 列表视图

查看组件帮助

将鼠标放在对应的组件上,单击,可查看组件说明。

图2 查看组件说明

属性

  • 数据绑定:通过建立不同类型的视图模型,将各种数据源和组件的返回值或者属性值进行关联,实现动态数据效果。
    • 值绑定:设置组件绑定的数据模型,数据模型一般有以下几种。更多介绍,请参见值绑定
      • 自定义:由用户自定义的前端模型,可以在模型树上快速创建自定义字段。
      • 对象:由后台对象模型映射创建,支持选择字段。
      • 服务:由后台服务的出入参数模型创建,分别生成inputParam和outputParam节点。
      • 事件:由后台事件的字段映射创建,并且支持websocket刷新模型数据。
    • 属性值绑定,用于对该组件所有属性的动态设置。当某一属性被动态绑定时,以绑定值为准。更多介绍,请参见属性绑定
  • 基本属性:基本属性通过数据绑定后,在运行时以数据绑定的值为准。
    • 无数据显示:无数据时,显示的名称。

    • 列数(PC):设置PC端显示列数。
    • 列数(Mobile):设置移动端显示列数。
    • 列数排列方式:选择列数排列方式,如居中、左对齐和右对齐等。
    • 显示加载中:当要展示的内容较多时,用户看到页面内容可能需要稍长时间,开启加载中效果,体验会更好。
  • 移动端配置:列表视图在移动端的设置。
    • 下拉刷新:下拉是否刷新列表。
    • 默认数据条数:设置移动端列表视图,默认展示数据的数量。
    • 显示加载文字:是否显示上拉加载文字。
    • 异步加载:和事件(on-load-data)配合使用,上拉加载时,异步获取数据。
  • 公共
    • 控件名称:当前组件的名称。
    • 隐藏:是否隐藏该组件。
  • 样式
    • 布局:设置组件的宽度、高度等。
    • 字体:设置字体大小、字体样式、颜色等。
    • 背景:设置背景颜色、透明度。
    • 边框:设置边框颜色、宽度等,单位为px。
    • 阴影:设置阴影颜色、模糊、扩散等,单位为px。
    • 高级设置
      • 样式源码:组件具体样式代码,组件样式设置后,样式代码将自动显示在“样式源码”中。也可以自定义样式代码,对组件进行详细配置。自定义代码支持多行输入,并高亮显示样式参数。
      • 样式类:当前组件使用的CSS样式类名,可在CSS代码中进行引用。

事件

在事件中,显示了组件暴露出来的一些常用事件,供用户实现,来扩展组件的交互。整个页面有加载(on-load)事件,该事件在页面渲染完成后执行,可进行数据初始化操作。更多关于事件的介绍,请参见主要事件说明

在库中,可配置页面需要的依赖库,扩展页面功能。库分为系统预置库和自定义库两种,更多介绍请参见如何引入第三方库

属性值绑定

  1. 在列表视图的“属性”页签,单击“数据绑定”中的,绑定数据模型。

    模型实例化必须为数组,详情请参见绑定数据模型、增加查询条件、工具栏
    图3 绑定数据模型

  2. 向列表视图中拖入栅格容器,将栅格容器设置为6行2列,再向前5行中拖入标签组件,并设置标签属性。
  3. 属性值绑定。

    1. 选择第一行、第二列中的标签,单击右侧“属性值绑定”的“+”,新增属性值绑定。

      其中,“属性”设置为“文本内容”,再单击,添加模型字段,将模型字段绑定到当前标签上。

      图4 属性值绑定
    1. 重复上一步,为其他行的标签组件进行属性值绑定。

  4. 在第6行拖入一个按钮,设置为“Handle”。
  5. 在页面上方,单击,保存页面。
  6. 保存成功后,单击,进入预览页面,预期效果是否符合预期。

    进行属性值绑定的标签组件,显示绑定的模型字段内容。
    图5 通过属性值绑定获取模型中的数据

相关文档