Flutter弹窗覆盖层插件overlay_dialog的使用

发布于 1周前 作者 zlyuanteng 来自 Flutter

Flutter弹窗覆盖层插件overlay_dialog的使用

overlay_dialog 是一个用于在不创建新路由的情况下显示平台对话框的Flutter插件。它解决了标准Flutter showDialog<T> 方法带来的一些问题,并提供了更灵活和直观的对话框管理方式。

主要特点

  • 无混淆导航:对话框添加到当前路由,而不是创建新的路由。
  • 支持Material和Cupertino样式:可以根据应用的主题自动适配不同风格的对话框。
  • 纯Flutter解决方案:无需额外导入其他库。

解决的问题

  1. 标准的 showDialog<T> 会创建一个新的路由,这可能导致生命周期处理上的混乱。
  2. showDialog<T> 是异步调用,无法直接判断对话框是否已经打开。
  3. 对话框与页面共享同一个导航器,导致关闭操作可能误关闭页面而非对话框。

使用方法

安装

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

dependencies:
  overlay_dialog: ^版本号

记得替换^版本号为最新版本号。

示例代码

下面是一个完整的示例demo,展示了如何使用overlay_dialog来展示不同类型(警告、进度、自定义)的对话框。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Overlay Dialog Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

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

class _MyHomePageState extends State<MyHomePage> {

  void _showAlertDialog() {
    DialogWidget.alert(
      closable: true,
      style: DialogStyle.material,
      title: "Alert",
      content: "This is an alert dialog.",
      actions: [
        DialogAction(
          title: "OK",
          handler: () {
            Navigator.of(context).pop(); // Close the dialog
          },
        ),
      ],
    ).show(context);
  }

  void _showProgressDialog() {
    DialogWidget.progress(style: DialogStyle.material).show(context);
  }

  void _showCustomDialog() {
    DialogWidget.custom(
      child: Center(
        child: Text("This is a custom dialog"),
      ),
    ).show(context);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Overlay Dialog Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: _showAlertDialog,
              child: Text('Show Alert Dialog'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _showProgressDialog,
              child: Text('Show Progress Dialog'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _showCustomDialog,
              child: Text('Show Custom Dialog'),
            ),
          ],
        ),
      ),
    );
  }
}

更多关于Flutter弹窗覆盖层插件overlay_dialog的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter弹窗覆盖层插件overlay_dialog的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然,下面是一个关于如何在Flutter中使用overlay_dialog插件来创建弹窗覆盖层的代码示例。overlay_dialog插件允许你创建自定义的弹窗,并在应用程序的Overlay上显示它们。

首先,确保你已经在pubspec.yaml文件中添加了overlay_dialog依赖:

dependencies:
  flutter:
    sdk: flutter
  overlay_dialog: ^0.1.0  # 请检查最新版本号

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

接下来,下面是一个简单的示例,展示如何使用overlay_dialog来显示一个自定义的弹窗:

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  @override
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  OverlayDialog overlayDialog;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Overlay Dialog Example'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            showOverlayDialog(
              context: context,
              builder: (context) {
                return CustomOverlayDialog();
              },
            ).then((value) {
              if (value != null) {
                // 处理弹窗返回的数据
                print('Dialog result: $value');
              }
            });
          },
          child: Text('Show Overlay Dialog'),
        ),
      ),
    );
  }
}

class CustomOverlayDialog extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Material(
      color: Colors.transparent,
      child: Container(
        decoration: BoxDecoration(
          color: Colors.white,
          borderRadius: BorderRadius.circular(16),
        ),
        constraints: BoxConstraints(
          maxWidth: 300,
          maxHeight: 200,
        ),
        padding: EdgeInsets.all(16),
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Text(
              'This is a custom overlay dialog',
              style: TextStyle(fontSize: 18),
            ),
            SizedBox(height: 16),
            ElevatedButton(
              onPressed: () {
                Navigator.of(context).pop('Accepted');
              },
              child: Text('Accept'),
            ),
            SizedBox(height: 8),
            ElevatedButton(
              onPressed: () {
                Navigator.of(context).pop('Declined');
              },
              child: Text('Decline'),
            ),
          ],
        ),
      ),
    );
  }
}

在这个示例中:

  1. MyApp是一个简单的Flutter应用程序,包含一个HomeScreen
  2. HomeScreen是一个包含按钮的页面,点击按钮会显示一个自定义的弹窗。
  3. CustomOverlayDialog是自定义的弹窗内容,包含一些文本和两个按钮。
  4. 使用showOverlayDialog函数来显示弹窗,该函数返回一个Future,当弹窗关闭时可以获取返回值。

你可以根据需要自定义CustomOverlayDialog中的内容,以适应你的应用需求。

回到顶部