PreviewCard

現在の画面を変えず、トリガーの横により詳しいホバー／フォーカスプレビューを表示します。

デモを読み込み中…

let card = PreviewCard::new("file", &state);
card.trigger_with(text("README.md"))

#インポート

quickgui から PreviewCard をインポートします。

use quickgui::*;

#使い方

let card = PreviewCard::new("file", &state);
card.trigger_with(text("README.md"))

#構成

PreviewCard::root
PreviewCard::trigger
PreviewCard::portal
PreviewCard::backdrop
PreviewCard::positioner
PreviewCard::popup
PreviewCard::arrow

#API リファレンス

項目を展開すると説明と完全なシグネチャが表示されます。ダッシュは宣言に既定値が記載されていないことを示します。

`PreviewCard`

ソースを見る

pub fn new( trigger_id: impl Into<ElementId>, popup_id: impl Into<ElementId>, open: bool, ) -> Self

Declare a preview card over caller-owned trigger and popup identities.

from_statepub fn from_state( trigger_id: impl Into<ElementId>, popup_id: impl Into<ElementId>, state: &PreviewCardState, ) -> Self—

Declare a preview card from its retained state.

pub fn from_state( trigger_id: impl Into<ElementId>, popup_id: impl Into<ElementId>, state: &PreviewCardState, ) -> Self

ソースを見る

placementpub const fn placement(mut self, placement: AnchorPlacement) -> Self—

Configures placement for this part.

pub const fn placement(mut self, placement: AnchorPlacement) -> Self

ソースを見る

anchor_gappub fn anchor_gap(mut self, gap: f32) -> Self—

Set the structural distance between the trigger and the popup.

pub fn anchor_gap(mut self, gap: f32) -> Self

ソースを見る

viewport_marginpub fn viewport_margin(mut self, margin: f32) -> Self—

Set the structural collision margin inside the current window viewport.

pub fn viewport_margin(mut self, margin: f32) -> Self

ソースを見る

popoverpub const fn popover(self) -> Popover—

The composed popover, for callers that need its remaining parts directly.

pub const fn popover(self) -> Popover

ソースを見る

is_openpub const fn is_open(self) -> bool—

Configures is open for this part.

pub const fn is_open(self) -> bool

ソースを見る

trigger_idpub const fn trigger_id(self) -> ElementId—

Configures trigger id for this part.

pub const fn trigger_id(self) -> ElementId

ソースを見る

popup_idpub const fn popup_id(self) -> ElementId—

Configures popup id for this part.

pub const fn popup_id(self) -> ElementId

ソースを見る

positioner_idpub fn positioner_id(self) -> ElementId—

Configures positioner id for this part.

pub fn positioner_id(self) -> ElementId

ソースを見る

backdrop_idpub fn backdrop_id(self) -> ElementId—

Configures backdrop id for this part.

pub fn backdrop_id(self) -> ElementId

ソースを見る

arrow_idpub fn arrow_id(self) -> ElementId—

Configures arrow id for this part.

pub fn arrow_id(self) -> ElementId

ソースを見る

trigger_focuspub fn trigger_focus(self) -> FocusHandle—

Configures trigger focus for this part.

pub fn trigger_focus(self) -> FocusHandle

ソースを見る

on_trigger_hover

pub fn on_trigger_hover<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: fn(&mut V) -> &mut PreviewCardState, on_open_change: Change, ) -> HoverListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

—

Build the trigger's hover behavior. Attach the returned handle with [`crate::Element::on_hover`]. `on_open_change` runs only when the open value actually changes, which for the delayed open is on the frame the deadline is applied rather than on the pointer event that armed it.

pub fn on_trigger_hover<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: fn(&mut V) -> &mut PreviewCardState, on_open_change: Change, ) -> HoverListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

ソースを見る

on_trigger_hover_with

pub fn on_trigger_hover_with<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: StateAccessor<V, PreviewCardState>, on_open_change: Change, ) -> HoverListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

—

Build the trigger's hover behavior against a per-instance state accessor.

pub fn on_trigger_hover_with<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: StateAccessor<V, PreviewCardState>, on_open_change: Change, ) -> HoverListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

ソースを見る

on_popup_hover

pub fn on_popup_hover<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: fn(&mut V) -> &mut PreviewCardState, on_open_change: Change, ) -> HoverListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

—

Build the popup's hover behavior, which keeps an open card open.

pub fn on_popup_hover<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: fn(&mut V) -> &mut PreviewCardState, on_open_change: Change, ) -> HoverListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

ソースを見る

on_popup_hover_with

