Struct Element 

pub struct Element { /* private fields */ }

A declarative UI node (the Virtual DOM).

Implementations

impl Element

pub fn key(self, key: impl Into<Key>) -> Self

Assign a stable sibling key used during reconciliation.

For all multi-child containers, keyed children are matched by key first, so identity is preserved across reorders and insertions when tags are compatible.

pub fn component_state_key(self, key: impl Into<Key>) -> Self

Assign a path-independent persistence key for a nested component.

Unlike key, which only disambiguates siblings at the same resolved container path, component_state_key makes the component’s instance (and therefore its state) survive ancestor reshaping: wrapping or unwrapping parent containers, context providers, portals, or other restructuring that would normally invalidate the path-based reuse.

Only meaningful on elements produced from crate::child; a no-op on other element kinds.

pub fn min_width(self, w: Length) -> Self

Set minimum width constraint. See LayoutConstraints::min_w for semantics.

pub fn min_height(self, h: Length) -> Self

Set minimum height constraint. See LayoutConstraints::min_h for semantics.

pub fn max_width(self, w: Length) -> Self

Set maximum width constraint. See LayoutConstraints::max_w for semantics.

When the new max is a concrete Px value smaller than the current min_w, min_w is capped so that clamp_width does not override the max.

pub fn max_height(self, h: Length) -> Self

Set maximum height constraint. See LayoutConstraints::max_h for semantics.

When the new max is a concrete Px value smaller than the current min_h, min_h is capped so that clamp_height does not override the max.

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

Mark whether this element’s cross-axis size can change when its main-axis allocation changes. See LayoutConstraints::reflows.

pub fn shrink_priority(self, priority: ShrinkPriority) -> Self

Set this element’s stack shrink priority. See LayoutConstraints::shrink_priority.

Trait Implementations

impl Borrow<Element> for CanvasItem

fn borrow(&self) -> &Element

Immutably borrows from an owned value.

impl Clone for Element

fn clone(&self) -> Element

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for Element

fn default() -> Self

Creates a zero-cost placeholder element (empty Spacer).

This is primarily used by std::mem::take inside theme application to avoid deep-cloning children.

impl From<Accordion> for Element

fn from(accordion: Accordion) -> Self

Converts to this type from the input type.

impl From<Animated> for Element

fn from(value: Animated) -> Self

Converts to this type from the input type.

impl From<AsciiCanvas> for Element

fn from(value: AsciiCanvas) -> Self

Converts to this type from the input type.

impl From<Badge> for Element

fn from(badge: Badge) -> Self

Converts to this type from the input type.

impl From<BigText> for Element

fn from(val: BigText) -> Self

Converts to this type from the input type.

impl From<Breadcrumb> for Element

fn from(breadcrumb: Breadcrumb) -> Self

Converts to this type from the input type.

impl From<Button> for Element

fn from(value: Button) -> Self

Converts to this type from the input type.

impl From<Canvas> for Element

fn from(value: Canvas) -> Self

Converts to this type from the input type.

impl From<Center> for Element

fn from(value: Center) -> Self

Converts to this type from the input type.

impl From<CenterPin> for Element

fn from(value: CenterPin) -> Self

Converts to this type from the input type.

impl From<Chart> for Element

fn from(value: Chart) -> Self

Converts to this type from the input type.

impl From<Checkbox> for Element

fn from(value: Checkbox) -> Self

Converts to this type from the input type.

impl From<ClassDiagram> for Element

fn from(value: ClassDiagram) -> Self

Converts to this type from the input type.

impl From<ComboBox> for Element

fn from(combo: ComboBox) -> Self

Converts to this type from the input type.

impl From<CommandPalette> for Element

fn from(palette: CommandPalette) -> Self

Converts to this type from the input type.

impl From<ContextMenu> for Element

fn from(menu: ContextMenu) -> Self

Converts to this type from the input type.

impl<T> From<ContextProvider<T>> for Element

where T: ContextValue,

fn from(provider: ContextProvider<T>) -> Self

Converts to this type from the input type.

impl From<DatePicker> for Element

fn from(picker: DatePicker) -> Self

Converts to this type from the input type.

impl From<DiffView> for Element

fn from(view: DiffView) -> Self

Converts to this type from the input type.

impl From<Divider> for Element

fn from(value: Divider) -> Self

Converts to this type from the input type.

impl From<DocumentView> for Element

fn from(value: DocumentView) -> Self

Converts to this type from the input type.

impl From<DragSource> for Element

fn from(value: DragSource) -> Self

Converts to this type from the input type.

impl From<DraggableTabBar> for Element

fn from(value: DraggableTabBar) -> Self

Converts to this type from the input type.

impl From<DropTarget> for Element

fn from(value: DropTarget) -> Self

Converts to this type from the input type.

impl From<EffectScope> for Element

fn from(value: EffectScope) -> Self

Converts to this type from the input type.

impl From<ErDiagram> for Element

fn from(value: ErDiagram) -> Self

Converts to this type from the input type.

