# WaveSideBar

**Repository Path**: hihopeorg/WaveSideBar

## Basic Information

- **Project Name**: WaveSideBar
- **Description**: 一个快速跳跃分组的侧边栏控件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-09-02
- **Last Updated**: 2021-11-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WaveSideBar

**本项目是基于开源项目WaveSideBar进行ohos化的移植和开发的，可以通过项目标签以及github地址（https://github.com/Solartisan/WaveSideBar ）追踪到原项目版本。**

#### 项目介绍

- 项目名称：WaveSideBar
- 所属系列：ohos的第三方组件适配移植
- 项目移植状态：完成
- 调用差异：无
- 项目作者和维护人：hihope
- 联系方式：hihope@hoperun.com
- 原项目Doc地址：https://github.com/Solartisan/WaveSideBar
- 原项目基线版本：无
- 功能介绍：一个快速跳跃分组的侧边栏控件
- 编程语言：Java
- 外部依赖：无

#### 效果展示

<img src="screenshot/效果展示.gif"/>

#### 安装教程

##### 方案一：

1.编译har包WaveSideBar.har。
2.启动 DevEco Studio，将har包，导入工程目录“entry->libs”下。
3.在moudle级别下的build.gradle文件中添加依赖，在dependences标签中增加对libs目录下har包的引用。

```
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.har'])
	……
}
```
4.在导入的har包上点击右键，选择“Add as Library”对包进行引用，选择需要引用的模块，并点击“OK”即引用成功。

##### 方案二：

1. 在工程的build.gradle的allprojects中，添加HAR所在的Maven仓地址:

```
 repositories {
     maven {
         url 'http://106.15.92.248:8081/repository/Releases/' 
     }
 }
```

2. 在应用模块的build.gradle的dependencies闭包中，添加如下代码:

```
 dependencies {
     implementation 'com.solart.wavesidebar.ohos:waveslidebar:1.0.0'
 }
```

#### 使用说明

1.编写布局：
```
   <cc.solart.wave.WaveSideBarView
          ohos:id="$+id:side_view"
          ohos:height="match_parent"
          ohos:width="match_content"/>
```
2.代码中设置监听
```
   waveSideBarView.setOnTouchLetterChangeListener(new WaveSideBarView.OnTouchLetterChangeListener() {
               @Override
               public void onLetterChange(String letter) {
                   for (int i = 0; i < mList.size(); i++) {
                       if (mList.get(i).pys.substring(0, 1).equals(letter)) {
                           if (mPosition != i) {
                               listContainer.scrollTo(i);
                               mPosition = i;
                           }
                           return;
                       }
                   }
               }
           });
```

#### 版本迭代

- v1.0.0

1.目前支持功能如下

```
- 快速跳跃分组的侧边栏控件
```