从零学React Native之08Image组件

开发过程中,几乎每个项目都会用到图片.
RN就是通过Image组件显示图片。既可以加载网络图片,也可以加载本地资源图片。
Image组件必须在样式中声明图片的款和高。如果没有声明，则图片将不会被呈现在界面上。

网络图片加载

加载网络图片非常简单，直接上代码：
修改index.ios.js或者inde.android.js

import React,{ Component } from 'react';
import {
    AppRegistry,StyleSheet,View,Image
} from 'react-native';

var imageAddress = 'http://qq.111cn.net/uploads/allimg/140712/22020H9C-22.jpg';
class AwesomeProject extends Component {
    render() {
        return (
            //根View
            <View style={styles.container}>
                <Image style={styles.imageStyle}
                       source={{uri:imageAddress}}/>
            </View>
        );
    }
}
const styles = StyleSheet.create({
    container: {   //根View样式
        flex: 1,justifyContent: 'center',alignItems: 'center',backgroundColor: '#F5FCFF'
    },imageStyle: {
        width:100,height:100
    }
});

AppRegistry.registerComponent('AwesomeProject',() => AwesomeProject);

运行结果:

本地图片加载

在RN开发中,需要预先加载静态的图片资源,如下，其中需要在项目目录下创建image文件夹,里面放置big_star.png。

class AwesomeProject extends Component {
    render() {
        return (
            //根View
            <View style={styles.container}>
                <Image style={styles.imageStyle}
                       source={require('./image/big_star.png')}/>
            </View>
        );
    }
}

require等同于使用了var声明了一个变量,等同于在代码顶部预先加载了图片资源.

注意，下面代码运行的时候就会报错

var imageAddress = './image/big_star.png'; //运行阶段赋值 
class AwesomeProject extends Component {
    //require 在编辑阶段就会处理 
    render() {
        return (
            //根View
            <View style={styles.container}>
                <Image style={styles.imageStyle}
                       source={require({imageAddress})}/>
            </View>
        );
    }
}

在RN开发中,不允许使用字符串变量来指定需要预先加载的图片的名称.因为React Native在编译代码时处理所有的require声明,还不是在运行时动态的处理,而，var在运行时赋值,所以不能动态加载图片资源. 就会报下面的错误:

resizeMode

上面我们说了,Image组件必须在样式中声明图片的款和高。如果没有声明，则图片将不会被呈现在界面上。
我们一般将Image定义的宽和高乘以当前运行环境的像素密度称为Image的实际宽高.当Image的实际宽、高与图片的实际宽、高不符时,视图片样式定义中resizeMode的取值不同而分为三种情况,三个取值分别是: contain,cover和stretch.默认值是cover.

cover模式只求在显示比例不失真的情况下填充整个显示区域。可以对图片进行放大或者缩小，超出显示区域的部分不显示，也就是说，图片可能部分会显示不了。
contain模式是要求显示整张图片,可以对它进行等比缩小,图片会显示完整,可能会露出Image控件的底色。如果图片宽高都小于控件宽高，则不会对图片进行放大。
stretch模式不考虑保持图片原来的宽,高比.填充整个Image定义的显示区域,这种模式显示的图片可能会畸形和失真。
center模式,9月11号的0.33版本才支持，contain模式基础上支持等比放大。

来看下例子，修改上面的代码,定义三个相同大小的Image控件引入同一张图片，指定不同的resizeMode。

class AwesomeProject extends Component {
    componentWillMount() {
        //预加载静态资源
        this.image=require('./image/meinv.jpg');
    }
    render() {
        return (
            //根View
            <View style={styles.container}>
                <Image style={[styles.imageStyle,{resizeMode:'cover'}]}
                       source={this.image}/>
                <Image style={[styles.imageStyle,{resizeMode:'contain'}]}
                       source={this.image}/>
                <Image style={[styles.imageStyle,{resizeMode:'stretch'}]}
                       source={this.image}/>
            </View>
        );
    }
}

const styles = StyleSheet.create({
    container: {   //根View样式
        flex: 1,backgroundColor: 'grey'
    },imageStyle: {
        width:150,height:150,margin:5,backgroundColor:'white'
    }
});

看看运行效果:

resizeMode还可以定义在属性上，比style中的优先级要高:

 <Image  style={{height:200,width:200}} resizeMode={Image.resizeMode.cover} source={this.image}/>

看到上面三个模式,可以发现原生的Image控件无法实现等比放大后无丢失显示，我们需要自定义区实现，大家可以参考我的另一篇文章 React Native等比放大不丢失图片

其它样式

虽然Image组件不是从View组件继承而来的,但是它支持了绝大多数View中的样式键,除了这些还有额外的一些.
1. tintColor是IOS平台专有属性,颜色类型,可以让图片中的非透明像素部分有一种被染色的效果.
2. overlayColor是Android平台的专有属性,颜色类型. Android平台在某些特殊情况无法通过borderRadius实现圆角效果,这时需要使用overlayColor属性,强行将需要圆角的部分使用指定的颜色填充,从而实现圆角效果.

回调函数

Image也支持onLayout回调函数,与View组件的onLayout函数类似
当我们通过Image组件加载网络图片时,可以设置onLoadStart,onLoadEnd,onLoad三个属性来指定在开始读取与读取结束时所需要进行的函数处理. onLoad只有成功读取图片调用,而onLoadEnd无论成功与失败,都会调用。

更多精彩请关注微信公众账号likeDev,公众账号名称：爱上Android。