Flutter图片模糊预览插件blurhash_web的使用

Flutter图片模糊预览插件blurhash_web的使用

blurhash_webblurhash 插件的 Web 实现版本,用于在 Web 平台上生成和显示模糊图像预览。它可以帮助开发者在加载真实图片之前,先显示一个低分辨率的模糊占位图,从而提升用户体验。

使用方法

1. 添加依赖

首先,在你的 pubspec.yaml 文件中添加 blurhash 依赖(blurhash_web 已包含在其中):

dependencies:
  blurhash: ^x.x.x

然后运行以下命令安装依赖:

flutter pub get

2. 生成 BlurHash

BlurHash 的生成需要一张真实的图片。你可以使用工具生成 BlurHash 字符串,或者使用代码动态生成。以下是使用 blurhash 插件生成 BlurHash 的示例:

import 'package:blurhash/blurhash.dart';

void main() {
  // 假设你有一张图片的 Base64 数据
  String imageBase64 = "your_image_base64_data_here";

  // 生成 BlurHash
  BlurHash.fromImage(imageBase64).then((blurHash) {
    print('Generated BlurHash: ${blurHash.hash}');
  });
}

3. 在 Web 上显示 BlurHash 和真实图片

以下是一个完整的示例,展示如何在 Web 上使用 blurhash_web 插件来显示模糊预览和真实图片:

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

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('BlurHash Web Example'),
        ),
        body: Center(
          child: BlurHashWebExample(),
        ),
      ),
    );
  }
}

class BlurHashWebExample extends StatefulWidget {
  [@override](/user/override)
  _BlurHashWebExampleState createState() => _BlurHashWebExampleState();
}

class _BlurHashWebExampleState extends State<BlurHashWebExample> {
  String _blurHash = ''; // 存储生成的 BlurHash
  String _imageUrl = ''; // 存储真实图片的 URL

  [@override](/user/override)
  void initState() {
    super.initState();

    // 模拟从网络获取图片 Base64 数据并生成 BlurHash
    Future.delayed(Duration(seconds: 1), () async {
      String imageBase64 = await fetchImageBase64(); // 获取图片 Base64 数据
      BlurHash.fromImage(imageBase64).then((blurHash) {
        setState(() {
          _blurHash = blurHash.hash; // 保存生成的 BlurHash
        });
      });
    });

    // 模拟从网络获取真实图片的 URL
    Future.delayed(Duration(seconds: 2), () {
      setState(() {
        _imageUrl = 'https://via.placeholder.com/300'; // 替换为实际图片 URL
      });
    });
  }

  // 模拟从网络获取图片 Base64 数据
  Future<String> fetchImageBase64() async {
    // 返回一张图片的 Base64 数据
    return "your_image_base64_data_here";
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        if (_blurHash.isNotEmpty)
          Container(
            width: 300,
            height: 300,
            child: BlurHash(
              hash: _blurHash,
              image: _imageUrl,
              duration: Duration(milliseconds: 800),
            ),
          ),
        SizedBox(height: 20),
        if (_imageUrl.isNotEmpty)
          Text(
            '真实图片加载完成!',
            style: TextStyle(fontSize: 18),
          ),
      ],
    );
  }
}

更多关于Flutter图片模糊预览插件blurhash_web的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter图片模糊预览插件blurhash_web的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


blurhash_web 是一个用于在 Flutter Web 应用中生成和显示模糊图片预览的插件。它基于 BlurHash 算法,可以在图片加载完成之前显示一个模糊的占位符,从而提升用户体验。

安装

首先,你需要在 pubspec.yaml 文件中添加 blurhash_web 依赖:

dependencies:
  flutter:
    sdk: flutter
  blurhash_web: ^1.0.0

然后运行 flutter pub get 来安装依赖。

使用

  1. 导入包

    在你的 Dart 文件中导入 blurhash_web 包:

    import 'package:blurhash_web/blurhash_web.dart';
    
  2. 生成 BlurHash 字符串

    你可以使用 BlurHash.encode 方法将图片转换为 BlurHash 字符串。通常,这个步骤会在服务器端完成,然后将生成的 BlurHash 字符串传递给客户端。

    String blurHash = await BlurHash.encode('path/to/image.jpg');
    
  3. 显示模糊预览

    使用 BlurHashImage 组件来显示模糊预览。你可以指定 BlurHash 字符串、图片的宽高以及最终的图片 URL。

    BlurHashImage(
      blurHash: 'L5H2EC=PM+yV0g-mq.wG9c010J}I', // 你的 BlurHash 字符串
      image: 'https://example.com/image.jpg', // 最终图片的 URL
      width: 300,
      height: 200,
      fit: BoxFit.cover,
    );
    
  4. 自定义加载和错误占位符

    你可以自定义图片加载时的占位符和加载失败时的错误占位符:

    BlurHashImage(
      blurHash: 'L5H2EC=PM+yV0g-mq.wG9c010J}I',
      image: 'https://example.com/image.jpg',
      width: 300,
      height: 200,
      fit: BoxFit.cover,
      placeholder: (context) => CircularProgressIndicator(), // 自定义加载占位符
      errorWidget: (context, error, stackTrace) => Icon(Icons.error), // 自定义错误占位符
    );
    

示例

以下是一个完整的示例,展示了如何在 Flutter Web 应用中使用 blurhash_web 插件:

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('BlurHash Web Example')),
        body: Center(
          child: BlurHashImage(
            blurHash: 'L5H2EC=PM+yV0g-mq.wG9c010J}I',
            image: 'https://example.com/image.jpg',
            width: 300,
            height: 200,
            fit: BoxFit.cover,
            placeholder: (context) => CircularProgressIndicator(),
            errorWidget: (context, error, stackTrace) => Icon(Icons.error),
          ),
        ),
      ),
    );
  }
}
回到顶部