hotel_image 是一个用于 Flutter 的插件，专门用于管理酒店图片。它可以帮助开发者轻松地加载、显示和管理酒店相关的图片。以下是如何使用 hotel_image 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 hotel_image 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  hotel_image: ^1.0.0  # 请使用最新版本

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

2. 导入插件

在你的 Dart 文件中导入 hotel_image 插件：

import 'package:hotel_image/hotel_image.dart';

3. 使用 HotelImage 组件

HotelImage 是 hotel_image 插件提供的一个小部件，用于显示酒店图片。你可以通过以下方式使用它：

HotelImage(
  imageUrl: 'https://example.com/hotel_image.jpg',
  placeholder: 'assets/placeholder.png',  // 可选：加载时的占位图
  errorWidget: 'assets/error.png',  // 可选：加载失败时显示的图片
  width: 200,  // 可选：图片宽度
  height: 150,  // 可选：图片高度
  fit: BoxFit.cover,  // 可选：图片的填充方式
);

4. 处理图片加载状态

HotelImage 提供了几个回调函数，用于处理图片加载的不同状态：

HotelImage(
  imageUrl: 'https://example.com/hotel_image.jpg',
  onLoading: () {
    print('图片正在加载...');
  },
  onLoaded: () {
    print('图片加载完成');
  },
  onError: (error) {
    print('图片加载失败: $error');
  },
);

5. 自定义图片加载器

如果你需要自定义图片加载逻辑，可以通过 imageBuilder 参数来实现：

HotelImage(
  imageUrl: 'https://example.com/hotel_image.jpg',
  imageBuilder: (context, imageProvider) {
    return Container(
      decoration: BoxDecoration(
        image: DecorationImage(
          image: imageProvider,
          fit: BoxFit.cover,
        ),
      ),
    );
  },
);

6. 缓存管理

hotel_image 插件默认使用 Flutter 的缓存机制来缓存图片。你可以通过 cacheWidth 和 cacheHeight 参数来控制缓存图片的大小：

HotelImage(
  imageUrl: 'https://example.com/hotel_image.jpg',
  cacheWidth: 200,
  cacheHeight: 150,
);

7. 其他功能

hotel_image 插件还支持其他一些功能，例如：

• 图片裁剪：通过 clipBehavior 参数控制图片的裁剪方式。
• 图片滤镜：通过 colorFilter 参数为图片添加滤镜效果。

示例代码

以下是一个完整的示例代码，展示了如何使用 hotel_image 插件来显示酒店图片：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Hotel Image Example'),
        ),
        body: Center(
          child: HotelImage(
            imageUrl: 'https://example.com/hotel_image.jpg',
            placeholder: 'assets/placeholder.png',
            errorWidget: 'assets/error.png',
            width: 200,
            height: 150,
            fit: BoxFit.cover,
            onLoading: () {
              print('图片正在加载...');
            },
            onLoaded: () {
              print('图片加载完成');
            },
            onError: (error) {
              print('图片加载失败: $error');
            },
          ),
        ),
      ),
    );
  }
}