Another implementation of the drag-to-dismiss Activity
pattern. This one is inspired by Nick Butcher's Plaid implementation.
The project has a simple API and is a pretty powerful and beautiful implementation of the pattern. This library is used in some of my apps (Talon for Twitter and Pulse SMS). It has been abstracted from Jacob Klinker and I's article-android library, which is an awesome readability style in-app web browser.
This library provides an elastic layout that can dismiss an Activity
with a RecyclerView
or a regular Activity
. Whenever the user swipes up or down, from the bottom or the top of the content, the DragDismissActivity
will finish.
This project was designed to be very easy to implement on top of your existing Activities
.
To include it in your project, add this to your module's build.gradle
file:
dependencies {
...
compile 'com.klinkerapps:drag-dismiss-activity:1.5.0'
}
Note: The normal way to implement the drag-dismiss functionality is by extending the two provided Activities
: DragDismissActivity
and DragDismissRecyclerViewActivity
. If you would rather not do that, I have provided a delegate for each of these use-cases, that you can use: DragDismissDelegate
and DragDismissRecyclerViewDelegate
. To see an example of the delegate's usage, check out the AbstractDragDismissActivity.
This library is meant to replace your AppCompatActivity
. I will set up all the drag-dismiss features for you, and wrap your content in a boilerplate UI that contains a Toolbar
and a ScrollView
for your content.
DragDismissActivity
is easy to implement:
- Within your
AndroidManifest.xml
, on youractivity
elements replace whatever theme you are currently using withandroid:theme="@style/DragDismissTheme
. - Instead of extending
AppCompatActivity
, extend theDragDismissActivity
. - You won't want to override
Activity#onCreate
. Instead, overrideDragDismissActivity#onCreateContent
. This method acts a bit likeFragment#onCreateView
:
@Override
protected View onCreateContent(LayoutInflater inflater, ViewGroup parent, Bundle savedInstanceState) {
View v = inflater.inflate(R.layout.activity_scrollable, parent, false);
// do your normal view setup and Activity#onCreate lifecycle actions here,
// instead of within the Activity#onCreate.
return v;
}
For a very simple example, please see DismissableActivityNormalContent Sample.
If you are using an Activity
that just has a RecyclerView
in it, then this library can do all the heavy-lifting for you, all you will need to do is set it up with a RecyclerView.Adapter
and a LayoutManager
.
DragDismissRecyclerViewActivity
is easy to implement as well:
- Within your
AndroidManifest.xml
, on youractivity
elements replace whatever theme you are currently using withandroid:theme="@style/DragDismissTheme
. - Instead of extending
AppCompatActivity
, extend theDragDismissRecyclerViewActivity
. - You won't want to override
Activity#onCreate
. Instead, to set up yourRecyclerView
, overrideDragDismissRecyclerViewActivity#setupRecyclerView
:
@Override
protected void setupRecyclerView(RecyclerView recyclerView) {
recyclerView.setLayoutManager(new LinearLayoutManager(this));
recyclerView.setAdapter(new SampleAdapter());
// do any other RecyclerView or Activity setup that needs to be done
}
For a very simple example, please see DismissableActivityRecyclerView Sample.
After implementing the steps above, you will get your old Activity
, with drag-to-dismiss functionality at the top and the bottom of the layout, great! You probably want to customize it further though.
I have provided a DragDismissBundleBuilder that allows you to add customization to the DragDismissActivity
through extras on an Intent
:
Intent dragDismissActivity = new Intent(this, MyDragDismissActivity.class);
new DragDismissBundleBuilder(context)
.setTheme(DragDismissBundleBuilder.Theme.LIGHT) // LIGHT (default), DARK, BLACK, DAY_NIGHT
.setPrimaryColorResource(R.color.colorPrimary) // defaults to a semi-transparent black
.setToolbarTitle("Normal Activity Sample") // defaults to null
.setShowToolbar(true) // defaults to true
.setShouldScrollToolbar(true) // defaults to true
.setFullscreenOnTablets(false) // defaults to false, tablets will have padding on each side
.setDragElasticity(DragDismissIntentBuilder.DragElasticity.NORMAL) // Larger elasticities will make it easier to dismiss.
.setDrawUnderStatusBar(false) // defaults to false. Change to true if you don't want me to handle the content margin for the Activity. Does not apply to the RecyclerView Activities
.build(dragDismissActivity);
// do anything else that you want to set up the Intent
// dragDismissActivity.putBoolean("test_bool", true);
startActivity(dragDismissActivity);
Have content that won't be loaded immediately? No problem.
While content is loading, you can call DragDismissActivity#showProgessBar
to automatically show the progress indicator. When the content is done loading, just call DragDismissActivity#hideProgessBar
to remove it.
For a simple example usage, check out the DismissableActivityNormalContent sample.
Originally based off of klinker41's work for article-android.
Please fork this repository and contribute back using pull requests. Features can be requested using issues. All code, comments, and critiques are greatly appreciated.
The full changelog for the library can be found here.
Copyright 2017 Luke Klinker
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.