PinnedSectionItemDecoration

Проект: введение

• Название проекта: PinnedSectionItemDecoration.
• Серия: openharmony, адаптация сторонних компонентов.
• Функция: реализация ListContainer с возможностью приостановки заголовка при скольжении.
• Состояние миграции проекта: при скольжении вверх и вниз в списке могут возникать проблемы с изображением.
• Разница в вызовах: исходный ItemDecoration ListContainer заменён на DependentLayout ListContainer.
• Версия разработки: SDK6, DevEco Studio 2.2 Beta1.
• Базовая версия: master ветка.

Эффект демонстрации

Демонстрация эффекта (рисунок).

Инструкция по установке

1. В файле build.gradle в корневом каталоге проекта:

allprojects {
    repositories {
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
        }
    }
}

2. В файле entry модуля build.gradle:

dependencies {
   implementation('com.gitee.chinasoft_ohos:PinnedSectionItemDecoration:1.0.0')
   ......  
}

Проект можно запустить непосредственно в SDK6 и DevEco Studio 2.2 Beta1. Если запуск невозможен, удалите файлы проекта .gradle, .idea, build, gradle, build.gradle и создайте новый проект на основе вашей версии. Скопируйте соответствующие файлы нового проекта в корневой каталог.

Использование

В библиотеке определён класс MoveMethod, который принимает в качестве параметров ListContainer, Text и Image, которые должны быть приостановлены.

public MoveMethod(ListContainer listContainer,Text pinText,Image pinImage){
        this.listContainer = listContainer;
        this.show_header_item_content_text = pinText;
        this.show_header_item_image = pinImage;
    }

Следует обратить внимание на методы setListSize() и setLittleListNum(), каждый из которых требует передачи длины коллекции. Если есть несколько уровней коллекций, необходимо передать длину самого внутреннего уровня. На данный момент поддерживается только два уровня коллекций.

public void setListSize(int listSize){
        this.listSize = listSize;
    }

    public void setLittleSize(int littleSize){
        this.littleSize = littleSize;
    }

После изменения макета необходимо вызвать метод setLayoutId(). В настоящее время определено пять макетов, используются четыре: LinearLayout, GridLayout, StaggeredGridLayout и LitteTitleLayout. ​```java public void setLayoutId(int layoutId){ this.layoutId = layoutId; }

public int getLayoutId(){
    return layoutId;
}

Также необходимо предоставить источник данных. Существует четыре набора данных, два из которых адаптированы для интерфейса Category, а два — для интерфейса Model. Один набор данных используется, другой — кэшируется. Поэтому необходимо вызывать методы установки двух наборов данных.
​```java
public void setListDatas(List<Category> list){
        this.categoryList = list;
    }

    public void setCacheListDatas(List<Category> list){
        this.cacheCategoryList = list;
}
    
    public void setListModels(List<Model> list){
        this.models = list;
    }
    
    public void setCacheListModels(List<Model> list){
        this.cacheModels = list;
}

Каждый раз после переключения на другую метку необходимо переключать кэш меток, чтобы избежать ошибок в метках. Рекомендуется установить кэш меток в значение первой метки, которая должна быть приостановлена.

public void setCacheTitle(String cacheTitle){
        this.cacheTitle = cacheTitle;
    }

Тестирование

CodeCheck: тестирование кода без исключений. CloudTest: тестирование кода без исключений. Вирусное сканирование: успешно. Текущая версия demo: основные функции аналогичны исходному компоненту.

Версия

1.0.0

Авторские права и лицензии

Copyright 2016 oubowu
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.