# pinned-section-listview

**Repository Path**: HarmonyOS-tpc/pinned-section-listview

## Basic Information

- **Project Name**: pinned-section-listview
- **Description**: pinnedsectionlist is easy to use ListContainer with pinned sections for openharmony.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-04-15
- **Last Updated**: 2024-06-03

## Categories & Tags

**Categories**: harmonyos-listview

**Tags**: None

## README

# pinned section listview

pinnedsectionlist is easy to use ListContainer with pinned sections for openharmony.
pinnedsection is a header view which sticks to the top of the list until at least one item of that section is visible

# pinned section listview includes :
This pinned section list view implements many features which are missing from other list implementations. These are

1.Headers and footers
2.Clickable pinned sections
3.Multicolor supported headers and footer.
Besides this it doesn't create any unnecessary views, layouts etc. It's really lean.

# Usage Instructions
Usage example

1.Replace standard ListContainer with de.halfbit.pinnedsection.PinnedSectionListView in your ability_main.xml file.
   <de.halfbit.pinnedsection.PinnedSectionListView
              xmlns:ohos="http://schemas.huawei.com/res/ohos"
              ohos:width="match_parent"
              ohos:height="match_parent"/>

2.Extend your DirectionalLayout in a way that it implements PinnedSectionListView , in addition to
what it already implements.
  // PinnedSectionListView pinnedSectionView = (PinnedSectionListView) LayoutScatter.getInstance(this).parse(ResourceTable.Layout_ability_main, null, false);

# Installation Instructions


1.For using pinnedsectionlist module in sample application, include the below library dependency to generate hap/layout.har.
	Modify entry build.gradle as below :
	
	dependencies {
        implementation project(path: ':library')
	}

2.For using pinnedsectionlist in separate application, make sure to add the "library.har" in libs folder of "entry" module.

Modify entry build.gradle as below :

	dependencies {
        implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
	}

3.For using pinnedsectionlist from remote repository in separate application, add the below dependency in "entry" build.gradle.

Modify entry build.gradle as below :

	dependencies {
 	   implementation 'io.openharmony.tpc.thirdlib:pinned-section-listview:1.0.1'
	}

# License


    Copyright 2013-2016 Sergej Shafarenka, halfbit.de

    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.