pub fn on_popup_hover_with<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: StateAccessor<V, PreviewCardState>, on_open_change: Change, ) -> HoverListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

—

Build the popup's hover behavior against a per-instance state accessor.

pub fn on_popup_hover_with<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: StateAccessor<V, PreviewCardState>, on_open_change: Change, ) -> HoverListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

ソースを見る

on_dismiss

pub fn on_dismiss<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: fn(&mut V) -> &mut PreviewCardState, on_open_change: Change, ) -> DismissListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

—

Build the popup's dismissal behavior for Escape and outside presses. Attach the returned handle with [`crate::Element::on_dismiss`].

pub fn on_dismiss<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: fn(&mut V) -> &mut PreviewCardState, on_open_change: Change, ) -> DismissListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

ソースを見る

on_dismiss_with

pub fn on_dismiss_with<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: StateAccessor<V, PreviewCardState>, on_open_change: Change, ) -> DismissListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

—

Build the popup's dismissal behavior against a per-instance state accessor.

pub fn on_dismiss_with<V: 'static, Change>( self, cx: &mut ViewContext<'_, V>, access: StateAccessor<V, PreviewCardState>, on_open_change: Change, ) -> DismissListener<V> where Change: Fn(&mut V, bool, &mut EventContext) + 'static,

ソースを見る

schedulepub fn schedule<V: 'static>(cx: &mut ViewContext<'_, V>, state: &PreviewCardState)—

Ask for the one repaint an armed open or close deadline needs. Call this while rendering. A settled preview card requests nothing, so the window sleeps.

pub fn schedule<V: 'static>(cx: &mut ViewContext<'_, V>, state: &PreviewCardState)

ソースを見る

`PreviewCard::root_with`

ソースを見る

pub fn root_with(self, root: Element) -> Element

Decorate the optional application-owned structural wrapper. A preview card needs no wrapper of its own; this part exists so a composition that wants one keeps the trigger out of the window's native drag region without inventing appearance.

`PreviewCard::root`

ソースを見る

pub fn root(self) -> Element

Create the unstyled root part. Use [`Self::root_with`] to supply an existing element.

`PreviewCard::trigger_with`

ソースを見る

pub fn trigger_with(self, trigger: Element) -> Element

Decorate the application-owned link-like trigger without adding appearance. Unlike a popover trigger, this projects the Link role: a preview card previews a destination rather than opening a menu, so the trigger stays an ordinary link for the keyboard and for assistive technology.

`PreviewCard::trigger`

ソースを見る

pub fn trigger(self) -> Element

Create the unstyled trigger part. Use [`Self::trigger_with`] to supply an existing element.

`PreviewCard::portal_with`

ソースを見る

pub fn portal_with(self, portal: Element) -> Element

Decorate the caller-owned portal boundary. QuickGUI's retained overlay node is itself the portal, so this is the same boundary as [`Self::positioner_with`]; mount exactly one of them.

`PreviewCard::portal`

ソースを見る

pub fn portal(self) -> Element

Create the unstyled portal part. Use [`Self::portal_with`] to supply an existing element.

`PreviewCard::positioner_with`

ソースを見る

pub fn positioner_with(self, positioner: Element) -> Element

Decorate the caller-owned positioner without adding appearance.

`PreviewCard::positioner`

ソースを見る

pub fn positioner(self) -> Element

Create the unstyled positioner part. Use [`Self::positioner_with`] to supply an existing element.

`PreviewCard::popup_with`

ソースを見る

pub fn popup_with(self, popup: Element) -> Element

Decorate the application-owned popup without adding layout or appearance. The popup emits [`crate::Event::Dismiss`] under [`Self::popup_id`] for Escape and for an outside pointer press, and restores focus to the trigger.

`PreviewCard::popup`

ソースを見る

pub fn popup(self) -> Element

Create the unstyled popup part. Use [`Self::popup_with`] to supply an existing element.

`PreviewCard::arrow_with`

ソースを見る

pub fn arrow_with(self, arrow: Element) -> Element

Decorate the application-owned arrow. The arrow is decorative: it carries a stable identity so the application can position and animate it, and is hidden from assistive technology.

`PreviewCard::arrow`

ソースを見る

pub fn arrow(self) -> Element

Create the unstyled arrow part. Use [`Self::arrow_with`] to supply an existing element.

`PreviewCard::backdrop_with`

ソースを見る

pub fn backdrop_with(self, backdrop: Element) -> Element

Decorate an optional caller-painted viewport backdrop.

`PreviewCard::backdrop`

ソースを見る

pub fn backdrop(self) -> Element

Create the unstyled backdrop part. Use [`Self::backdrop_with`] to supply an existing element.