All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.joanzapata.android.BaseAdapterHelper Maven / Gradle / Ivy

There is a newer version: 1.1.11
Show newest version
/**
 * Copyright 2013 Joan Zapata
 *
 * 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.
 */
package com.joanzapata.android;

import android.content.Context;
import android.graphics.Bitmap;
import android.graphics.Paint;
import android.graphics.Typeface;
import android.graphics.drawable.Drawable;
import android.os.Build;
import android.text.util.Linkify;
import android.util.SparseArray;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.view.animation.AlphaAnimation;
import android.widget.ImageView;
import android.widget.ProgressBar;
import android.widget.RatingBar;
import android.widget.TextView;
import com.squareup.picasso.Picasso;
import com.squareup.picasso.RequestCreator;

/**
 * Allows an abstraction of the ViewHolder pattern.
*
*

* Usage *

*

 * return BaseAdapterHelper.get(context, convertView, parent, R.layout.item)
 *         .setText(R.id.tvName, contact.getName())
 *         .setText(R.id.tvEmails, contact.getEmails().toString())
 *         .setText(R.id.tvNumbers, contact.getNumbers().toString())
 *         .getView();
 * 
*/ public class BaseAdapterHelper { /** Views indexed with their IDs */ private final SparseArray views; private final Context context; private int position; private View convertView; /** Package private field to retain the associated user object and detect a change */ Object associatedObject; private BaseAdapterHelper(Context context, ViewGroup parent, int layoutId, int position) { this.context = context; this.position = position; this.views = new SparseArray(); convertView = LayoutInflater.from(context) // .inflate(layoutId, parent, false); convertView.setTag(this); } /** * This method is the only entry point to get a BaseAdapterHelper. * @param context The current context. * @param convertView The convertView arg passed to the getView() method. * @param parent The parent arg passed to the getView() method. * @return A BaseAdapterHelper instance. */ public static BaseAdapterHelper get(Context context, View convertView, ViewGroup parent, int layoutId) { return get(context, convertView, parent, layoutId, -1); } /** This method is package private and should only be used by QuickAdapter. */ static BaseAdapterHelper get(Context context, View convertView, ViewGroup parent, int layoutId, int position) { if (convertView == null) { return new BaseAdapterHelper(context, parent, layoutId, position); } // Retrieve the existing helper and update its position BaseAdapterHelper existingHelper = (BaseAdapterHelper) convertView.getTag(); existingHelper.position = position; return existingHelper; } /** * This method allows you to retrieve a view and perform custom * operations on it, not covered by the BaseAdapterHelper.
* If you think it's a common use case, please consider creating * a new issue at https://github.com/JoanZapata/base-adapter-helper/issues. * @param viewId The id of the view you want to retrieve. */ public T getView(int viewId) { return retrieveView(viewId); } /** * Will set the text of a TextView. * @param viewId The view id. * @param value The text to put in the text view. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setText(int viewId, String value) { TextView view = retrieveView(viewId); view.setText(value); return this; } /** * Will set the image of an ImageView from a resource id. * @param viewId The view id. * @param imageResId The image resource id. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setImageResource(int viewId, int imageResId) { ImageView view = retrieveView(viewId); view.setImageResource(imageResId); return this; } /** * Will set background color of a view. * @param viewId The view id. * @param color A color, not a resource id. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setBackgroundColor(int viewId, int color) { View view = retrieveView(viewId); view.setBackgroundColor(color); return this; } /** * Will set background of a view. * @param viewId The view id. * @param backgroundRes A resource to use as a background. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setBackgroundRes(int viewId, int backgroundRes) { View view = retrieveView(viewId); view.setBackgroundResource(backgroundRes); return this; } /** * Will set text color of a TextView. * @param viewId The view id. * @param textColor The text color (not a resource id). * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setTextColor(int viewId, int textColor) { TextView view = retrieveView(viewId); view.setTextColor(textColor); return this; } /** * Will set text color of a TextView. * @param viewId The view id. * @param textColorRes The text color resource id. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setTextColorRes(int viewId, int textColorRes) { TextView view = retrieveView(viewId); view.setTextColor(context.getResources().getColor(textColorRes)); return this; } /** * Will set the image of an ImageView from a drawable. * @param viewId The view id. * @param drawable The image drawable. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setImageDrawable(int viewId, Drawable drawable) { ImageView view = retrieveView(viewId); view.setImageDrawable(drawable); return this; } /** * Will download an image from a URL and put it in an ImageView.
* It uses Square's Picasso library to download the image asynchronously and put the result into the ImageView.
* Picasso manages recycling of views in a ListView.
* If you need more control over the Picasso settings, use {BaseAdapterHelper#setImageBuilder}. * @param viewId The view id. * @param imageUrl The image URL. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setImageUrl(int viewId, String imageUrl) { ImageView view = retrieveView(viewId); Picasso.with(context).load(imageUrl).into(view); return this; } /** * Will download an image from a URL and put it in an ImageView.
* @param viewId The view id. * @param requestBuilder The Picasso request builder. (e.g. Picasso.with(context).load(imageUrl)) * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setImageBuilder(int viewId, RequestCreator requestBuilder) { ImageView view = retrieveView(viewId); requestBuilder.into(view); return this; } /** Add an action to set the image of an image view. Can be called multiple times. */ public BaseAdapterHelper setImageBitmap(int viewId, Bitmap bitmap) { ImageView view = retrieveView(viewId); view.setImageBitmap(bitmap); return this; } /** * Add an action to set the alpha of a view. Can be called multiple times. * Alpha between 0-1. */ public BaseAdapterHelper setAlpha(int viewId, float value) { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) { retrieveView(viewId).setAlpha(value); } else { // Pre-honeycomb hack to set Alpha value AlphaAnimation alpha = new AlphaAnimation(value, value); alpha.setDuration(0); alpha.setFillAfter(true); retrieveView(viewId).startAnimation(alpha); } return this; } /** * Set a view visibility to VISIBLE (true) or GONE (false). * @param viewId The view id. * @param visible True for VISIBLE, false for GONE. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setVisible(int viewId, boolean visible) { View view = retrieveView(viewId); view.setVisibility(visible ? View.VISIBLE : View.GONE); return this; } /** * Add links into a TextView. * @param viewId The id of the TextView to linkify. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper linkify(int viewId) { TextView view = retrieveView(viewId); Linkify.addLinks(view, Linkify.ALL); return this; } /** Apply the typeface to the given viewId, and enable subpixel rendering. */ public BaseAdapterHelper setTypeface(int viewId, Typeface typeface) { TextView view = retrieveView(viewId); view.setTypeface(typeface); view.setPaintFlags(view.getPaintFlags() | Paint.SUBPIXEL_TEXT_FLAG); return this; } /** Apply the typeface to all the given viewIds, and enable subpixel rendering. */ public BaseAdapterHelper setTypeface(Typeface typeface, int... viewIds) { for (int viewId : viewIds) { TextView view = retrieveView(viewId); view.setTypeface(typeface); view.setPaintFlags(view.getPaintFlags() | Paint.SUBPIXEL_TEXT_FLAG); } return this; } /** * Sets the progress of a ProgressBar. * @param viewId The view id. * @param progress The progress. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setProgress(int viewId, int progress) { ProgressBar view = retrieveView(viewId); view.setProgress(progress); return this; } /** * Sets the progress and max of a ProgressBar. * @param viewId The view id. * @param progress The progress. * @param max The max value of a ProgressBar. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setProgress(int viewId, int progress, int max) { ProgressBar view = retrieveView(viewId); view.setMax(max); view.setProgress(progress); return this; } /** * Sets the range of a ProgressBar to 0...max. * @param viewId The view id. * @param max The max value of a ProgressBar. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setMax(int viewId, int max) { ProgressBar view = retrieveView(viewId); view.setMax(max); return this; } /** * Sets the rating (the number of stars filled) of a RatingBar. * @param viewId The view id. * @param rating The rating. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setRating(int viewId, float rating) { RatingBar view = retrieveView(viewId); view.setRating(rating); return this; } /** * Sets the rating (the number of stars filled) and max of a RatingBar. * @param viewId The view id. * @param rating The rating. * @param max The range of the RatingBar to 0...max. * @return The BaseAdapterHelper for chaining. */ public BaseAdapterHelper setRating(int viewId, float rating, int max) { RatingBar view = retrieveView(viewId); view.setMax(max); view.setRating(rating); return this; } /** Retrieve the convertView */ public View getView() { return convertView; } /** * Retrieve the overall position of the data in the list. * @throws IllegalArgumentException If the position hasn't been set at the construction of the this helper. */ public int getPosition() { if (position == -1) throw new IllegalStateException("Use BaseAdapterHelper constructor " + "with position if you need to retrieve the position."); return position; } @SuppressWarnings("unchecked") private T retrieveView(int viewId) { View view = views.get(viewId); if (view == null) { view = convertView.findViewById(viewId); views.put(viewId, view); } return (T) view; } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy