FlexibleAdapter

Dev branch version has an experimental Search engine.

Master branch version: 2015.09.05

A pattern for every RecyclerView

The functionalities are taken from different Blogs (see at the bottom of the page), merged and methods have been improved for speed and scalability, for all Activities that use a RecyclerView.

• At lower class there is SelectableAdapter that provides selection functionalities and it's able to maintain the state after the rotation, you just need to call the onSave/onRestore methods from the Activity!
• Then, the class FlexibleAdapter handles the content paying attention at the animations (calling notify only for the position. Note: you still need to set your animation to the RecyclerView when you create it in the Activity).
• Then you need to extend over again this class. Here you add and implement methods as you wish for your own ViewHolder and your Domain/Model class (data holder).

I've put the Set click listeners at the creation and not in the Binding method, because onBindViewHolder is called at each invalidate (each notify..() methods).

Also note that this adapter handles the basic clicks: single and long clicks. If you need a double tap you need to implement the android.view.GestureDetector.

Screenshots

#Setup Ultra simple: No needs to create and import a library for just 2 files, so just copy SelectableAdapter.java & FlexibleAdapter.java in your common package and start to extend FlexibleAdapter from your custom Adapter (see my ExampleAdapter).

Remember to initialize mItems (List already included in FlexibleAdapter) in order to manage list items. Method updateDataSet(..) can help in this.

####Pull requests / Issues / Improvement requests Feel free to contribute and ask!

#Usage for Multi Selection In your activity change the Mode for the ActionMode object.

@Override
public boolean onCreateActionMode(ActionMode mode, Menu menu) {
	mode.getMenuInflater().inflate(R.menu.menu_context, menu);
	mAdapter.setMode(YourAdapterClass.MODE_MULTI);
	return true;
}

@Override
public void onDestroyActionMode(ActionMode mode) {
	mAdapter.setMode(YourAdapterClass.MODE_SINGLE);
	mAdapter.clearSelection();
	mActionMode = null;
}

#Usage for Undo

@Override
public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
	switch (item.getItemId()) {
		//...
		case R.id.action_delete:
			for (int i : mAdapter.getSelectedItems()) {
				//Remove items from your Database. Example:
				DatabaseService.getInstance().removeItem(mAdapter.getItem(i));
			}

			//Keep synchronized the Adapter: Remove selected items from Adapter
			String message = mAdapter.getSelectedItems() + " " + getString(R.string.action_deleted);
			mAdapter.removeItems(mAdapter.getSelectedItems());

			//Any view for Undo, ex. Snackbar
			Snackbar.make(findViewById(R.id.main_view), message, 5000)
					.setAction(R.string.undo, new View.OnClickListener() {
						@Override
						public void onClick(View v) { mAdapter.restoreDeletedItems(); }
					})
					.show();

			//Start countdown with startUndoTimer(millisec)
			mAdapter.startUndoTimer(); //Default 5''
			mActionMode.finish();
			return true;
		//...
	}
}

#Change Log 2015.09.05

• Updated compileSdkVersion and Support libraries to v23
• Customised Undo timeout in the example Activity with original Snackbar

2015.07.29

• Added Undo functionality
• Moved getItem() into FlexibleAdapter, method now is part of the library
• Added synchronized blocks for write operations on mItems list

2015.07.20

• New full working example Android Studio project! (with some nice extra-features)

2015.07.03

• Added new method updateItem()
• Deprecated removeSelection() -> Use toggleSelection() instead!
• In clearSelection removed call to notifyDataSetChanged()
• Improved others methods
• Added more comments

2015.06.19

• Added Mode for Multi and Single fixed selection. The Multi selection was already active, but the Single fixed selection mode still not.
• Reviewed method: toggleSelection(int position) - Adapted for Mode functionality. For more details see the comment of the method!
• Added new method getPositionForItem(T item) - Self explanatory
• Added new method contains(T item) - Another useful method
• Reviewed method updateDataSet(String param) - Added the parameter to filter DataSet

2015.05.03

• Initial release

#Thanks I've used these blogs as starting point:

http://enoent.fr/blog/2015/01/18/recyclerview-basics/

https://www.grokkingandroid.com/statelistdrawables-for-recyclerview-selection/

#License

Copyright 2015 Davide Steduto

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.