Struct Control 

pub struct Control {
    pub id: Key,
    pub label: String,
    pub kind: ControlKind,
    pub value: Option<String>,
}

One control, as DATA — never a widget.

This is what lets an egui pane, a TUI, a robot driver and a web client render the same set from one description. It is also what makes the guard possible: two choices can be compared by their control ids, which is impossible if controls() were a pile of immediate-mode calls.

The id is the stable address (see Key); label is human-facing and may change freely.

Fields

id: Key

Stable machine id — what a driver addresses and what a guard compares.

label: String

Human-facing text. Free to change without breaking anything.

kind: ControlKind

What kind of control this is.

value: Option<String>

The current value, rendered as a string ("true", "12", a URL). None when the control has no value yet — which is DIFFERENT from an empty string, and must render differently, for the same reason empty-vs-unreadable must.

Implementations

impl Control

pub fn readout( id: impl Into<Key>, label: impl Into<String>, value: impl Into<String>, ) -> Control

A read-only fact.

pub fn toggle(id: impl Into<Key>, label: impl Into<String>, on: bool) -> Control

An on/off switch.

pub fn text( id: impl Into<Key>, label: impl Into<String>, hint: impl Into<String>, value: &str, ) -> Control

A free-text field.

Trait Implementations

impl Clone for Control

fn clone(&self) -> Control

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Control

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Control

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Control

fn eq(&self, other: &Control) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Control

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Control