flutter学习-day23-使用extended_image处理图片的加载和操作

2023-12-29 14:14:43

1. 介绍

在 Flutter 的开发过程中,经常会遇到图片的显示和加载处理,通常显示一个图片,都有很多细节需要处理,比如图片的加载、缓存、错误处理、图片的压缩、图片的格式转换等,如果每个地方都手动处理,就太麻烦了,这时候就可以使用糖果大佬的插件 extended_image,它是官方 Image 的扩展三方库,不但支持图片加载以及失败显示,缓存网络图片,缩放拖拽图片,图片浏览等,还支持滑动退出页面,编辑图片(裁剪旋转翻转),保存,绘制自定义效果等功能。

效果图:
效果图

2. 属性介绍

属性描述
url网络请求地址required
key唯一标识符-
semanticLabel语义标签-
excludeFromSemantics是否排除语义false
width宽度-
height高度-
color颜色-
opacity透明度动画-
colorBlendMode颜色混合模式-
fit图片适应方式-
alignment对齐方式Alignment.center
repeat图片重复方式ImageRepeat.noRepeat
centerSlice九宫格切片区域-
matchTextDirection是否匹配文本方向false
gaplessPlayback是否无缝播放false
filterQuality滤镜质量FilterQuality.low
loadStateChanged图片加载状态回调Function
shape盒子形状-
border盒子边框-
borderRadius圆角半径-
clipBehavior裁剪行为Clip.antiAlias
enableLoadState是否启用加载状态true
beforePaintImage图片绘制前回调-
afterPaintImage图片绘制后回调-
mode扩展图片模式(默认/手势/编辑)ExtendedImageMode.none
enableMemoryCache是否启用内存缓存true
clearMemoryCacheIfFailed加载失败时是否清除内存缓存true
onDoubleTap双击事件回调-
initGestureConfigHandler初始化手势配置回调-
enableSlideOutPage是否启用滑动退出页面false
constraints约束条件-
cancelToken用于取消请求的 TokenCancellationToken()
retries请求尝试次数3
timeLimit请求超时时间-
headers请求头-
cache是否缓存true
scale图片缩放比例1.0
timeRetry请求重试间隔milliseconds: 100
extendedImageEditorKey扩展图片编辑器键-
initEditorConfigHandler初始化编辑器配置回调-
heroBuilderForSlidingPage滑动退出页面时的英雄构建器-
clearMemoryCacheWhenDispose销毁时是否清除内存缓存false
handleLoadingProgress是否处理加载进度false
extendedImageGestureKey扩展图片手势键-
cacheWidth缓存宽度-
cacheHeight缓存高度-
isAntiAlias是否开启抗锯齿false
cacheKey缓存键-
printError是否打印错误信息true
compressionRatio压缩比例-
maxBytes最大字节数-
cacheRawData是否缓存原始数据false
imageCacheName图片缓存名称-
cacheMaxAge缓存最大寿命-
layoutInsets布局插入区域EdgeInsets.zero

3. 使用

更详细的使用方式,请参考extended_image 文档,本例子只针对图片的加载、成功、失败的处理以及放大查看。

ExtendedImage.network(
  imagePath,
  width: double.infinity,
  fit: BoxFit.fitHeight,
  cache: true,
  mode: ExtendedImageMode.gesture,
  initGestureConfigHandler: (state) {
    return GestureConfig(
      // 缩放最小值
      minScale: 0.8,
      // 缩放动画最小值 当缩放结束时回到 minScale 值
      animationMinScale: 0.8,
      // 缩放最大值
      maxScale: 2.0,
      // 缩放动画最大值 当缩放结束时回到 maxScale 值
      animationMaxScale: 3.5,
      // 缩放拖拽速度
      speed: 1.0,
      // 拖拽惯性速度
      inertialSpeed: 100.0,
      initialScale: 1.0,
      // 是否使用 ExtendedImageGesturePageView 展示图片
      inPageView: false,
      // 当图片的初始化缩放大于 1.0 的时候,根据相对位置初始化图片
      initialAlignment: InitialAlignment.center
    );
  }/// 加载状态回调
  loadStateChanged: (ExtendedImageState state) {
    switch (state.extendedImageLoadState) {
      /// 加载中
      case LoadState.loading:
        // 自己写的加载中的Loading组件
        return LoadWait();

      /// 加载成功
      case LoadState.completed:
        return state.completedWidget;

      /// 加载失败
      case LoadState.failed:
        // 自己写的加载失败的组件 并且把重试的回调传递过去
        return LoadFailed(callback: state.reLoadImage);
    }
  }
)

本次分享就到这儿啦,我是鹏多多,如果您看了觉得有帮助,欢迎评论,关注,点赞,转发,我们下次见~

往期文章

个人主页

文章来源:https://blog.csdn.net/pdd11997110103/article/details/135287226
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。