A HMOS library to add a Bottom Navigation Bar.
Inspired by Hammad Akram/JustBar
- This library provides an animation similar to Bottom navigation bar.
- This bar has search, chat, cart and settings icons - for demo purpose
- Initially by default a particular icon can be highlighted.
- The user can click on any of the icon, the icon selected will get highlighted and changes to the color specified.
- You can configure the icons by using Red, Green and Blue colors (due to platform dependency)
- You can configure the radius for the icons and the icons will change accordingly.
- For using justbar module in sample app, include the source code and add the below dependencies in entry/build.gradle to generate hap/support.har.
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
testImplementation 'junit:junit:4.13'
ohosTestImplementation 'com.huawei.ohos.testkit:runner:1.0.0.200'
implementation project(':justbar')
}
- For using justbar in separate application using har file, add the har file in the entry/libs folder and add the dependencies in entry/build.gradle file.
dependencies {
implementation fileTree(dir: 'libs', include: ['*.har'])
testImplementation 'junit:junit:4.13'
}
- For using justbar from a remote repository in separate application, add the below dependencies in entry/build.gradle file.
dependencies {
implementation 'dev.applibgroup:justbar:1.0.0'
testImplementation 'junit:junit:4.13'
}
<com.irozon.justbar.JustBar
ohos:id="$+id:bottomBar"
ohos:width="match_parent"
ohos:height="match_content"
ohos:bottom_margin="16vp">
<com.irozon.justbar.BarItem
ohos:id="$+id:barItem"
ohos:width="0vp"
ohos:height="0vp"
app:icon="$graphic:ic_search"
app:radius="35vp" />
.
.
.
</com.irozon.justbar.JustBar>
Attribute | Description |
---|---|
selectedColor |
Selected state color for the BarItem |
unSelectedColor |
Unselected state color for the BarItem |
selectedIconColor |
Selected state color for the icon |
unSelectedIconColor |
Unselected state color for the icon |
selected |
Initial selected or unselected state for BarItem` |
icon |
Icon for BarItem |
radius |
Radius for the BarItem |
Note: The user can only enter Red, Green and Blue colors for the attributes selectedColor, unSelectedColor, selectedIconColor and unSelectedIconColor because of the limitation mentioned in the FutureWork section
justBar.setOnBarItemClickListener(new OnBarItemClickListener() {
@Override
public void onBarItemClick(BarItem barItem, int position) {
// Your code here
}
});
Since there is no alternate api for setColorFilter in HMOS platform, custom attributes - app:selectedColor, app:unSelectedColor, app:selectedIconColor, app:unSelectedIconColor are supported for limited colors because of platform dependency (not all the colors like in android). As a result, user needs to call the createColorMatrix function and pass a colorCode as an argument which will internally call setColorMatrix(createColorMatrix(selectedColor)) to change the color of the drawable. Once HMOS platform supports setColorFilter, then this custom attribute can be included. Due to unavailability of similar api as applyTransformation() in HarmonyOS platform, the animation behaviour is not exactly the same as android base library but it is similar.
Copyright 2018 Irozon, Inc.
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.