BindingCollectionAdapter


Source link: https://github.com/evant/binding-collection-adapter

BindingCollectionAdapter

Easy way to bind collections to listviews and recyclerviews with the new Android Data Binding framework.

Download

compile 'me.tatarka.bindingcollectionadapter2:bindingcollectionadapter:2.2.0' compile 'me.tatarka.bindingcollectionadapter2:bindingcollectionadapter-recyclerview:2.2.0'

requires at least android gradle plugin 2.3.0.

Usage

You need to provide your items and an ItemBinding to bind to the layout. You should use an ObservableList to automatically update your view based on list changes. However, you can use any List if you don't need that functionality.

public class ViewModel {

public final ObservableList<String> items = new ObservableArrayList<>();

public final ItemBinding<String> itemBinding = ItemBinding.of(BR.item, R.layout.item);
 
}

Then bind it to the collection view with app:items and app:itemBinding. There are also some convenience factories to attach a LayoutManager to a RecyclerView with app:layoutManager.

<!-- layout.xml --> <layout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto">
  <data>

 <import type="com.example.R" />

 <import type="me.tatarka.bindingcollectionadapter2.LayoutManagers" />

 <variable name="viewModel" type="com.example.ViewModel"/>
  </data>

<ListView

 android:layout_width="match_parent"

 android:layout_height="match_parent"

 app:items="@{
viewModel.items
}
"

 app:itemBinding="@{
viewModel.itemBinding
}
"/>

<android.support.v7.widget.RecyclerView

 android:layout_width="match_parent"

 android:layout_height="match_parent"

 app:layoutManager="@{
LayoutManagers.linear()
}
"

 app:items="@{
viewModel.items
}
"

 app:itemBinding="@{
viewModel.itemBinding
}
"/>

<android.support.v4.view.ViewPager

 android:layout_width="match_parent"

 android:layout_height="match_parent"

 app:items="@{
viewModel.items
}
"

 app:itemBinding="@{
viewModel.itemBinding
}
"/>

<Spinner

 android:layout_width="match_parent"

 android:layout_height="match_parent"

 app:items="@{
viewModel.items
}
"

 app:itemBinding="@{
viewModel.itemBinding
}
"

 app:itemDropDownLayout="@{
R.layout.item_dropdown
}
"/> </layout>

In your item layout, the collection item will be bound to the variable with the name you passed into the ItemBinding.

<!-- item.xml --> <layout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto">
  <data>

 <variable name="item" type="String"/>
  </data>

<TextView

 android:id="@+id/text"

 android:layout_width="match_parent"

 android:layout_height="wrap_content"

 android:text="@{
item
}
"/> </layout>

Multiple View Types

You can use multiple view types by using OnItemBind instead. You can still bind it to the view with app:itemBinding.

public final OnItemBind<String> onItemBind = new OnItemBind<String>() {

@Override
public void onItemBind(ItemBinding itemBinding, int position, String item) {

  itemBinding.set(BR.item, position == 0 ? R.layout.item_header : R.layout.item);

}
 
}
;

If you are binding to a ListView, you must also provide the number of item types you have with app:itemTypeCount="@{ 2 } .

Note that onItemBind is called many times so you should not do any complex processing in there. If you don't need to bind an item at a specific position (a static footer for example) you can use ItemBinding.VAR_NONE as the variable id.

Bind Extra Variables

You can bind additional variables to items in the list with itemBinding.bindExtra(BR.extra, value). This is useful for components that you don't want the items themselves to care about. For example, you can implement an item click listener as such

public interface OnItemClickListener {

  void onItemClick(String item);
 
}
  OnItemClickListener listener = ...; ItemBinding<Item> itemBinding = ItemBinding.<Item>of(BR.item, R.layout.item)
  .bindExtra(BR.listener, listener);
<layout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto">
  <data>

 <variable name="item" type="String"/>

 <variable name="listener" type="OnItemClickListener"/>
  </data>

<TextView

 android:id="@+id/text"

 android:layout_width="match_parent"

 android:layout_height="wrap_content"

 android:onClick="@{
() -> listener.onItemClick(item)
}
"

 android:text="@{
item
}
"/> </layout>

Additional Adapter Configuration

ListView

You can set a callback to give an id for each item in the list with

adapter.setItemIds(new BindingListViewAdapter.ItemIds<T>() {

@Override
public long getItemId(int position, T item) {

  return // Calculate item id.

}
 
}
);

or by defining app:itemIds="@{ itemIds } " in the ListView in your layout file. Setting this will make hasStableIds return true which can increase performance of data changes.

You can set a callback for isEnabled() as well with

adapter.setItemEnabled(new BindingListViewAdapter.ItemEnabled<T>() {

@Override
public boolean isEnabled(int position, T item) {

  return // Calculate if item is enabled.

}
 
}
);

