一、什么是ListContainer
ListContainer是用来呈现连续、多行数据的列表组件,包含一系列相同类型的列表项。如下图所示:
二、ListContainer的架构视图
ListContainer的架构视图如下所示:
ListContainer作为列表,其中的列表项数据是由适配器Adapter提供的,适配器Adapter作为ListContainer和数据源之间的中介&桥梁,将数据源中的数据映射到要展示的ListContainer中,ListContainer负责以列表的形式显示适配器Adapter提供的数据。
三、ListContainer的使用步骤
ListContainer的使用步骤主要包括:
1、创建ListContainer
2、创建列表项的布局
3、使用POJO类封装数据源中与每个列表项对应的数据
4、构造数据源
5、构造适配器Adapter
6、将数据源关联到适配器Adapter
7、将适配器Adapter应用到ListContainer
四、ListContainer的使用示例
示例的运行效果如下图所示:
开发步骤如下:
1、创建ListContainer(ability_main.xml)
xmlns:ohos="http://schemas.huawei.com/res/ohos"
ohos:id="$+id:list_container"
ohos:height="match_parent"
ohos:width="match_parent"/>
2、创建列表项的布局(item.xml)
xmlns:ohos="http://schemas.huawei.com/res/ohos"
ohos:height="match_content"
ohos:width="match_parent"
ohos:orientation="vertical">
ohos:id="$+id:name"
ohos:height="50vp"
ohos:width="match_parent"
ohos:padding="5vp"
ohos:auto_font_size="true"
ohos:text_alignment="center"/>
ohos:height="1vp"
ohos:width="match_parent"
ohos:background_element="#CCCCCC"/>
3、使用POJO类封装数据源中与每个列表项对应的数据(Item.java)
POJO类指的是:只包含属性和相应的getter和setter,而没有业务逻辑的类。
public class Item {
private String name;
public Item(String name) {
this.name = name;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
4、构造数据源(MainAbilitySlice.java)
public class MainAbilitySlice extends AbilitySlice {
@Override
public void onStart(Intent intent) {
super.onStart(intent);
super.setUIContent(ResourceTable.Layout_ability_main);
List list = getData();
}
private List getData() {
List list = new ArrayList<>();
for (int i = 1; i <= 100; i++) {
list.add(new Item("Item " + i));
}
return list;
}
}
5、构造适配器Adapter(MyItemProvider.java)
常用的适配器类是RecycleItemProvider,继承该类时需要重写四个方法:getCount()、getItem()、getItemId()和getComponent()。其中,对于方法getComponent(),当某个列表项从不可见变为可见时会自动调用该方法,在该方法中适配器Adapter会从数据源取数据,并将返回的数据封装在一个Component对象中,以便将该对象返回给ListContainer,从而将数据映射到对应的列表项。
public class MyItemProvider extends RecycleItemProvider {
private List list;
private AbilitySlice slice;
public MyItemProvider(List list, AbilitySlice slice) {
this.list = list;
this.slice = slice;
}
@Override
public int getCount() {
return list.size();
}
@Override
public Object getItem(int position) {
return list.get(position);
}
@Override
public long getItemId(int position) {
return position;
}
@Override
public Component getComponent(int position, Component convertComponent, ComponentContainer componentContainer) {
convertComponent = LayoutScatter.getInstance(slice)
.parse(ResourceTable.Layout_item, null, false);
Text text = (Text) convertComponent.findComponentById(ResourceTable.Id_name);
text.setText(list.get(position).getName());
return convertComponent;
}
}
6、将数据源关联到适配器Adapter(MainAbilitySlice.java)
public class MainAbilitySlice extends AbilitySlice {
@Override
public void onStart(Intent intent) {
......
List list = getData();
MyItemProvider myItemProvider = new MyItemProvider(list, this);
}
......
}
7、将适配器Adapter应用到ListContainer(MainAbilitySlice.java)
public class MainAbilitySlice extends AbilitySlice {
@Override
public void onStart(Intent intent) {
......
MyItemProvider myItemProvider = new MyItemProvider(list, this);
ListContainer listContainer = (ListContainer) findComponentById(ResourceTable.Id_list_container);
listContainer.setItemProvider(myItemProvider);
}
......
}
五、适配器Adapter的优化