Flutter中,可以通过Image组件来加载并显示图片,Image的数据源可以是asset、文件、内存以及网络。
- ImageProvider
ImageProvider是一个抽象类,主要定义了图片数据获取的接口load(),从不同的数据源获取图片需要实现不同的ImageProvider ,如AssetImage是实现了从Asset中加载图片的ImageProvider,而NetworkImage实现了从网络加载图片的ImageProvider。可以自行查阅文档ImageProvider
1.从asset中加载图片
在工程根目录下创建一个文件夹,并将图片拷贝到文件夹。在pubspec.yaml中的flutter部分添加如下内容:
assets:
- assets/images/avatar.png
然后执行flutter pub get
。
ps:yaml文件对缩进严格,所以必须严格按照每一层两个空格的方式进行缩进,此处assets前面应有两个空格。笔者习惯创建两层文件夹assets放图片资源、字体资源等,images专门放图片资源,所以在pubspec.yaml中配置assets/images/avatar.png
加载图片代码示例如下:
class AssetImageDefault1 extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Image(
image: AssetImage('assets/images/avatar.png'),
width: 200,
height: 200,
alignment: Alignment.center,
);
}
}
Image也提供了一个快捷的构造函数Image.asset用于显示图片,代码示例如下:
class ImageAssetDefault2 extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Image.asset(
'assets/images/avatar.png',
width: 200,
height: 200,
alignment: Alignment.center,
);
}
}
运行上面两个示例,效果图如下:
如果加载时报错找不到图片资源,有可能是两个原因:
1.pubspec.yaml中书写不规范。不规范的缩进和字符都可能导致配置的内容不生效。要注意yaml的一个缩进是2个空格。如下图所示:
2.代码中的图片相对路径要和工程中实际路径不一致。例如:项目flutter_demo/assets/images/demo.png,引用路径:
AssetImage('assets/images/demo.png')
2.从网络加载图片
代码示例如下:
class ImageNetWorkDefault1 extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Image(
image: NetworkImage(
'https://flutter.github.io/assets-for-api-docs/assets/widgets/owl.jpg'),
width: 200,
height: 200,
alignment: Alignment.center,
);
}
}
Image也提供了一个快捷的构造函数Image.network用于加载网络图片,代码示例如下:
class ImageNetWorkDefault2 extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Image.network(
'https://flutter.github.io/assets-for-api-docs/assets/widgets/owl-2.jpg',
width: 200,
height: 200,
);
}
}
代码运行效果图如下:
3.参数
Image在显示图片时定义了一系列参数,通过这些参数可以控制图片的显示外观、大小、混合效果等。Image的主要参数如下:
const Image({
...
this.width, // 图片的宽
this.height, // 图片高度
this.color, // 图片的混合色值
this.colorBlendMode, // 混合模式
this.fit,// 缩放模式
this.alignment = Alignment.center, // 对齐方式
this.repeat = ImageRepeat.noRepeat, // 重复方式
...
})
- width height
用于设置图片的宽、高,当不指定宽高时,图片会根据当前父容器的限制,尽可能的显示其原始大小,如果只设置width、height的其中一个,那么另一个属性默认会按比例缩放,可以通过fit属性来指定适应规则。 - fit
该属性用于在图片的显示空间和图片本身大小不同时指定图片的适应模式。适应模式是在BoxFit中定义,它是一个枚举类型,有如下值:
fill:会拉伸填充满显示空间,图片本身长宽比会发生变化,图片会变形。
cover:会按图片的长宽比放大后居中填满显示空间,图片不会变形,超出显示空间部分会被剪裁。
contain:图片的默认适应规则,图片会在保证图片本身长宽比不变的情况下缩放以适应当前显示空间,图片不会变形。
fitWidth:图片的宽度会缩放到显示空间的宽度,高度会按比例缩放,然后居中显示,图片不会变形,超出显示空间部分会被剪裁。
fitHeight:图片的高度会缩放到显示空间的高度,宽度会按比例缩放,然后居中显示,图片不会变形,超出显示空间部分会被剪裁。
none:图片没有适应策略,会在显示空间内显示图片,如果图片比显示空间大,则显示空间只会显示图片中间部分。
下面例子是对一个宽高相同的图片应用不同的fit值,代码示例如下:
class FitImageDemo extends StatelessWidget {
final imageName = 'assets/images/avatar.png';
@override
Widget build(BuildContext context) {
return SingleChildScrollView(
child: Column(
children: <Image>[
Image.asset(
imageName,
height: 50,
width: 50,
fit: BoxFit.fill,
),
Image.asset(
imageName,
height: 50,
width: 50,
fit: BoxFit.contain,
),
Image.asset(
imageName,
width: 100,
height: 50,
fit: BoxFit.cover,
),
Image.asset(
imageName,
width: 100,
height: 50,
fit: BoxFit.fitWidth,
),
Image.asset(
imageName,
width: 100,
height: 50,
fit: BoxFit.fitHeight,
),
Image.asset(
imageName,
width: 100,
height: 50,
fit: BoxFit.scaleDown,
),
Image.asset(
imageName,
width: 100,
height: 50,
fit: BoxFit.none,
),
].map((e) {
return Row(
children: <Widget>[
Padding(
padding: EdgeInsets.all(16.0),
child: SizedBox(
width: 100,
child: e,
),
),
Text(e.fit.toString()),
],
);
}).toList(),
),
);
}
}
代码运行效果图如下:
- color colorBlendMode
在图片绘制时可以对每一个像素进行颜色混合处理,color指定混合色,colorBlendMode指定混合模式,代码示例:
Image.asset(
'assets/images/avatar.png',
width: 100,
color: Colors.blue,
colorBlendMode: BlendMode.difference,
),
运行效果如下:
- repeat
当图片本身大小小于显示空间时,指定图片的重复规则。代码示例如下:
Image.asset(
'assets/images/avatar.png',
width: 100,
height: 200,
repeat: ImageRepeat.repeatY,
),
代码运行效果图如下:
4.实现圆角图像
实现圆角图像有多种方式。
- CircleAvatar
CircleAvatar可以实现圆角头像,也可以添加一个子Widget。源码如下:
const CircleAvatar({
Key key,
this.child, // 子Widget
this.backgroundColor, // 背景颜色
this.backgroundImage, // 背景图像
this.foregroundColor, // 前景颜色
this.radius, // 半径
this.minRadius, // 最小半径
this.maxRadius, // 最大半径
})
代码示例如下:
class CircleAvatarImage extends StatelessWidget {
@override
Widget build(BuildContext context) {
return CircleAvatar(
radius: 100,
backgroundImage: NetworkImage(
'https://flutter.github.io/assets-for-api-docs/assets/widgets/owl.jpg'),
child: Container(
alignment: Alignment.center,
width: 100,
height: 100,
child: Text('猫头鹰'),
),
);
}
}
运行效果图如下:
- ClipOval
ClipOval也可以实现圆角头像,通常是在只有头像时使用。代码示例如下:
class ClipOvalImage extends StatelessWidget {
@override
Widget build(BuildContext context) {
return ClipOval(
child: Image.network(
'https://flutter.github.io/assets-for-api-docs/assets/widgets/owl-2.jpg',
width: 100,
height: 100,
),
);
}
}
运行效果图如下:
- ClipRRect
ClipRRect用于实现圆角效果,可以设置圆角的大小。代码示例如下:
class ClipRRectImage extends StatelessWidget {
@override
Widget build(BuildContext context) {
return ClipRRect(
borderRadius: BorderRadius.circular(20),
child: Image.network(
'https://tva1.sinaimg.cn/large/006y8mN6gy1g7aa03bmfpj3069069mx8.jpg',
width: 100,
height: 100,
),
);
}
}
运行效果图如下:
5.加载网络图片时显示占位图
加载网络图片时显示占位图可以用FadeInImage
,部分源码如下:
const FadeInImage({
@required this.placeholder,
@required this.image,
this.fadeOutDuration = const Duration(milliseconds: 300),
this.fadeInDuration = const Duration(milliseconds: 700),
this.width,
this.height,
...
})
/// Image displayed while the target [image] is loading.
final ImageProvider placeholder;
/// The target image that is displayed once it has loaded.
final ImageProvider image;
- placeholder
默认显示的占位图 - image
真正显示的图片 - fadeOutDuration fadeOutDuration
placeholder消失image显示的过程有一个淡进淡出,fadeOutDuration和fadeOutDuration就是设置淡进淡出的时间,不想那个要这种效果将Duration设置1毫秒,不可以设置为0。
代码示例如下:
class FadeImageDemo extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Center(
child: FadeInImage(
placeholder: AssetImage('assets/images/avatar.png'),
image: NetworkImage(
'https://flutter.github.io/assets-for-api-docs/assets/widgets/owl-2.jpg'),
fadeInDuration: Duration(milliseconds: 1),
fadeOutDuration: Duration(milliseconds: 1),
width: 200,
height: 200,
),
);
}
}
但是这种方法没有缓存每次都需要一段时间加载网络图片,cached_network_image 这个库实现了图片缓存加载和占位图效果,可自行查阅文档。
网友评论