npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2025 – Pkg Stats / Ryan Hefner

rn-cached-image

v2.0.3

Published

CachedImage component for react-native

Downloads

8

Readme


原作者版本1.3.5,出处https://github.com/kfiroo/react-native-cached-image

为了适应RN0.49版本,做了如下改动

1、CachedImage.js中
const activityIndicatorProps = _.omit(this.props.activityIndicatorProps, ['style']);
修改为
const activityIndicatorProps = this.props.activityIndicatorProps

2、NetInfo.isConnected.addEventListener('change' 以及NetInfo.isConnected.removeEventListener('change'中的change
修改为
connectionChange 

以下内容完全来自原作者,使用方法无变化

npm version

react-native-cached-image

CachedImage component for react-native

This package is greatly inspired by @jayesbe's amazing react-native-cacheable-image but adds some functionality that we were missing when trying to handle caching images in our react-native app.

Installation

npm install react-native-cached-image --save

or

yarn add react-native-cached-image

We use react-native-fetch-blob to handle file system access in this package and it requires an extra step during the installation.
You should only have to do this once.

react-native link react-native-fetch-blob

Or, if you want to add Android permissions to AndroidManifest.xml automatically, use this one:

RNFB_ANDROID_PERMISSIONS=true react-native link react-native-fetch-blob

Network Status - Android only

Add the following line to your android/app/src/AndroidManifest.xml

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

API

This package exposes 2 modules:

  1. CachedImage - default react-native component that is a drop-in replacement for your react-native Image components
  2. ImageCacheProvider - the cache API that you can use if you need to interact with the cache outside the scope of the component, for prefetching images for example.

CachedImage

CachedImage is just like the native Image component, you can provide it with defaultSource, style, etc.
When providing source={require('/path/to/local/image')} or source={{uri: '/path/to/local/image'}} to it the image will be loaded from local source and will not be cached.
When providing source={{uri: 'https://example.com/path/to/remote/image.jpg'}} the image will be downloaded and cached on the device to subsequent requests to the same url will always result in an instant load from the local image.

<CachedImage
    source={{
        uri: 'https://example.com/path/to/your/image.jpg'
    }}
    style={styles.image}
/>
Props
  • activityIndicatorProps - props for the ActivityIndicator that is shown while the image is downloaded.
  • useQueryParamsInCacheKey - array|bool an array of keys to use from the source.uri query string or a bool value stating whether to use the entire query string or not. (default: false)
  • defaultSource - prop to display a background image while the source image is downloaded. This will work even in android, but will not display background image if there you set borderRadius on this component style prop
  • resolveHeaders - function when provided, the returned object will be used as the headers object when sending the request to download the image. (default: () => Promise.resolve({}))
  • cacheLocation - string allows changing the root directory to use for caching. The default directory is sufficient for most use-cases. Images in this directory may be purged by Android automatically to free up space. Use ImageCacheProvider.LOCATION.BUNDLE if the cached images are critical (you will have to manage cleanup manually). (default: ImageCacheProvider.LOCATION.CACHE)
  • loadingIndicator - component prop to set custom ActivityIndicator.
  • fallbackSource - prop to set placeholder image. when source.uri is null or cached failed, the fallbackSource will be display.

ImageCacheProvider

ImageCacheProvider exposes interaction with the cache layer that is used by CachedImage so you can use it to prefetch some urls in the background while you app is starting, or remove some outdated images from the cache to free some space up if needed.

const CachedImage = require('react-native-cached-image');

// CachedImage exposes ImageCacheProvider
const ImageCacheProvider = CachedImage.ImageCacheProvider;

// will add the urls to the cache so when CachedImage will try to load them
// the result will be and instant load from cache
ImageCacheProvider.cacheMultipleImages([
    'https://example.com/path/to/remote/image.jpg',
    'https://example.com/path/to/remote/other-image.png'    
]);

// clear old urls from the cache, useful when updating your app version and
// old version of the images are no longer relevant, for example
ImageCacheProvider.deleteMultipleCachedImages([
    'https://example.com/path/to/remote/image.jpg',
    'https://example.com/path/to/remote/other-image.png'
]);

type: CacheOptions

type CacheOptions = {
  useQueryParamsInCacheKey: string[]|bool; // same as the CachedImage props
  cacheGroup: string; // the directory to save cached images in, defaults to the url hostname
  cacheLocation: string; // the root directory to use for caching, corresponds to CachedImage prop of same name, defaults to system cache directory
};

ImageCacheProvider.isCacheable(url: string): bool

Returns a true if the url is cacheable, false if it isn't. Currently check if it is a remote url.

ImageCacheProvider.getCachedImagePath(url: string, options: CacheOptions): Promise<imagePath: string>

Returns a Promise that is resolved with the path to the underlying cached image file path if it exists.
Promise is rejected if the file doesn't exist.

ImageCacheProvider.cacheImage(url: string, options: CacheOptions): Promise<imagePath: string>

Will download the file from the given url and save it to the device.
Returns a Promise that is resolved with the path to the underlying cached image file path if download was successful.
Promise is rejected if the download or file write failed.

ImageCacheProvider.seedCache(local: string, url: string, options: CacheOptions): Promise

Seed the cache for a given url with a local image. Useful to avoid having to download an image when you have a local copy.

ImageCacheProvider.deleteCachedImage(url: string, options: CacheOptions): Promise

Deletes the underlying cached image for a given url.

ImageCacheProvider.cacheMultipleImages(urls: string[], options: CacheOptions): Promise

Cache a list of urls, if any of the urls is already cached will not try to download again.

ImageCacheProvider.deleteMultipleCachedImages(urls: string[], options: CacheOptions): Promise

Deletes all images from cache that were cached using the given urls, if file doesn't exist do nothing.

ImageCacheProvider.clearCache(): Promise

Deletes all cached images.

Dependencies