UrlImageViewHelper

Additional

Language
Java
Version
urlimageviewhelper-1.0.1 (May 30, 2013)
Created
Apr 13, 2011
Updated
Jun 20, 2014 (Retired)
Owner
Koushik Dutta (koush)
Contributors
linkinpark342
seanoshea
EaseTheWorld
Koushik Dutta (koush)
pedronveloso
dglinenko
cimnine
tadfisher
Scott Ferguson (scottferg)
jnugh
10
Activity
Badge
Generate
Download
Source code

Advertisement

This library has been deprecated, use ion instead:

http://github.com/koush/ion

UrlImageViewHelper

UrlImageViewHelper will fill an ImageView with an image that is found at a URL.

Sample Project

The sample will do a Google Image Search and load/show the results asynchronously.

Download

Download the latest JAR or grab via Maven:

<dependency>
    <groupId>com.koushikdutta.urlimageviewhelper</groupId>
    <artifactId>urlimageviewhelper</artifactId>
    <version>(insert latest version)</version>
</dependency>

Usage

UrlImageViewHelper will automatically download and manage all the web images and ImageViews. Duplicate urls will not be loaded into memory twice. Bitmap memory is managed by using a weak reference hash table, so as soon as the image is no longer used by you, it will be garbage collected automatically.

Usage is simple:

UrlImageViewHelper.setUrlDrawable(imageView, "http://example.com/image.png");

Want a placeholder image while it is being downloaded?

UrlImageViewHelper.setUrlDrawable(imageView, "http://example.com/image.png", R.drawable.placeholder);

Don't want to use a placeholder resource, but a drawable instead?

UrlImageViewHelper.setUrlDrawable(imageView, "http://example.com/image.png", drawable);

What if you want to preload images for snazzy fast loading?

UrlImageViewHelper.loadUrlDrawable(context, "http://example.com/image.png");

What if you only want to cache the images for a minute?

// Note that the 3rd argument "null" is an optional interstitial
// placeholder image.
UrlImageViewHelper.setUrlDrawable(imageView, "http://example.com/image.png", null, 60000);

UrlImageViewHelper is pretty smart. It can even load the photo for an Android contact if given a Contact Content Provider URI.

UrlImageViewHelper.setUrlDrawable(imageView, "content://com.android.contacts/contacts/1115", R.drawable.dummy_contact_photo);

FAQ

Does it work in list adapters when views are reused? (convertView)

Yes.

Featured Implementations

  • ROM Manager
  • Carbon
  • Let me know if you use this library, so I can add it to the list!