Struct Popover 

pub struct Popover { /* private fields */ }

A popover is used to display a menu or show some options.

Clicking the element that launches the popover should not change the current view, and the popover should be statically positioned relative to that element (not the user’s mouse.)

Example: A “new” menu with options like “new file”, “new folder”, etc, Linear’s “Display” menu, a profile menu that appears when you click your avatar.

Related elements:

ContextMenu:

Used to display a popover menu that only contains a list of items. Context menus are always launched by secondary clicking on an element. The menu is positioned relative to the user’s cursor.

Example: Right clicking a file in the file tree to get a list of actions, right clicking a tab to in the tab bar to get a list of actions.

Dropdown:

Used to display a list of options when the user clicks an element. The menu is positioned relative the element that was clicked, and clicking an item in the dropdown should change the value of the element that was clicked.

Example: A theme select control. Displays “One Dark”, clicking it opens a list of themes. When one is selected, the theme select control displays the selected theme.

Implementations

impl Popover

pub fn new() -> Self

pub fn aside(self, aside: impl IntoElement) -> Self

where Self: Sized,

Trait Implementations

impl Component for Popover

fn scope() -> ComponentScope

Returns the scope of the component.

fn description() -> Option<&'static str>

An optional description of the component.

fn preview(_window: &mut Window, _cx: &mut App) -> Option<AnyElement>

The component’s preview.

fn id() -> ComponentId

The component’s unique identifier.

fn status() -> ComponentStatus

The ready status of this component.

fn name() -> &'static str

The name of the component.

fn sort_name() -> &'static str

Returns a name that the component should be sorted by.

impl Default for Popover

fn default() -> Self

Returns the “default value” for a type.

impl IntoElement for Popover

type Element = Component<Popover>

The specific type of element into which the implementing type is converted. Useful for converting other types into elements automatically, like Strings

fn into_element(self) -> Self::Element

Convert self into a type that implements Element.

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed AnyElement.

impl ParentElement for Popover

fn extend(&mut self, elements: impl IntoIterator<Item = AnyElement>)

Extend this element’s children with the given child elements.

fn child(self, child: impl IntoElement) -> Self

where Self: Sized,

Add a single child element to this element.

fn children(self, children: impl IntoIterator<Item = impl IntoElement>) -> Self

where Self: Sized,

Add multiple child elements to this element.

impl RenderOnce for Popover

fn render(self, _: &mut Window, cx: &mut App) -> impl IntoElement

Render this component into an element tree. Note that this method takes ownership of self, as compared to Render::render() method which takes a mutable reference.