Skip to content
View AlecShanda's full-sized avatar

Block or report AlecShanda

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
AlecShanda/README.md

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!

Pinned Loading

  1. AlecShanda AlecShanda Public

    AlecShanda

    Java

  2. BeerJudge BeerJudge Public

    Text and XML versions of the Beer Judge Certification Program 2015 style guidelines

    JavaScript

  3. GCSbucket GCSbucket Public

    Serverless solution to automatically load files to BigQuery when written to a GCS bucket

    CSS

  4. pocketSprite pocketSprite Public

    SDK for programming apps for the PocketSprite

    JavaScript