Struct ElementSpec 

pub struct ElementSpec {
    pub key: String,
    pub unit: String,
    pub label: String,
    pub labels: Option<BTreeMap<String, String>>,
    pub viz: Viz,
    pub band: Option<[f32; 2]>,
    pub stat: bool,
    pub scope: Scope,
    pub span: bool,
    pub value: Option<f32>,
    pub state: Option<String>,
}

A custom sensor or node stat a profile contributes to the dashboard.

This is the unit of a Presentation: one element keyed by a stable, language- neutral key, drawn with a chosen Viz, scoped to the groups it belongs on, and labelled for people who do not read the key. The snapshot still carries the raw value under key; this names how to show it.

Fields

key: String

The stable, language-neutral element key, such as "water_turbidity".

unit: String

The canonical unit name, such as "ntu", "ph", or "count".

label: String

A human-readable fallback label, shown when no localized label is available.

labels: Option<BTreeMap<String, String>>

Optional per-locale labels, keyed by locale tag ("en", "sw", …). A locale present here is shown in that locale; otherwise the page falls back to label.

viz: Viz

The graphic this element is drawn with.

band: Option<[f32; 2]>

The safe band [low, high] in the element’s unit, drawn as the gauge’s safe zone.

stat: bool

Whether this is a node or network stat rather than a measurement of the world. Stats are counted and rendered apart from sensors. Defaults false.

scope: Scope

Which groups this element is offered on. Defaults to Scope::Always.

span: bool

Whether the element’s tile spans two columns, for a wide graphic. Defaults false.

value: Option<f32>

A starting numeric value for the add-sensor dialog, before a real sample arrives.

state: Option<String>

A starting discrete state code, such as "state.closed", for a non-numeric element.

Implementations

impl ElementSpec

pub fn new( key: impl Into<String>, unit: impl Into<String>, label: impl Into<String>, viz: Viz, ) -> Self

Declares a numeric element drawn with the given graphic.

Arguments

• key - the stable, language-neutral element key.
• unit - the canonical unit name.
• label - a human-readable fallback label.
• viz - the graphic to draw it with.

Returns

A measurement element offered on every group, with no band yet.

pub fn with_band(self, low: f32, high: f32) -> Self

Sets the safe band drawn as the graphic’s safe zone.

Arguments

• low - the bottom of the safe band.
• high - the top of the safe band.

Returns

The element, for chaining.

pub fn on(self, scope: Scope) -> Self

Restricts the groups this element is offered on.

Arguments

• scope - the groups the add-sensor dialog offers this element on.

Returns

The element, for chaining.

pub fn as_stat(self) -> Self

Marks the element as a node or network stat rather than a measurement.

Returns

The element, for chaining.

pub fn with_value(self, value: f32) -> Self

Sets a starting value shown until the first real sample arrives.

Arguments

• value - the starting numeric value.

Returns

The element, for chaining.

pub fn with_state(self, state: impl Into<String>) -> Self

Sets a starting discrete state code for a non-numeric element.

Arguments

• state - the starting state code, such as "state.closed".

Returns

The element, for chaining.

pub fn wide(self) -> Self

Spans the element’s tile across two columns, for a wide graphic.

Returns

The element, for chaining.

pub fn with_locale_label( self, locale: impl Into<String>, label: impl Into<String>, ) -> Self

Adds a localized label for one locale.

Arguments

• locale - the locale tag, such as "sw".
• label - the element’s label in that locale.

Returns

The element, for chaining.

Trait Implementations

impl Clone for ElementSpec

fn clone(&self) -> ElementSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ElementSpec

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ElementSpec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ElementSpec

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ElementSpec

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 ElementSpec