NavigationManager
A simple helper library to separate navigation logic from your MainActivity and reduce boilerplate.
It also includes ActionMode flow control when the NavigationView is shown/hidden.
Check the sample app.
Minimum API: 14
Build
Add the following to your build.gradle:
dependencies {
compile 'com.github.rubensousa:navigationmanager:1.2.1'
}
How to use
#####1. Create your NavigationManager class that extends from NavigationManager.
#####2. Implement getDefaultItem to show a default fragment on first start.
@Override public int getDefaultItem() {
return R.id.nav_import;
}
3. Implement createFragment to replace your content fragments.
@NonNull @Override public Fragment createFragment(@IdRes int item) {
switch (item) {
case R.id.nav_import:
return new ImportFragment();
case R.id.nav_gallery:
return new GalleryFragment();
default:
return new DummyFragment();
}
}
#####4. Add the following to your MainActivity:
private NavigationManager mNavigationManager; @Override protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
NavigationView navigationView = (NavigationView) findViewById(R.id.nav_view);
DrawerLayout drawer = (DrawerLayout) findViewById(R.id.drawer_layout);
mNavigationManager = new NavigationViewManager(getSupportFragmentManager(),
navigationView, drawer, R.id.containerLayout);
mNavigationManager.init(savedInstanceState, getIntent());
}
// This is useful to navigate when you receive an intent // from a push notification @Override protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
mNavigationManager.navigateWithIntent(intent);
}
@Override protected void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
mNavigationManager.onSaveInstanceState(outState);
}
@Override public void onBackPressed() {
if (!mNavigationManager.closeDrawer()) {
super.onBackPressed();
}
}
5. To navigate with Intents:
Intent intent = NavigationManager.createNavigationIntent(R.id.menuId);
intent.putExtra("argument", "dummy");
mNavigationManager.navigateWithIntent(intent);
The intent will be automatically passed to your fragment
Optional Usage
1. Override createFragmentTransaction(Fragment fragment) to create your own FragmentTransactions
The default transaction is:
public FragmentTransaction createFragmentTransaction(Fragment fragment) {
return mFragmentManager.beginTransaction()
.replace(mContainerId, fragment, CURRENT_TITLE);
}
2. Override commitFragmentTransaction(FragmentTransaction)
The default commit is:
public void commitFragmentTransaction(FragmentTransaction transaction) {
// We can allow state loss because the fragment will start for the first time
transaction.commitAllowingStateLoss();
}
3. Override shouldDelayTransaction to enable/disable the delay between switching fragments
ActionMode pausing/resuming
When the NavigationView opens, you should finish or at least pause the ActionMode. To do this, you can implement NavigationManager.ActionModeListener in your fragments and then:
private ActionMode mActionMode; private boolean mActionModeSuspended = false; @Nullable @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
// ...
if (savedInstanceState != null) {
mActionModeSuspended
= savedInstanceState.getBoolean(NavigationManager.ACTION_MODE_SUSPENDED);
// Restore action mode state if it was active before
if (savedInstanceState.getBoolean(NavigationManager.ACTION_MODE_ACTIVE)) {
mActionMode = ((AppCompatActivity) getActivity()).startSupportActionMode(this);
// restore action mode data here
}
}
return view;
}
@Override public void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
// Save actionMode state. This will internally check if the ActionMode is active
// or suspended by calling isActionModeActive or isActionModeSuspended
NavigationManager.saveActionModeState(outState, this);
}
@Override public void onSuspendActionMode() {
if (mActionMode != null) {
// save ActionMode state here
mActionMode.finish();
mActionMode = null;
mActionModeSuspended = true;
}
}
@Override public void onResumeActionMode() {
mActionMode = ((AppCompatActivity) getActivity()).startSupportActionMode(this);
mActionModeSuspended = false;
// restore action mode state here
}
@Override public boolean isActionModeActive() {
return mActionMode != null;
}
@Override public boolean isActionModeSuspended() {
return mActionModeSuspended;
}
Apps using NavigationManager (Send a PR to add your app here)
License
Copyright 2016 Rúben Sousa 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.