React-Native 之常用组件Image使用

作者: 珍此良辰 | 来源:发表于2016-10-29 17:36 被阅读6947次

前言

学习本系列内容需要具备一定 HTML 开发基础，没有基础的朋友可以先转至 HTML快速入门(一) 学习
本人接触 React Native 时间并不是特别长，所以对其中的内容和性质了解可能会有所偏差，在学习中如果有错会及时修改内容，也欢迎万能的朋友们批评指出，谢谢
文章第一版出自简书，如果出现图片或页面显示问题，烦请转至简书查看也希望喜欢的朋友可以点赞，谢谢

Image组件的常见属性

属性方法
- onLoad(function）:当图片加载成功后，回调该方法
- onLoadStart（function）:当图片开始加载的时候调用该方法
- onLoadEnd(function）:当图片加载失败回调该方法，不会管图片加载成功还是失败
- onLayout（function）:当 Image 布局发生变化会调用该方法，调用代码
```
    {nativeEvent: {layout: {x, y, width, height}}}
```
- resizeMode:缩放比例，（包含可选参数'cover', 'contain', 'stretch'）,当该图片的尺寸超过布局的尺寸时，会根据设置 Mode 进行缩放或剪裁图片
- source{uri:string}:进行标记图片引用，该参数可以为一个网络 url地址 或者一个本地路径
样式属性
- FlexBox：支持弹性盒子风格
- Transforms：支持属性动画
- backgroundcolor：背景颜色
- borderColor：边框颜色
- borderWidth：边框宽度
- borderRadius：边框圆角
- overflow：设置图片尺寸超过容器可以设置显示或隐藏('visible', 'hidden')
- tintColor：颜色设置
- opacity：设置透明度（取值范围0.0（全透明）~ 1.0（不透明））

Image组件的介绍和使用

Image 在开发中是经常接触到的组件，通过它，我们可以展示需要展示的图片资源，在 React Native 中该组件可以通过多种方式价值啊图片资源
在介绍几种加载图片资源的方式之前，先确定一下图片的样式，如下
```
    imgStyle: {
        width:100,
        height:100,
    }
    
```
- 从当前RN项目中加载图片资源，和 html 一样，我们需要将图片放到 RN 项目中，这边我创建了个 img 文件夹，里面包含了需要使用到的图片资源
  RN项目中的图片资源
  - 不设置尺寸的情况下，默认会根据图片资源的大小来展示图片
```
    {/* 不设置尺寸的情况下 */}
    <Image source={require('./img/icon.jpg')}></Image>  
```
  效果：
  
  不设置尺寸的情况下
  - 我们可以通过设置尺寸或者改变 Image 的填充模式来改变所展示的图片样式，这边就先约束宽高，后面会具体介绍怎么改变图片的填充模式
```
    {/* 设置尺寸的情况下 */}
    <Image source={require('./img/icon.jpg')} style={styles.imgStyle}></Image>
```
效果：

设置尺寸的情况下
- 加载APP中的图片资源
  - 以iOS为例，我们根据原生的开发习惯把图片放到 images.xcassets 中，这样在编译链接完成后，会将里面的图片统一打包以供使用
    iOS图片资源存放位置
  - 如果是Android的话，需要打开目录 android/app/src/res/ ，将图片按照安卓原生开发习惯将不同大小的图片方便放进四个文件夹内
    Android图片资源存放位置
  - 完成了图片的导入，最好重新运行模拟器，以确保图片已经正确打包，然后就是使用图片的时候了
```
    {/* 和上面一样，如果不预先设置尺寸的话，依旧是根据图片资源原本的大小进行展示 */}
    {/* 路径书写格式中 image! 是固定写法，后面直接加上图片的名字即可，不可加 .后缀名 */}
    <Image source={require('image!lufei')}></Image>
```
效果：

加载项目图片
- 加载来自网络的图片，图片是我在淘宝上随便拿的图片网络地址，比较大，按照默认的填充方式，会将超出的部分剪裁掉（注意：大括号内的是 uri 不是 url）
```
    {/* uri是固定写法，后面跟上图片网络URL地址的字符串即可，还有，网络图片必须设置图片的大小，否则无法显示，一般还需要配合填充方式以达到想要的效果 */}
    <Image source={{uri:'https://img.alicdn.com/tps/TB1OvT9NVXXXXXdaFXXXXXXXXXX-520-280.jpg'}} style={styles.imgStyle}></Image>
    
```
效果：

加载网络图片效果

Image组件填充效果试验场

看完了上面的内容，相信应该对 Image 的使用已经了解的差不多了吧，这里继续为各位见解 Image 的几种填充模式，改变 Image组件的填充模式，需要使用到 resizeMode属性，它包含了3个可选参数，下面就以加载网络图片为例

先加载网络图片，并设置样式

    // 导入Dimensions库
    var Dimensions = require('Dimensions');

    // 入口
    export default class TestRN extends Component {
        render() {
            return (
                <View style={styles.container}>
                <Image source={{uri:'https://img.alicdn.com/tps/TB1OvT9NVXXXXXdaFXXXXXXXXXX-520-280.jpg'}} style={styles.imgStyle}></Image>
                </View>
            );
        }
    }

    // 样式
    const styles = StyleSheet.create({
        container: {
            backgroundColor:'blue',
            flex:1,
        },

        imgStyle: {
            // 设置背景颜色
            backgroundColor:'green',
            // 设置宽度
            width:Dimensions.get('window').width,
            // 设置高度
            height:150
        }
    });

效果：

初始化效果

cover( 默认)：图片居中显示且不拉伸图片，超出的部分剪裁掉

    imgStyle: {
            // 设置背景颜色
            backgroundColor:'green',
            // 设置宽度
            width:Dimensions.get('window').width,
            // 设置高度
            height:150,
            // 设置图片填充模式
            resizeMode:'cover'
        }

效果：

cover 模式效果

contain：容器完全容纳图片，图片等比例进行拉伸

    imgStyle: {
            // 设置背景颜色
            backgroundColor:'green',
            // 设置宽度
            width:Dimensions.get('window').width,
            // 设置高度
            height:150,
            // 设置图片填充模式
            resizeMode:'contain'
        }

效果：

contain 填充效果

stretch：图片被拉伸至与容器大小一致，可能会发生变形

    imgStyle: {
            // 设置背景颜色
            backgroundColor:'green',
            // 设置宽度
            width:Dimensions.get('window').width,
            // 设置高度
            height:150,
            // 设置图片填充模式
            resizeMode:'stretch'
        }

效果：

stretch 填充效果

Image组件模拟使用场景

开发中，我们经常将图片作为背景，然后再其上面添加其他组件以丰富项目内容，让项目更美观，那在React Native中，很简单就可以做到

依旧以上面网络图片为例，但是先来修改下样式，看起来跟美观一些

    // 样式
    const styles = StyleSheet.create({
        container: {
            backgroundColor:'blue',
            flex:1,
            // 设置主轴对齐方式
            justifyContent:'center',
            // 设置侧轴对齐方式
            alignItems:'center'
    },

        imgStyle: {
            backgroundColor:'green',
            width:Dimensions.get('window').width,
            height:200,
            // 设置图片填充模式
            resizeMode:'stretch'
        }
    });

效果：

初始化效果

接下来，我们就直接在 Image组件上添加一个 Text组件

    <Image source={{uri:'https://img.alicdn.com/tps/TB1OvT9NVXXXXXdaFXXXXXXXXXX-520-280.jpg'}} style={styles.imgStyle}>
    <Text style={{marginTop:100}}>这是一张来自淘宝的图片</Text>
      </Image>

效果：

将Image组件作为背景

可以看出，Text组件确实是盖在 Image组件上，所以在React Native中，将图片作为背景就是这么简单，并不需要进行太复杂的操作

Image组件综合小项目

现在我们就结合前面的一下教程，用最通俗的方式做一个简单的QQ消息模块界面

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

    // 导入Dimensions库
    var Dimensions = require('Dimensions');

    // 入口
    export default class TestRN extends Component {
    render() {
        return (
            <View style={styles.container}>
                {/* 因为还没讲到listView,这边就用View代表Cell*/}
                <View style={styles.cellStyle}>
                    {/* 头像 */}
                    <Image source={require('./img/lufei.jpg')} style={styles.imgStyle}></Image>
                    {/* 昵称 */}
                    <Text style={styles.nameStyle}>昵称</Text>
                </View>
                {/* 分隔线 */}
                <View style={styles.lineStyle}></View>
                <View style={styles.cellStyle}>
                    {/* 头像 */}
                    <Image source={require('./img/lufei.jpg')} style={styles.imgStyle}></Image>
                    {/* 昵称 */}
                    <Text style={styles.nameStyle}>昵称</Text>
                </View>
                {/* 分隔线 */}
                <View style={styles.lineStyle}></View>
                <View style={styles.cellStyle}>
                    {/* 头像 */}
                    <Image source={require('./img/lufei.jpg')} style={styles.imgStyle}></Image>
                    {/* 昵称 */}
                    <Text style={styles.nameStyle}>昵称</Text>
                </View>
                {/* 分隔线 */}
                <View style={styles.lineStyle}></View>
            </View>
            );
        }
    }

    // 样式
    const styles = StyleSheet.create({
        container: {
            backgroundColor:'white',
            flex:1,
            // 设置换行方式
            flexWrap:'wrap'
        },

        cellStyle: {
            // 尺寸
            height:44,
            width:Dimensions.get('window').width,
            // 设置背景颜色
            backgroundColor:'white',
            // 设置主轴方向
            flexDirection:'row',
            // 设置侧轴对齐方式
            alignItems:'center'
        },

        imgStyle: {
            width:30,
            height:30,
            // 设置图片填充模式
            resizeMode:'cover',
            // 设置圆角
            borderRadius:15,
            // 设置图片位置
            marginLeft:10
        },

        nameStyle: {
            // 设置昵称位置
            marginLeft:10
        },

        lineStyle: {
            // 背景色
            backgroundColor:'black',
            // 设置尺寸
            width:Dimensions.get('window').width,
            height:1
        }

    });

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

Image组件的常见属性

属性方法
- onLoad(function）:当图片加载成功后，回调该方法
- onLoadStart（function）:当图片开始加载的时候调用该方法
- onLoadEnd(function）:当图片加载失败回调该方法，不会管图片加载成功还是失败
- onLayout（function）:当 Image 布局发生变化会调用该方法，调用代码
```
    {nativeEvent: {layout: {x, y, width, height}}}
```
- resizeMode:缩放比例，（包含可选参数'cover', 'contain', 'stretch'）,当该图片的尺寸超过布局的尺寸时，会根据设置 Mode 进行缩放或剪裁图片
- source{uri:string}:进行标记图片引用，该参数可以为一个网络 url地址 或者一个本地路径
样式属性
- FlexBox：支持弹性盒子风格
- Transforms：支持属性动画
- backgroundcolor：背景颜色
- borderColor：边框颜色
- borderWidth：边框宽度
- borderRadius：边框圆角
- overflow：设置图片尺寸超过容器可以设置显示或隐藏('visible', 'hidden')
- tintColor：颜色设置
- opacity：设置透明度（取值范围0.0（全透明）~ 1.0（不透明））

Image组件的介绍和使用

Image 在开发中是经常接触到的组件，通过它，我们可以展示需要展示的图片资源，在 React Native 中该组件可以通过多种方式价值啊图片资源
在介绍几种加载图片资源的方式之前，先确定一下图片的样式，如下
```
    imgStyle: {
        width:100,
        height:100,
    }
    
```
- 从当前RN项目中加载图片资源，和 html 一样，我们需要将图片放到 RN 项目中，这边我创建了个 img 文件夹，里面包含了需要使用到的图片资源
  RN项目中的图片资源
  - 不设置尺寸的情况下，默认会根据图片资源的大小来展示图片
```
    {/* 不设置尺寸的情况下 */}
    <Image source={require('./img/icon.jpg')}></Image>  
```
  效果：
  
  不设置尺寸的情况下
  - 我们可以通过设置尺寸或者改变 Image 的填充模式来改变所展示的图片样式，这边就先约束宽高，后面会具体介绍怎么改变图片的填充模式
```
    {/* 设置尺寸的情况下 */}
    <Image source={require('./img/icon.jpg')} style={styles.imgStyle}></Image>
```
效果：

设置尺寸的情况下
- 加载APP中的图片资源
  - 以iOS为例，我们根据原生的开发习惯把图片放到 images.xcassets 中，这样在编译链接完成后，会将里面的图片统一打包以供使用
    iOS图片资源存放位置
  - 如果是Android的话，需要打开目录 android/app/src/res/ ，将图片按照安卓原生开发习惯将不同大小的图片方便放进四个文件夹内
    Android图片资源存放位置
  - 完成了图片的导入，最好重新运行模拟器，以确保图片已经正确打包，然后就是使用图片的时候了
```
    {/* 和上面一样，如果不预先设置尺寸的话，依旧是根据图片资源原本的大小进行展示 */}
    {/* 路径书写格式中 image! 是固定写法，后面直接加上图片的名字即可，不可加 .后缀名 */}
    <Image source={require('image!lufei')}></Image>
```
效果：

加载项目图片
- 加载来自网络的图片，图片是我在淘宝上随便拿的图片网络地址，比较大，按照默认的填充方式，会将超出的部分剪裁掉（注意：大括号内的是 uri 不是 url）
```
    {/* uri是固定写法，后面跟上图片网络URL地址的字符串即可，还有，网络图片必须设置图片的大小，否则无法显示，一般还需要配合填充方式以达到想要的效果 */}
    <Image source={{uri:'https://img.alicdn.com/tps/TB1OvT9NVXXXXXdaFXXXXXXXXXX-520-280.jpg'}} style={styles.imgStyle}></Image>
    
```
效果：

加载网络图片效果

Image组件填充效果试验场

看完了上面的内容，相信应该对 Image 的使用已经了解的差不多了吧，这里继续为各位见解 Image 的几种填充模式，改变 Image组件的填充模式，需要使用到 resizeMode属性，它包含了3个可选参数，下面就以加载网络图片为例

先加载网络图片，并设置样式

    // 导入Dimensions库
    var Dimensions = require('Dimensions');

    // 入口
    export default class TestRN extends Component {
        render() {
            return (
                <View style={styles.container}>
                <Image source={{uri:'https://img.alicdn.com/tps/TB1OvT9NVXXXXXdaFXXXXXXXXXX-520-280.jpg'}} style={styles.imgStyle}></Image>
                </View>
            );
        }
    }

    // 样式
    const styles = StyleSheet.create({
        container: {
            backgroundColor:'blue',
            flex:1,
        },

        imgStyle: {
            // 设置背景颜色
            backgroundColor:'green',
            // 设置宽度
            width:Dimensions.get('window').width,
            // 设置高度
            height:150
        }
    });

效果：

初始化效果

cover( 默认)：图片居中显示且不拉伸图片，超出的部分剪裁掉

    imgStyle: {
            // 设置背景颜色
            backgroundColor:'green',
            // 设置宽度
            width:Dimensions.get('window').width,
            // 设置高度
            height:150,
            // 设置图片填充模式
            resizeMode:'cover'
        }

效果：

cover 模式效果

contain：容器完全容纳图片，图片等比例进行拉伸

    imgStyle: {
            // 设置背景颜色
            backgroundColor:'green',
            // 设置宽度
            width:Dimensions.get('window').width,
            // 设置高度
            height:150,
            // 设置图片填充模式
            resizeMode:'contain'
        }

效果：

contain 填充效果

stretch：图片被拉伸至与容器大小一致，可能会发生变形

    imgStyle: {
            // 设置背景颜色
            backgroundColor:'green',
            // 设置宽度
            width:Dimensions.get('window').width,
            // 设置高度
            height:150,
            // 设置图片填充模式
            resizeMode:'stretch'
        }

效果：

stretch 填充效果

Image组件模拟使用场景

开发中，我们经常将图片作为背景，然后再其上面添加其他组件以丰富项目内容，让项目更美观，那在React Native中，很简单就可以做到

依旧以上面网络图片为例，但是先来修改下样式，看起来跟美观一些

    // 样式
    const styles = StyleSheet.create({
        container: {
            backgroundColor:'blue',
            flex:1,
            // 设置主轴对齐方式
            justifyContent:'center',
            // 设置侧轴对齐方式
            alignItems:'center'
    },

        imgStyle: {
            backgroundColor:'green',
            width:Dimensions.get('window').width,
            height:200,
            // 设置图片填充模式
            resizeMode:'stretch'
        }
    });

效果：

初始化效果

接下来，我们就直接在 Image组件上添加一个 Text组件

    <Image source={{uri:'https://img.alicdn.com/tps/TB1OvT9NVXXXXXdaFXXXXXXXXXX-520-280.jpg'}} style={styles.imgStyle}>
    <Text style={{marginTop:100}}>这是一张来自淘宝的图片</Text>
      </Image>

效果：

将Image组件作为背景

可以看出，Text组件确实是盖在 Image组件上，所以在React Native中，将图片作为背景就是这么简单，并不需要进行太复杂的操作

Image组件综合小项目

现在我们就结合前面的一下教程，用最通俗的方式做一个简单的QQ消息模块界面单元格

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

    // 导入Dimensions库
    var Dimensions = require('Dimensions');

    // 入口
    export default class TestRN extends Component {
    render() {
        return (
            <View style={styles.container}>
                {/* 因为还没讲到listView,这边就用View代表Cell*/}
                <View style={styles.cellStyle}>
                    {/* 头像 */}
                    <Image source={require('./img/lufei.jpg')} style={styles.imgStyle}></Image>
                    {/* 昵称 */}
                    <Text style={styles.nameStyle}>昵称</Text>
                </View>
                {/* 分隔线 */}
                <View style={styles.lineStyle}></View>
                <View style={styles.cellStyle}>
                    {/* 头像 */}
                    <Image source={require('./img/lufei.jpg')} style={styles.imgStyle}></Image>
                    {/* 昵称 */}
                    <Text style={styles.nameStyle}>昵称</Text>
                </View>
                {/* 分隔线 */}
                <View style={styles.lineStyle}></View>
                <View style={styles.cellStyle}>
                    {/* 头像 */}
                    <Image source={require('./img/lufei.jpg')} style={styles.imgStyle}></Image>
                    {/* 昵称 */}
                    <Text style={styles.nameStyle}>昵称</Text>
                </View>
                {/* 分隔线 */}
                <View style={styles.lineStyle}></View>
            </View>
            );
        }
    }

    // 样式
    const styles = StyleSheet.create({
        container: {
            backgroundColor:'white',
            flex:1,
            // 设置换行方式
            flexWrap:'wrap'
        },

        cellStyle: {
            // 尺寸
            height:44,
            width:Dimensions.get('window').width,
            // 设置背景颜色
            backgroundColor:'white',
            // 设置主轴方向
            flexDirection:'row',
            // 设置侧轴对齐方式
            alignItems:'center'
        },

        imgStyle: {
            width:30,
            height:30,
            // 设置图片填充模式
            resizeMode:'cover',
            // 设置圆角
            borderRadius:15,
            // 设置图片位置
            marginLeft:10
        },

        nameStyle: {
            // 设置昵称位置
            marginLeft:10
        },

        lineStyle: {
            // 背景色
            backgroundColor:'black',
            // 设置尺寸
            width:Dimensions.get('window').width,
            height:1
        }

    });

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

效果：

简单QQ消息界面单元格

Image组件的使用就先简单介绍到这里，在后续的文章中，会在实际的开发场景中带大家更多更细致地讲解 Image组件,如果你觉得哪里写得不好或者有误，麻烦留言或者用邮箱的方式联系我，当然遇到问题也可以，最后如果喜欢我的文章，还请点个赞并关注，读者的肯定是对我们笔者最大的鼓励，谢谢！

网友评论

宁夏灼雪__:文章很好，跟着学习感觉很实用，文章内容重复啦
珍此良辰:@宁夏灼雪__ 可以获取到的，记得引用组件
宁夏灼雪__:<Image source={require('image!lufei')}></Image> 这个方式好像获取不到
pengxiaochao:写的不错，成功使用image 控件，fuck 啊，原来是属性对不，不出来，调试不太会用
e3e5895f2b06:如何把base64字节码转为图片放入image控件
Andy_Sun:@安尽燃请问怎么解决的啊，我也遇到这个问题了……
e3e5895f2b06: @雨泽Forest 嗯，已解决
珍此良辰:@安尽燃这个网上一大堆啊，自己搜索一下就可以了
2015哈哈哈:特别好通俗易懂！
珍此良辰:@伟伟and莉莉感谢支持
58a79004f062:请问本地路径的uri要怎么写，比如用app生成了一张图片，要怎么读出来
58a79004f062:@雨泽Forest 嗯，谢谢，我之前也是{{uri:'file:///tfsd/icon.png'}}这样写的时候没指定尺寸，结果没显示，后来指定尺寸后就可以显示出来了
珍此良辰:@风刀霜剑_80ac 这个要看情况了，如果图片在res的drawable目录下，直接这样写 source={{uri:'icon'}} （记住uri对应的图片名称是不包含后缀的）；如果要加载手机存储卡上的图片资源，假设我现在要加载tfsd根目录下的icon.png。直接这样写source={{uri:'file:///tfsd/icon.png'}} （格式：file://加上文件的路径/图片名.后缀）注：需要加入对应的权限！但是一般如果确定是加载本地图片的话，使用require即可。
7d6c86571e28:这么好的文章竟然没人点赞！
珍此良辰:感谢支持！

React-Native 之常用组件Image使用

前言

Image组件的常见属性

Image组件的介绍和使用

Image组件填充效果试验场

Image组件模拟使用场景

Image组件综合小项目

Image组件的常见属性

Image组件的介绍和使用

Image组件填充效果试验场

Image组件模拟使用场景

Image组件综合小项目

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

React-Native

React Native

技术分享

React-Native 之 常用组件Image使用

前言

Image组件的常见属性

Image组件的介绍和使用

Image组件填充效果试验场

Image组件模拟使用场景

Image组件综合小项目

Image组件的常见属性

Image组件的介绍和使用

Image组件填充效果试验场

Image组件模拟使用场景

Image组件综合小项目

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

React-Native

React Native

技术分享

React-Native 之常用组件Image使用