Search packages, repositories and app categories

popover cover
Package detailsv0.5.1

popover

A popover is a transient view that appears above other content onscreen when you tap a control or in an area.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
38.8K
Likes
688
Pub points
160

Install package

flutter pub add popover

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The popover package provides a flexible and platform-aware way to display transient, floating views that appear above other content when triggered by user interaction. Designed for use with controls like buttons or icons, it supports smooth animations and adaptive positioning across Android, iOS, Web, macOS, Windows, and Linux. The package ensures consistent behavior while respecting native design guidelines on each platform. It's ideal for contextual menus, tooltips, or quick action panels without disrupting the main UI flow.

Use cases

  • Displaying context menus
  • Showing quick action panels
  • Creating tooltips
  • Presenting form validation hints
  • Enabling inline editing options

Key features

  • Cross-platform compatibility
  • Adaptive positioning
  • Smooth animations
  • Customizable content
  • Supports touch and pointer events
  • Responsive to screen boundaries

Suitable for

  • Developers building interactive UIs
  • Teams targeting multiple platforms
  • Apps needing contextual overlays
  • Design systems requiring reusable popovers
  • Projects using Material or Cupertino widgets

Considerations

  • Requires proper handling of dismiss gestures
  • May need custom styling for complex layouts
  • Performance impact with many concurrent popovers
  • Limited built-in theming options
  • Not suitable for persistent content

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Popover

Popover screenshots

Popover for Flutter

Supported platforms Popover is released under the MIT license. Effective Dart PRs welcome!
Current Build Status.

Content

Features

A popover is a transient view that appears above other content onscreen when you tap a control or in an area. Typically, a popover includes an arrow pointing to the location from which it emerged. Popovers can be nonmodal or modal. A nonmodal popover is dismissed by tapping another part of the screen or a button on the popover. A modal popover is dismissed by tapping a Cancel or other button on the popover.

Source: Human Interface Guidelines.

Requirements

  • Dart: 3.9.0+
  • Flutter: 3.35.0+

Install

dependencies:
  popover: ^0.4.0

Example

See example/lib/main.dart.

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

class PopoverExample extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('Popover Example')),
        body: const SafeArea(
          child: Padding(
            padding: EdgeInsets.all(16),
            child: Button(),
          ),
        ),
      ),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    return Container(
      width: 80,
      height: 40,
      decoration: const BoxDecoration(
        color: Colors.white,
        borderRadius: BorderRadius.all(Radius.circular(5)),
        boxShadow: [BoxShadow(color: Colors.black26, blurRadius: 5)],
      ),
      child: GestureDetector(
        child: const Center(child: Text('Click Me')),
        onTap: () {
          showPopover(
            context: context,
            bodyBuilder: (context) => const ListItems(),
            onPop: () => print('Popover was popped!'),
            direction: PopoverDirection.bottom,
            width: 200,
            height: 400,
            arrowHeight: 15,
            arrowWidth: 30,
          );
        },
      ),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    return Padding(
        padding: const EdgeInsets.symmetric(vertical: 8),
        child: ListView(
          padding: const EdgeInsets.all(8),
          children: [
            InkWell(
              onTap: () {
                Navigator.of(context)
                  ..pop()
                  ..push(
                    MaterialPageRoute<SecondRoute>(
                      builder: (context) => SecondRoute(),
                    ),
                  );
              },
              child: Container(
                height: 50,
                color: Colors.amber[100],
                child: const Center(child: Text('Entry A')),
              ),
            ),
            const Divider(),
            Container(
              height: 50,
              color: Colors.amber[200],
              child: const Center(child: Text('Entry B')),
            ),
            const Divider(),
            Container(
              height: 50,
              color: Colors.amber[300],
              child: const Center(child: Text('Entry C')),
            ),
          ],
        ),
    );
  }
}

class SecondRoute extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Second Route'),
        automaticallyImplyLeading: false,
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () => Navigator.pop(context),
          child: const Text('Go back!'),
        ),
      ),
    );
  }
}

To see examples of the following package on a device or simulator:

cd example && flutter run

Support

This project accepts pull requests only.

If you've encountered a bug or have an improvement in mind, please open a PR with a minimal fix or a reproduction in the example app. See CONTRIBUTING.md for the full contribution process.

License

The source code of the Popover project is available under the MIT license. See the LICENSE file for more info.

Categories

Source repository

Projects using this package