or by defining app:itemEnabled="@{ itemEnabled } "in the ListView in you layout file.

ViewPager

You can set a callback to give a page title for each item in the list with

adapter.setPageTitles(new PageTitles<T>() {

@Override
public CharSequence getPageTitle(int position, T item) {

  return "Page Title";

}
 
}
);

or by defining app:pageTitles="@{ pageTitles } " in the ViewPager in your layout file.

RecyclerView

You can construct custom view holders with

adapter.setViewHolderFactory(new ViewHolderFactory() {

@Override
public RecyclerView.ViewHolder createViewHolder(ViewDataBinding binding) {

  return new MyCustomViewHolder(binding.getRoot());

}
 
}
);

or by defining app:viewHolder="@{ viewHolderFactory } " in the RecyclerView in your layout file.

Directly manipulating views

Data binding is awesome and all, but you may run into a case where you simply need to manipulate the views directly. You can do this without throwing away the whole of databinding by subclassing an existing BindingCollectionAdapter. You can then bind adapter in your layout to your subclass's class name to have it use that instead. Instead of overriding the normal adapter methods, you should override onCreateBinding() or onBindBinding() and call super allowing you to run code before and after those events and get access to the item view's binding.

public class MyRecyclerViewAdapter<T> extends BindingRecyclerViewAdapter<T> {

 @Override
public ViewDataBinding onCreateBinding(LayoutInflater inflater, @LayoutRes int layoutId, ViewGroup viewGroup) {

  ViewDataBinding binding = super.onCreateBinding(inflater, layoutId, viewGroup);

  Log.d(TAG, "created binding: " + binding);

  return binding;

}

 @Override
public void onBindBinding(ViewDataBinding binding, int bindingVariable, @LayoutRes int layoutId, int position, T item) {

  super.onBindBinding(binding, bindingVariable, layoutId, position, item);

  Log.d(TAG, "bound binding: " + binding + " at position: " + position);

}
 
}
<android.support.v7.widget.RecyclerView
android:layout_width="match_parent"
android:layout_height="match_parent"
app:layoutManager="@{
LayoutManagers.linear()
}
"
app:items="@{
viewModel.items
}
"
app:itemBinding="@{
viewModel.itemBinding
}
"
app:adapter="@{
viewModel.adapter
}
"/>

Note: databinding will re-evaluate expressions in your layout each time there is a data source change. If you are using a custom adapter you should ensure you are returning the same instance each time or your scroll position etc will not be preserved.

OnItemBind helpers

There are a few classes to help with common implementations of OnItemBind.

OnItemBindClass binds an item based on the class of the item in the list.

itemBind = new OnItemBindClass<>()
.map(String.class, BR.name, R.layout.item_name)
.map(Footer.class, ItemBinding.VAR_NONE, R.layout.item_footer)
.map(Item.class, new OnItemBind<Item>() {

@Override

public void onItemBind(ItemBinding itemBinding, int position, Item item) {

  itemBinding.clearExtras()

 .set(BR.item, position == 0 ? R.layout.item_header : R.layout.item)

 .bindExtra(BR.extra, (list.size() - 1) == position);

}

 
}
)
.map(Object.class, ItemBinding.VAR_NONE, R.layout.item_other);

OnItemBindModel delegates to the items in the list themselves to determine the binding.

itemBind = new OnItemBindModel<Model>();
  public class Model implements ItemBindingModel {

@Override
public void onItemBind(ItemBinding itemBinding) {

  itemBinding.set(BR.name, R.layout.item_name);

}
 
}

MergeObservableList

There are many times you want to merge multiple data sources together. This can be as simple as adding headers and footers or as complex as concatenating multiple data sources. It is hard to manage these lists yourself since you have to take into account all items when updating a subset.

MergeObservableList solves this by giving you a "merged" view of your data sources.

ObservableList<String> data = new ObservableArrayList<>();
 MergeObservableList<String> list = new MergeObservableList<>()
.insertItem("Header")
.insertList(data)
.insertItem("Footer");
  data.addAll(Arrays.asList("One", "Two"));
 // list => ["Header", "One", "Two", "Footer"] data.remove("One");
 // list => ["Header", "Two", "Footer"]

DiffObservableList

Say you want to update list 'a' to list 'b' and you don't want to calculate what has changed between the two manually.

DiffObservableList builds off of DiffUtil to automatically calculate the changes between two lists.