impl From<FileTree> for Element

fn from(file_tree: FileTree) -> Self

Converts to this type from the input type.

impl From<Flow> for Element

fn from(value: Flow) -> Self

Converts to this type from the input type.

impl From<Flowchart> for Element

fn from(value: Flowchart) -> Self

Converts to this type from the input type.

impl From<Frame> for Element

fn from(value: Frame) -> Self

Converts to this type from the input type.

impl From<GanttDiagram> for Element

fn from(value: GanttDiagram) -> Self

Converts to this type from the input type.

impl From<Graph> for Element

fn from(value: Graph) -> Self

Converts to this type from the input type.

impl From<Grid> for Element

fn from(value: Grid) -> Self

Converts to this type from the input type.

impl From<HStack> for Element

fn from(value: HStack) -> Self

Converts to this type from the input type.

impl From<Heatmap> for Element

fn from(value: Heatmap) -> Self

Converts to this type from the input type.

impl From<HexArea> for Element

fn from(value: HexArea) -> Self

Converts to this type from the input type.

impl From<Hyperlink> for Element

fn from(value: Hyperlink) -> Self

Converts to this type from the input type.

impl From<Image> for Element

fn from(value: Image) -> Self

Converts to this type from the input type.

impl From<Input> for Element

fn from(value: Input) -> Self

Converts to this type from the input type.

impl From<List> for Element

fn from(value: List) -> Self

Converts to this type from the input type.

impl From<LogView> for Element

fn from(view: LogView) -> Self

Converts to this type from the input type.

impl From<ManagedTerminal> for Element

fn from(terminal: ManagedTerminal) -> Self

Converts to this type from the input type.

impl From<Modal> for Element

fn from(modal: Modal) -> Self

Converts to this type from the input type.

impl From<MouseRegion> for Element

fn from(value: MouseRegion) -> Self

Converts to this type from the input type.

impl From<MultiSelect> for Element

fn from(multi: MultiSelect) -> Self

Converts to this type from the input type.

impl From<PaginationBar> for Element

fn from(bar: PaginationBar) -> Self

Converts to this type from the input type.

impl From<PanView> for Element

fn from(value: PanView) -> Self

Converts to this type from the input type.

impl From<Popover> for Element

fn from(popover: Popover) -> Self

Converts to this type from the input type.

impl From<ProgressBar> for Element

fn from(value: ProgressBar) -> Self

Converts to this type from the input type.

impl From<QrCode> for Element

fn from(qr: QrCode) -> Self

Converts to this type from the input type.

impl From<Radio> for Element

fn from(radio: Radio) -> Self

Converts to this type from the input type.

impl From<ScrollView> for Element

fn from(value: ScrollView) -> Self

Converts to this type from the input type.

impl<T: Clone + PartialEq + 'static> From<SearchPalette<T>> for Element

fn from(palette: SearchPalette<T>) -> Self

Converts to this type from the input type.

impl From<Select> for Element

fn from(select: Select) -> Self

Converts to this type from the input type.

impl From<SequenceDiagram> for Element

fn from(value: SequenceDiagram) -> Self

Converts to this type from the input type.

impl From<Slider> for Element

fn from(slider: Slider) -> Self

Converts to this type from the input type.

impl From<Spacer> for Element

fn from(value: Spacer) -> Self

Converts to this type from the input type.

impl From<Sparkline> for Element

fn from(val: Sparkline) -> Self

Converts to this type from the input type.

impl From<Spinner> for Element

fn from(value: Spinner) -> Self

Converts to this type from the input type.

impl From<Splitter> for Element

fn from(value: Splitter) -> Self

Converts to this type from the input type.

impl From<StateDiagram> for Element

fn from(value: StateDiagram) -> Self

Converts to this type from the input type.

impl From<StatusBar> for Element

fn from(bar: StatusBar) -> Self

Converts to this type from the input type.

impl From<Table> for Element

fn from(value: Table) -> Self

Converts to this type from the input type.

impl From<Tabs> for Element

fn from(value: Tabs) -> Self

Converts to this type from the input type.

impl From<Terminal> for Element

fn from(terminal: Terminal) -> Self

Converts to this type from the input type.

impl From<Text> for Element

fn from(value: Text) -> Self

Converts to this type from the input type.

impl From<TextArea> for Element

fn from(value: TextArea) -> Self

Converts to this type from the input type.

impl From<ThemeProvider> for Element

fn from(provider: ThemeProvider) -> Self

Converts to this type from the input type.

impl From<Toast> for Element

fn from(toast: Toast) -> Self

Converts to this type from the input type.

impl From<Tooltip> for Element

fn from(tooltip: Tooltip) -> Self

Converts to this type from the input type.

impl From<Tree> for Element

fn from(tree: Tree) -> Self

Converts to this type from the input type.

impl From<VStack> for Element

fn from(value: VStack) -> Self

Converts to this type from the input type.

impl From<ZStack> for Element

fn from(value: ZStack) -> Self

Converts to this type from the input type.