React Native 之组件Image

一个用于显示图片的React组件,类似于iOS中UIImage控件,该组件可以通过多种方式加载图片资源,包括网络图片、静态资源、临时的本地图片、以及本地磁盘上的图片。

一、Image组件加载图片的方式

(1)从当前JS项目中加载图片

<Image source={require('./图片路径')}/>

该图片资源文件的查找和JS模块相似,该会根据填写的图片路径相对于当前的js文件路径进行搜索。此外,React Naive的Packager会根据平台选择相应的文件,例如:my_icon.ios.pngmy_icon.android.png两个文件(命名方式android或者ios),会分别根据android或者ios平台选择相应的文件。

(2)加载原生项目中的图片

<Image source={{uri: '图片名字'}} />

使用已经打包在APP中的图片资源(例如:xcode asset文件夹以及Android drawable文件夹),会自动根据机子的型号去加载对应的图片资源。

(3)加载来自网络的图片

<Image source={{uri:'图片的URL'}}/>

(4)设置图片为背景

<Image source={{uri:'图片的URL'}} >
<Text>
背景图片
</Text>
</Image>

二、Image的属性

(1)resizeMode

enum('cover', 'contain', 'stretch', 'repeat', 'center')

决定当组件尺寸和图片尺寸不成比例的时候如何调整图片的大小。

cover: 在保持图片宽高比的前提下缩放图片,直到宽度和高度都大于等于容器视图的尺寸(如果容器有padding内衬的话,则相应减去)。译注:这样图片完全覆盖甚至超出容器,容器中不留任何空白。

contain: 在保持图片宽高比的前提下缩放图片,直到宽度和高度都小于等于容器视图的尺寸(如果容器有padding内衬的话,则相应减去)。译注:这样图片完全被包裹在容器中,容器中可能留有空白

stretch: 拉伸图片且不维持宽高比,直到宽高都刚好填满容器。

repeat: 重复平铺图片直到填满容器。图片会维持原始尺寸。仅iOS可用。

center: 居中不拉伸。

(2)defaultSource(ios)

{uri: string, width: number, height: number, scale: number}, number

在读取图片时默认显示的加载提示图片

uri - 是一个表示图片的资源标识的字符串,它可以是一个http地址或是一个本地文件路径(使用require(相对路径)来引用)。
width, height - 如果你知道图片的尺寸,那么可以在这里指定。这一尺寸会被用作<Image/>组件的默认尺寸。
scale - 图片的缩放系数。默认是1.0,意味着每一个图片像素都对应一个设备独立像素(DIP)。
number - 本地图片引用语法require('./image.jpg')所返回的内部资源id。

(3)blurRadius

number blurRadius(模糊半径):为图片添加一个指定半径的模糊滤镜。

三、Image的方法

onLayout(function)
当Image布局发生改变的,会进行调用该方法,调用的代码为:{nativeEvent: {layout: {x, y, width, height}}}.

onLoad (function)
当图片加载成功之后,回调该方法

onLoadEnd (function)
当图片加载失败回调该方法,该不会管图片加载成功还是失败

onLoadStart (function)
当图片开始加载的时候调用该方法

onError (function)ios
当加载错误的时候调用此回调函数,参数为{nativeEvent: {error}}

onPartialLoad (function)ios
如果图片本身支持逐步加载,则逐步加载的过程中会调用此方法。“逐步加载”的具体定义与具体的标准和实现有关。

onProgress (function)ios
在加载过程中不断调用,参数为{nativeEvent: {loaded, total}}

Demo


var NetworkImageExample = React.createClass({
getInitialState: function() {
  return {
    error: false,
    loading: false,
    progress: 0
    };
},
render: function() {
var loader = this.state.loading ?
<View style={styles.progress}>
     <Text>{this.state.progress}%</Text>
     <ActivityIndicator style={{marginLeft:5}} />
 </View> : null;
return this.state.error ?
    <Text>{this.state.error}</Text> :
        <Image
             source={this.props.source}
             style={[styles.base, {overflow: 'visible'}]}
             onLoadStart={(e) => this.setState({loading: true})}
             onError={(e) => this.setState({error: e.nativeEvent.error, loading: false})}
             onProgress={(e) => this.setState({progress: Math.round(100 * e.nativeEvent.loaded / e.nativeEvent.total)})}
             onLoad={() => this.setState({loading: false, error: false})}>
        {loader}
    </Image>;
}
});
<NetworkImageExample source={{uri: 'https://TYPO_ERROR_facebook.github.io/react/img/logo_og.png'}} />
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,657评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,662评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,143评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,732评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,837评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,036评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,126评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,868评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,315评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,641评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,773评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,470评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,126评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,859评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,095评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,584评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,676评论 2 351

推荐阅读更多精彩内容