# LottieBottomNav

**Repository Path**: chinasoft4_ohos/LottieBottomNav

## Basic Information

- **Project Name**: LottieBottomNav
- **Description**: 创建使用 Lottie 视图的底部导航视图的库
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2021-06-23
- **Last Updated**: 2022-08-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LottieBottomNav

#### 项目介绍
- 项目名称：LottieBottomNav
- 所属系列：openharmony的第三方组件适配移植
- 功能：创建使用 Lottie 视图的底部导航视图的库。
- 项目移植状态：主功能完成
- 调用差异：因为openharmony中没有Spannable 、 SpannableString 相关Api,所以字体不能动态拼接颜色功能
- 开发版本：sdk6，DevEco Studio 2.2 Beta1
- 基线版本：Release 1.2.0

#### 效果演示

<img src="gif/video_gif.gif"></img>

#### 安装教程


1.在项目根目录下的build.gradle文件中，
```java
 allprojects {
    repositories {
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
        }
    }
 }
```
2.在entry模块的build.gradle文件中，
```java
 dependencies {
    implementation('com.gitee.chinasoft_ohos:LottieBottomNav:1.0.0')
    ......
 }
```

在sdk6，DevEco Studio 2.2 Beta1下项目可直接运行
如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件，
并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下

#### 使用说明

1.在xml中添加LottieBottomNav控件:

```XML
    <com.wwdablu.soumya.lottiebottomnav.LottieBottomNav
        ohos:width="match_parent"
        ohos:height="80vp"
        ohos:id="$+id:bottom_nav"
        ohos:align_parent_bottom="true"
        ohos:background_element="#ffffff"
        app:menu_selected_height="48vp"
        app:menu_selected_width="48vp"
        app:menu_unselected_height="40vp"
        app:menu_unselected_width="40vp"
        app:menu_text_show_on_unselected="true"
        />
```

2.创建菜单项:

```java
    //LottieBottomNav 包含一组菜单项。创建菜单项的过程是
    MenuItem item1 = MenuItemBuilder.create("home.json",
        fontItem, "dash")
        .pausedProgress(1f)
        .loop(false)
        .build();
    
    //我们可以创建一个具有选中和未选中状态的菜单。另一种创建方法是从现有的菜单项对象，然后修改现有的属性。
     MenuItem item4 = MenuItemBuilder.createFrom(item1, fontItem)
        .selectedLottieName("settings.json")
        .unSelectedLottieName("settings.json")
        .build();
```

3.创建文本菜单项
```java
    FontItem fontItem = FontBuilder.create("Dashboard")
        .selectedTextColor(Color.BLACK.getValue())
        .unSelectedTextColor(Color.GRAY.getValue())
        .selectedTextSize(MSELECTEDTEXTSIZE)
        .unSelectedTextSize(MUNSELECTEDTEXTSIZE)
        .setTypeface(FontUtil.getReadFont(this))
        .build();

```

4.更新特定菜单项
```java
    MenuItem cupidMessage = MenuItemBuilder.createFrom(bottomNav.getMenuItemFor(MINDEX))
        .selectedLottieName("message_cupid.json")
        .tag(CUPID)
        .build();

    bottomNav.updateMenuItemFor(MINDEX, cupidMessage);
```


## 测试信息

CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

当前版本demo功能与原组件基本无差异

## 版本迭代

- 1.0.0

## 版权和许可信息

MIT License