Struct Popover 

pub struct Popover<'a, Msg> { /* private fields */ }

Content shown as a layer next to an anchor, such as a filter panel under a button.

The application owns whether it is open: pass it to Popover::new and close it when the on_dismiss message arrives. The layer sits below the anchor, flips above (or to the other side) when there is no room and never leaves the screen. It unfolds from the anchor over the theme’s motion.enter. Esc or a press outside the anchor and the layer sends the dismiss message, and the press still reaches what it landed on, so one press on another button closes the popover and presses that button. A press on the widget that opened the popover only dismisses it, even when that widget is outside the anchor.

Style keys: popover (bg, padding).

use qframe::prelude::*;
use qframe::widgets::Popover;

struct Filters { open: bool }

#[derive(Clone)]
enum Msg { Toggle, Close }

impl App for Filters {
    type Msg = Msg;
    fn update(&mut self, msg: Msg) -> Command<Msg> {
        self.open = matches!(msg, Msg::Toggle) && !self.open;
        Command::none()
    }
    fn view(&self, ui: &mut View<'_, Msg>) {
        Popover::new(self.open)
            .on_dismiss(Msg::Close)
            .anchor(|ui| {
                ui.add(Button::new("Filters").on_press(Msg::Toggle));
            })
            .content(|ui| {
                ui.add(Text::new("Only running"));
            })
            .show(ui);
    }
}

let mut app = Harness::new(Filters { open: false }, 30, 6);
app.click_text("Filters").advance(std::time::Duration::from_millis(200));
assert!(app.screen().contains("Only running"));
app.press("esc");
assert!(!app.screen().contains("Only running"));

Implementations

impl<'a, Msg: Clone + 'static> Popover<'a, Msg>

pub fn new(open: bool) -> Self

A popover that shows its content while open.

pub fn anchor(self, build: impl FnOnce(&mut View<'_, Msg>) + 'a) -> Self

The widgets the layer belongs to, usually a button that toggles it.

pub fn content(self, build: impl FnOnce(&mut View<'_, Msg>) + 'a) -> Self

The widgets shown in the layer.

pub fn placement(self, placement: Placement) -> Self

The preferred side of the anchor; Placement::Below by default.

pub fn focus_inside(self, focus_inside: bool) -> Self

Moves keyboard focus to the first focusable widget in the layer when it opens, and back to where it was when it closes.

pub fn on_dismiss(self, message: Msg) -> Self

Message sent on Esc or a press outside; the application usually closes the popover.

pub fn show<'v>(self, ui: &'v mut View<'_, Msg>) -> NodeMut<'v, Msg>

Adds the popover to ui. The returned node sizes the anchor.