DiffObservableList<Item> list = new DiffObservableList(new DiffObservableList.Callback<Item>() {

  @Override
  public boolean areItemsTheSame(Item oldItem, Item newItem) {

return oldItem.id.equals(newItem.id);

  
}

@Override
  public boolean areContentsTheSame(Item oldItem, Item newItem) {

return oldItem.value.equals(newItem.value);

  
}
 
}
);
  list.update(Arrays.asList(new Item("1", "a"), new Item("2", "b1")));
 list.update(Arrays.asList(new Item("2", "b2"), new Item("3", "c"), new Item("4", "d"));

With large lists diffing might be too costly to run on the main thread. In that case you can calculate the diff on a background thread.

DiffObservableList<Item> list = new DiffObservableList(...);
  // On background thread: DiffUtil.DiffResult diffResult = list.calculateDiff(newItems);
  // On main thread: list.update(newItems, diffResult);

Known Issues

Cannot Resolve the libraries @BindingAdapter's

This is likely because you are using the android-apt plugin which broke this in previous versions. Update to 1.6+ to fix it.

View's adapter is null

If you attempt to retrieve an adapter from a view right after binding it you may find it is null. This is because databinding waits for the next draw pass to run to batch up changes. You can force it to run immediately by calling binding.executePendingBindings().

License

Copyright 2015 Evan Tatarka  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. 

Resources

A json-api-mock framework for Android.

CodeView helps to show code content with syntax highlighting in native way.

Freeline is a fast build and deployment tool for Android. Caching reusable class files and resource indices, it enables incrementally building Android apps, and optionally deploying the update to your device with hot swap.

A Subclass of ImageView that 'morphs' into a circle shape and can rotates. Useful to be used as album cover in Music apps.

A multi level menu view (like WeChat subscription Accounts) library for Android.

Topics


2D Engines   3D Engines   9-Patch   Action Bars   Activities   ADB   Advertisements   Analytics   Animations   ANR   AOP   API   APK   APT   Architecture   Audio   Autocomplete   Background Processing   Backward Compatibility   Badges   Bar Codes   Benchmarking   Bitmaps   Bluetooth   Blur Effects   Bread Crumbs   BRMS   Browser Extensions   Build Systems   Bundles   Buttons   Caching   Camera   Canvas   Cards   Carousels   Changelog   Checkboxes   Cloud Storages   Color Analysis   Color Pickers   Colors   Comet/Push   Compass Sensors   Conferences   Content Providers   Continuous Integration   Crash Reports   Credit Cards   Credits   CSV   Curl/Flip   Data Binding   Data Generators   Data Structures   Database   Database Browsers   Date &   Debugging   Decompilers   Deep Links   Dependency Injections   Design   Design Patterns   Dex   Dialogs   Distributed Computing   Distribution Platforms   Download Managers   Drawables   Emoji   Emulators   EPUB   Equalizers &   Event Buses   Exception Handling   Face Recognition   Feedback &   File System   File/Directory   Fingerprint   Floating Action   Fonts   Forms   Fragments   FRP   FSM   Functional Programming   Gamepads   Games   Geocaching   Gestures   GIF   Glow Pad   Gradle Plugins   Graphics   Grid Views   Highlighting   HTML   HTTP Mocking   Icons   IDE   IDE Plugins   Image Croppers   Image Loaders   Image Pickers   Image Processing   Image Views   Instrumentation   Intents   Job Schedulers   JSON   Keyboard   Kotlin   Layouts   Library Demos   List View   List Views   Localization   Location   Lock Patterns   Logcat   Logging   Mails   Maps   Markdown   Mathematics   Maven Plugins   MBaaS   Media   Menus   Messaging   MIME   Mobile Web   Native Image   Navigation   NDK   Networking   NFC   NoSQL   Number Pickers   OAuth   Object Mocking   OCR Engines   OpenGL   ORM   Other Pickers   Parallax List   Parcelables   Particle Systems   Password Inputs   PDF   Permissions   Physics Engines   Platforms   Plugin Frameworks   Preferences   Progress Indicators   ProGuard   Properties   Protocol Buffer   Pull To   Purchases   Push/Pull   QR Codes   Quick Return   Radio Buttons   Range Bars   Ratings   Recycler Views   Resources   REST   Ripple Effects   RSS   Screenshots   Scripting   Scroll Views   SDK   Search Inputs   Security   Sensors   Services   Showcase Views   Signatures   Sliding Panels   Snackbars   SOAP   Social Networks   Spannable   Spinners   Splash Screens   SSH   Static Analysis   Status Bars   Styling   SVG   System   Tags   Task Managers   TDD &   Template Engines   Testing   Testing Tools   Text Formatting   Text Views   Text Watchers   Text-to   Toasts   Toolkits For   Tools   Tooltips   Trainings   TV   Twitter   Updaters   USB   User Stories   Utils   Validation   Video   View Adapters   View Pagers   Views   Watch Face   Wearable Data   Wearables   Weather   Web Tools   Web Views   WebRTC   WebSockets   Wheel Widgets   Wi-Fi   Widgets   Windows   Wizards   XML   XMPP   YAML   ZIP Codes