2020征文-手機圖解鴻蒙列表組件ListContainer
https://harmonyos.51cto.com/#zz
一、什么是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的優化
對于上面的第5步，當某個列表項從不可見變為可見時，對于自動調用的方法getComponent()，我們是根據列表項的布局文件item.xml創建了一個列表項的實例。這樣的做法性能較差。因為系統會對變為不可見的列表項實例進行緩存，所以對于方法getComponent()中的第二個參數convertComponent有可能不為null。當convertComponent不為null時，說明系統把緩存中的某個列表項實例傳遞過來了，因此，完全可以復用該列表項實例，而沒有必要重新創建一個列表項實例。優化方式如下：
- public class MyItemProvider extends RecycleItemProvider {
- ......
- @Override
- public Component getComponent(int position, Component convertComponent, ComponentContainer componentContainer) {
- if (convertComponent == null) {
- 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;
- }
- }
六、使用ViewHolder對適配器Adapter做終極優化
在上面的代碼中，得到列表項實例后(不管是新創建的列表項實例，還是從緩存中獲得的列表項實例)，都要調用方法findComponentById()以獲得列表項中的子組件。調用方法findComponentById()是比較耗費性能的，所以好的做法是：在新創建列表項實例時，就調用方法findComponentById()以獲得列表項中的所有子組件，并且將所有子組件通過ViewHolder綁定到列表項實例。這樣，當從緩存中獲得列表項實例后，就無需再調用方法findComponentById()了，直接獲得列表項實例綁定的ViewHolder就可以得到所有子組件了。優化方式如下：
- public class MyItemProvider extends RecycleItemProvider {
- ......
- @Override
- public Component getComponent(int position, Component convertComponent, ComponentContainer componentContainer) {
- ViewHolder viewHolder;
- if (convertComponent == null) {
- convertComponent = LayoutScatter.getInstance(slice)
- .parse(ResourceTable.Layout_item, null, false);
- viewHolder = new ViewHolder();
- viewHolder.text = (Text) convertComponent.findComponentById(ResourceTable.Id_name);
- convertComponent.setTag(viewHolder);
- } else {
- viewHolder = (ViewHolder) convertComponent.getTag();
- }
- viewHolder.text.setText(list.get(position).getName());
- return convertComponent;
- }
- class ViewHolder {
- Text text;
- }
- }
如果你理解了為什么要這么優化，相信你會發現：當列表項中只有一個子組件時，也可以不引入ViewHolder，而是將這個子組件直接綁定到列表項實例。代碼如下所示：
- public class MyItemProvider extends RecycleItemProvider {
- ......
- @Override
- public Component getComponent(int position, Component convertComponent, ComponentContainer componentContainer) {
- Text text;
- if (convertComponent == null) {
- convertComponent = LayoutScatter.getInstance(slice)
- .parse(ResourceTable.Layout_item, null, false);
- text = (Text) convertComponent.findComponentById(ResourceTable.Id_name);
- convertComponent.setTag(text);
- } else {
- text = (Text) convertComponent.getTag();
- }
- text.setText(list.get(position).getName());
- return convertComponent;
- }
- }
示例源代碼，請見附件。
歡迎訂閱我的專欄【圖解鴻蒙】：
https://harmonyos.51cto.com/column/27
©著作權歸作者和HarmonyOS技術社區共同所有，如需轉載，請注明出處，否則將追究法律責任
https://harmonyos.51cto.com/#zz
