Flutter插件flutter_empty的介绍与使用

简介

flutter_empty 是一个用于展示屏幕状态（如加载中、错误、空状态等）的小部件。它可以帮助开发者快速实现这些常见的UI场景。

截图

安装与配置

1. 添加依赖

在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  flutter_empty: ^<latest_version>

运行 flutter pub get 更新依赖。

2. 导入库

在需要使用的文件中导入 flutter_empty：

import 'package:flutter_empty/flutter_empty.dart';

使用方法

通过 EmptyView 小部件可以轻松设置加载、错误或空状态。以下是基本用法示例：

EmptyView(
  widget: Text('内容'), // 显示的主要内容
  loading: true,        // 是否显示加载状态
)

示例代码

以下是一个完整的示例代码，展示了如何动态切换加载、错误和空状态：

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  // 控制状态
  bool _error = false;
  bool _loading = false;
  bool _empty = false;

  // 切换状态的方法
  void _modifyStatus() {
    setState(() {
      _counter++;
      
      // 循环切换状态
      if (!_loading && !_error && !_empty) {
        _loading = true;
        _error = false;
        _empty = false;
      } else if (!_error && _loading && !_empty) {
        _error = true;
        _loading = false;
        _empty = false;
      } else if (!_empty && !_loading && _error) {
        _empty = true;
        _error = false;
        _loading = false;
      } else if (!_loading && _empty && !_error) {
        _empty = false;
      }
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: EmptyView(
        // 设置状态
        error: _error,         // 错误状态
        loading: _loading,     // 加载状态
        empty: _empty,         // 空状态
        errorPressed: _modifyStatus, // 点击错误状态时触发
        emptyPressed: _modifyStatus, // 点击空状态时触发
        widget: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              const Text(
                '你已经点击按钮次数：',
              ),
              Text(
                '$_counter',
                style: Theme.of(context).textTheme.headline4,
              ),
            ],
          ),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _modifyStatus,
        tooltip: '修改状态',
        child: const Icon(Icons.refresh),
      ),
    );
  }
}