Flutter网络图片加载插件universal_web_image的使用

Features

• 显示HTML图像：如果必要，可以将图像显示为HTML图像。
• 自动区分SVG图像和其他图像：插件会自动识别并处理SVG图像。

Motivation

在尝试加载没有有效XHR状态200的图像时，Flutter Web应用会抛出错误，并且图像不会显示。例如：

Failed to load network image.
Image URL: https://example.com/invalidConfiguredServerImage.jpg
Trying to load an image from another domain? Find answers at:
https://flutter.dev/docs/development/platform-integration/web-images

universal_web_image 插件通过使用Web Image作为回退来解决这个问题。

Usage

示例代码

以下是一个完整的示例代码，展示了如何使用 universal_web_image 插件加载网络图片。

import 'package:flutter/material.dart';
import 'package:universal_web_image/universal_web_image.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Universal Web Image Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Universal Web Image Demo Page'),
    );
  }
}

class MyHomePage extends StatelessWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  // 424x283
  static const validImageUrl =
      'https://www.kesselheld.de/content/uploads/2018/09/durchschnittliche-heizkosten.jpg';

  // 640x300
  static const invalidImageUrl =
      'https://img.utopia.de/cH68CrxH2UEqUr8eVAWC-BCgXoU=/640x300/https://utopia.de/app/uploads/2019/02/richtig-heizen-wpb-ivan-kruk-ri-190820-1280x720.jpg';

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.start,
          children: [
            const Text(
              'Web Image with valid XHR 200 status with custom loader',
            ),
            UniversalWebImage(
              imageUrl: validImageUrl,
              customLoaderBuilder: (context) =>
                  const Center(child: CircularProgressIndicator()),
            ),
            const Text(
              'Web Image with invalid XHR 0 status',
            ),
            const UniversalWebImage(
              imageUrl: invalidImageUrl,
              width: 640,
              height: 300,
            ),
            const Text(
              'Regular image with invalid XHR 0 status',
            ),
            Image.network(
              invalidImageUrl,
              width: 640,
              height: 300,
            ),
          ],
        ),
      ),
    );
  }
}

代码说明

1. 导入依赖：

   import 'package:flutter/material.dart';
   import 'package:universal_web_image/universal_web_image.dart';
   

2. 定义主应用：

   void main() {
     runApp(const MyApp());
   }
   
   class MyApp extends StatelessWidget {
     const MyApp({super.key});
   
     @override
     Widget build(BuildContext context) {
       return MaterialApp(
         title: 'Universal Web Image Demo',
         theme: ThemeData(
           primarySwatch: Colors.blue,
         ),
         home: const MyHomePage(title: 'Universal Web Image Demo Page'),
       );
     }
   }
   

3. 定义主页：

   class MyHomePage extends StatelessWidget {
     const MyHomePage({super.key, required this.title});
   
     final String title;
   
     static const validImageUrl =
         'https://www.kesselheld.de/content/uploads/2018/09/durchschnittliche-heizkosten.jpg';
   
     static const invalidImageUrl =
         'https://img.utopia.de/cH68CrxH2UEqUr8eVAWC-BCgXoU=/640x300/https://utopia.de/app/uploads/2019/02/richtig-heizen-wpb-ivan-kruk-ri-190820-1280x720.jpg';
   
     @override
     Widget build(BuildContext context) {
       return Scaffold(
         appBar: AppBar(
           title: Text(title),
         ),
         body: Center(
           child: Column(
             mainAxisAlignment: MainAxisAlignment.start,
             children: [
               const Text(
                 'Web Image with valid XHR 200 status with custom loader',
               ),
               UniversalWebImage(
                 imageUrl: validImageUrl,
                 customLoaderBuilder: (context) =>
                     const Center(child: CircularProgressIndicator()),
               ),
               const Text(
                 'Web Image with invalid XHR 0 status',
               ),
               const UniversalWebImage(
                 imageUrl: invalidImageUrl,
                 width: 640,
                 height: 300,
               ),
               const Text(
                 'Regular image with invalid XHR 0 status',
               ),
               Image.network(
                 invalidImageUrl,
                 width: 640,
                 height: 300,
               ),
             ],
           ),
         ),
       );
     }
   }
   

关键点

• UniversalWebImage：用于加载网络图片，并自动处理无效的XHR状态。
• customLoaderBuilder：自定义加载器，可以在图片加载过程中显示一个加载指示器。
• validImageUrl 和 invalidImageUrl：分别表示有效的和无效的图片URL。

通过使用 universal_web_image 插件，你可以更方便地处理网络图片加载问题，特别是在Web平台上。希望这个示例对你有所帮助！