Flutter气泡弹出插件bubble_pop_up的使用

Flutter气泡弹出插件bubble_pop_up的使用

这个包提供了在任何位置围绕任何小部件创建气泡弹出的功能。

开始使用

首先安装该包,然后只需将您的小部件包裹在BubblePopUp小部件中,并在popUp参数中提供弹出小部件。

使用示例

以下示例展示了如何使用此包来显示一个弹出窗口,该窗口覆盖在文本上,显示用户当前余额的简短形式,如"13K"。当悬停时,会显示完整的值,如"13,429"。

final widgetPopUpOnHover = BubblePopUp(
  popUpColor: scheme.background, // 设置弹出窗口的背景颜色
  popUp: Container(
    decoration: BoxDecoration(
      color: scheme.background, // 设置弹出窗口的背景颜色
      borderRadius: Globals.borderRadius, // 设置弹出窗口的圆角
    ),
    padding: const EdgeInsets.all(10), // 设置弹出窗口内的内边距
    child: CurrencyText.fromString(
      balance.toMarkedString(), // 显示完整的数值
    ),
  ),
  child: ExcludeSemantics(
    excluding: true,
    child: CurrencyText.fromString(
      balanceShortStr, // 显示简短的数值
    ),
  ),
);

完整示例代码

import 'package:example/home.dart';
import 'package:flutter/material.dart';

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

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

  // 这个小部件是你的应用的根小部件。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(
          seedColor: Colors.deepOrange,
          brightness: Brightness.dark,
        ),
        useMaterial3: true,
      ),
      home: const HomeScreen(),
    );
  }
}

更多关于Flutter气泡弹出插件bubble_pop_up的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter气泡弹出插件bubble_pop_up的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


bubble_pop_up 是一个用于在 Flutter 应用中创建气泡弹出效果的插件。它可以用于显示提示、菜单或其他信息,通常以气泡的形式出现在屏幕的某个位置。以下是如何使用 bubble_pop_up 插件的基本步骤。

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  bubble_pop_up: ^1.0.0  # 请检查最新版本

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

2. 导入包

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

import 'package:bubble_pop_up/bubble_pop_up.dart';

3. 使用 BubblePopUp

你可以在你的 Flutter 应用中使用 BubblePopUp 来创建气泡弹出效果。以下是一个简单的示例:

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Bubble Pop Up Example'),
        ),
        body: Center(
          child: BubblePopUp(
            child: Text('Tap Me!'),
            popUp: Container(
              padding: EdgeInsets.all(10),
              decoration: BoxDecoration(
                color: Colors.blue,
                borderRadius: BorderRadius.circular(8),
              ),
              child: Text(
                'This is a bubble pop up!',
                style: TextStyle(color: Colors.white),
              ),
            ),
          ),
        ),
      ),
    );
  }
}

4. 参数说明

BubblePopUp 组件有一些常用的参数:

  • child: 触发气泡弹出的子组件(通常是按钮或文本)。
  • popUp: 气泡弹出时显示的内容(通常是一个 Container 或其他小部件)。
  • direction: 气泡弹出的方向(如 BubblePopUpDirection.top, BubblePopUpDirection.bottom 等)。
  • offset: 气泡相对于触发点的偏移量。
  • duration: 气泡显示的持续时间。
  • onTap: 点击气泡时的回调函数。

5. 自定义气泡样式

你可以通过 popUp 参数来自定义气泡的样式。例如,你可以使用 Container 来设置气泡的背景颜色、边框、圆角等。

BubblePopUp(
  child: Text('Tap Me!'),
  popUp: Container(
    padding: EdgeInsets.all(10),
    decoration: BoxDecoration(
      color: Colors.blue,
      borderRadius: BorderRadius.circular(8),
      boxShadow: [
        BoxShadow(
          color: Colors.black26,
          blurRadius: 5,
        ),
      ],
    ),
    child: Text(
      'This is a custom bubble pop up!',
      style: TextStyle(color: Colors.white),
    ),
  ),
);

6. 控制气泡的显示与隐藏

如果你需要手动控制气泡的显示与隐藏,可以使用 BubblePopUpController。以下是一个示例:

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

class _MyAppState extends State<MyApp> {
  final BubblePopUpController _controller = BubblePopUpController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Bubble Pop Up Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              BubblePopUp(
                controller: _controller,
                child: Text('Tap Me!'),
                popUp: Container(
                  padding: EdgeInsets.all(10),
                  decoration: BoxDecoration(
                    color: Colors.blue,
                    borderRadius: BorderRadius.circular(8),
                  ),
                  child: Text(
                    'This is a bubble pop up!',
                    style: TextStyle(color: Colors.white),
                  ),
                ),
              ),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: () {
                  _controller.show();
                },
                child: Text('Show Bubble'),
              ),
              ElevatedButton(
                onPressed: () {
                  _controller.hide();
                },
                child: Text('Hide Bubble'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}
回到顶部