# FabulousFilter
**Repository Path**: deviche/FabulousFilter
## Basic Information
- **Project Name**: FabulousFilter
- **Description**: Android library to animate Floating Action Button to Bottom Sheet Dialog and vice-versa
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-11-14
- **Last Updated**: 2020-12-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# FabulousFilter
[](https://android-arsenal.com/api?level=15) []( https://android-arsenal.com/details/1/5943) [](https://material.uplabs.com/posts/fabulousfilter-library)
### Show some :heart: and star the repo to support the project
[](https://github.com/Krupen/FabulousFilter/stargazers) [](https://github.com/Krupen/FabulousFilter/network) [](https://github.com/Krupen/FabulousFilter/watchers) [](https://github.com/Krupen/followers)
[](https://twitter.com/krupenghetiya)
This library is the implementation of filter-concept posted on MaterialUp.com.
It makes animation of FloatingActionButton to BottomSheetDialog easy to implement.
# Concept
# Demo
 
# Download
**Gradle**
**Step 1.** Add the jCenter repository to your project-level build.gradle file
``` groovy
allprojects {
repositories {
jcenter()
}
}
```
**Step 2.** Add the dependency to your app-level build.gradle file:
``` groovy
dependencies {
compile 'com.allattentionhere:fabulousfilter:0.0.5'
}
```
# Usage
Create a Fragment that extends `AAH_FabulousFragment`:
```
public class MySampleFabFragment extends AAH_FabulousFragment {
public static MySampleFabFragment newInstance() {
MySampleFabFragment f = new MySampleFabFragment();
return f;
}
@Override
public void setupDialog(Dialog dialog, int style) {
View contentView = View.inflate(getContext(), R.layout.filter_sample_view, null);
RelativeLayout rl_content = (RelativeLayout) contentView.findViewById(R.id.rl_content);
LinearLayout ll_buttons = (LinearLayout) contentView.findViewById(R.id.ll_buttons);
contentView.findViewById(R.id.btn_close).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
closeFilter("closed");
}
});
//params to set
setAnimationDuration(600); //optional; default 500ms
setPeekHeight(300); // optional; default 400dp
setCallbacks((Callbacks) getActivity()); //optional; to get back result
setAnimationListener((AnimationListener) getActivity()); //optional; to get animation callbacks
setViewgroupStatic(ll_buttons); // optional; layout to stick at bottom on slide
setViewPager(vp_types); //optional; if you use viewpager that has scrollview
setViewMain(rl_content); //necessary; main bottomsheet view
setMainContentView(contentView); // necessary; call at end before super
super.setupDialog(dialog, style); //call super at last
}
}
```
Create view for the fragment which has parent element `AAH_FilterView`:
```
```
Start the fragment on click of FloatingActionButton as below:
```
fab.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
MySampleFabFragment dialogFrag = MySampleFabFragment.newInstance();
dialogFrag.setParentFab(fab);
dialogFrag.show(getSupportFragmentManager(), dialogFrag.getTag());
}
});
```
# Parameters
* ### Main View (Required)
This parameter specifies the ViewGroup of the bottom sheet to be shown after animation ends. It can be any ViewGroup(LinearLayout/FrameLayout etc):
```
setViewMain(relativelayout_content);
```
* ### Inflated Dialog View (Required)
This parameter specifies the inflated view for the dialog:
```
setMainContentView(contentDialogView);
```
* ### Animation duration (Optional)
This parameter sets animation duration of translate and scale animation in `milliseconds`:
```
setAnimationDuration(600); // default 500ms
```
* ### Peek Height (Optional)
This parameter sets the peek height of the bottom sheet in `dp`:
```
setPeekHeight(300); // default 400dp
```
* ### Callback (Optional)
This paramter is used to get callback from `AAH_FabulousFragment` to the component that called it:
```
setCallbacks((Callbacks) getActivity());
```
To use it, implement the callback in the calling component(Activity/Fragment etc), example:
```
public class MainSampleActivity extends AppCompatActivity implements AAH_FabulousFragment.Callbacks {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main_sample);
}
@Override
public void onResult(Object result) {
Log.d("k9res", "onResult: " + result.toString());
if (result.toString().equalsIgnoreCase("swiped_down")) {
//do something or nothing
} else {
//handle result
}
}
}
```
* ### Animation Listener (Optional)
This parameter is used to get animation callbacks.
```
setAnimationListener((AnimationListener) getActivity());
```
To use it, implement the AnimationListener in the calling component(Activity/Fragment etc), example:
```
public class MainSampleActivity extends AppCompatActivity implements AAH_FabulousFragment.AnimationListener {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main_sample);
}
@Override
public void onOpenAnimationStart() {
//do something on open animation start
}
@Override
public void onOpenAnimationEnd() {
//do something on open animation end
}
@Override
public void onCloseAnimationStart() {
//do something on close animation start
}
@Override
public void onCloseAnimationEnd() {
//do something on close animation start
}
}
```
* ### Static View (Optional)
This parameter is used to make view in Bottom Sheet static when user slides it. It can be any ViewGroup(LinearLayout/FrameLayout etc):
```
setViewgroupStatic(linearlayout_buttons);
```
* ### ViewPager (Optional)
This parameter is used to support scrolling in ViewPager as BottomSheetDialog does not support multiple views with scroll:
```
setViewPager(viewPager);
```
# Libraries by developer
* AutoplayVideos
# Apps by developer
[](https://play.google.com/store/apps/details?id=com.allattentionhere.pricestalker) [](https://play.google.com/store/apps/details?id=com.allattentionhere.show) [](https://play.google.com/store/apps/details?id=com.allattentionhere.safio)
# License
Copyright 2017 Krupen Ghetiya
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.