Struct PlotAppearScope 

pub struct PlotAppearScope { /* private fields */ }

Remembers which plots inside it have finished appearing, so a plot that is painted again after a gap — a row a virtual list scrolled out of view and back — shows its data whole instead of drawing in again.

Wrap the list, or whatever region repaints its plots on and off, in one:

PlotAppearScope::new(("transcript", conversation_id), list(state, render_row).flex_1())

A plot is remembered by its global element id and its Plot::appear_generation, once its appear has finished; a new generation still replays it, and one taken away mid-appear draws in again from the start. The memory is the scope’s own element state: it lasts while the scope is painted every frame and goes with it, so a view that is closed, or a scope whose id changes — name it after the content, such as a conversation — draws its plots in afresh. The innermost scope wins. Without one, every plot draws in each time it is painted anew.

The scope takes no part in layout: it hands on its child’s layout, so a child that sizes itself, such as a list, keeps doing so.

Implementations

impl PlotAppearScope

pub fn new(id: impl Into<ElementId>, child: impl IntoElement) -> PlotAppearScope

Remember the appears of the plots in child under id, unique among its siblings.

Trait Implementations

impl Element for PlotAppearScope

type RequestLayoutState = (Option<AnyElement>, Rc<RefCell<HashMap<GlobalElementId, u64>>>)

The type of state returned from Element::request_layout. A mutable reference to this state is subsequently provided to Element::prepaint and Element::paint.

type PrepaintState = ()

The type of state returned from Element::prepaint. A mutable reference to this state is subsequently provided to Element::paint.

fn id(&self) -> Option<ElementId>

If this element has a unique identifier, return it here. This is used to track elements across frames, and will cause a GlobalElementId to be passed to the request_layout, prepaint, and paint methods.

fn source_location(&self) -> Option<&'static Location<'static>>

Source location where this element was constructed, used to disambiguate elements in the inspector and navigate to their source code.

fn request_layout( &mut self, global_id: Option<&GlobalElementId>, _: Option<&InspectorElementId>, window: &mut Window, cx: &mut App, ) -> (LayoutId, <PlotAppearScope as Element>::RequestLayoutState)

Before an element can be painted, we need to know where it’s going to be and how big it is. Use this method to request a layout from Taffy and initialize the element’s state.

fn prepaint( &mut self, _: Option<&GlobalElementId>, _: Option<&InspectorElementId>, _: Bounds<Pixels>, _: &mut <PlotAppearScope as Element>::RequestLayoutState, window: &mut Window, cx: &mut App, ) -> <PlotAppearScope as Element>::PrepaintState

After laying out an element, we need to commit its bounds to the current frame for hitbox purposes. The state argument is the same state that was returned from Element::request_layout().

fn paint( &mut self, _: Option<&GlobalElementId>, _: Option<&InspectorElementId>, _: Bounds<Pixels>, _: &mut <PlotAppearScope as Element>::RequestLayoutState, _: &mut <PlotAppearScope as Element>::PrepaintState, window: &mut Window, cx: &mut App, )

Once layout has been completed, this method will be called to paint the element to the screen. The state argument is the same state that was returned from Element::request_layout().

fn a11y_role(&self) -> Option<Role>

Returns the accessible role for this element, if any. Elements that return None are not included in the accessibility tree.

fn write_a11y_info(&self, _node: &mut Node)

Write accessibility properties to the given node. Called only when a11y_role() returns Some.

fn a11y_synthetic_children( &mut self, _prepaint: &mut Self::PrepaintState, _builder: &mut A11ySubtreeBuilder<'_>, )

Add synthetic child nodes to an Element that has an .id() and a .role().

fn into_any(self) -> AnyElement

Convert this element into a dynamically-typed AnyElement.

impl IntoElement for PlotAppearScope

type Element = PlotAppearScope

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) -> <PlotAppearScope as IntoElement>::Element

Convert self into a type that implements Element.

fn into_any_element(self) -> AnyElement

Convert self into a dynamically-typed AnyElement.