seed 0.9.2

A Rust framework for creating web apps, using WebAssembly
Documentation
#![allow(clippy::wrong_self_convention)]

// ------------- CSSValue -------------

/// CSS property value.
///
/// # Example
///
/// ```rust,no_run
/// use seed::{prelude::*, *};
/// let disabled = true;
/// let style = style! {
///     "padding" => px(12),
///     "background-color" => if disabled { CSSValue::Ignored } else { "green".into() },
///     "display" => CSSValue::Some("block".to_string()),
/// };
/// ```
#[allow(clippy::upper_case_acronyms)]
#[derive(Clone, Debug, PartialEq, Eq)]
pub enum CSSValue {
    /// The whole CSS property is ignored (i.e. not rendered).
    Ignored,
    /// Rendered CSS property value.
    Some(String),
}

impl<T: ToString> From<T> for CSSValue {
    fn from(value: T) -> Self {
        CSSValue::Some(value.to_string())
    }
}

// ----------- ToCSSValue impls ------------

// impl ToCSSValue for CSSValue
#[doc(hidden)]
#[allow(clippy::wrong_self_convention)]
#[allow(clippy::upper_case_acronyms)]
pub trait ToCSSValueForCSSValue {
    fn to_css_value(self) -> CSSValue;
}

impl ToCSSValueForCSSValue for CSSValue {
    fn to_css_value(self) -> CSSValue {
        self
    }
}

// impl<T: ToString> ToCSSValue for T
#[doc(hidden)]
#[allow(clippy::upper_case_acronyms)]
pub trait ToCSSValueForToString {
    fn to_css_value(&self) -> CSSValue;
}

impl<T: ToString> ToCSSValueForToString for T {
    fn to_css_value(&self) -> CSSValue {
        CSSValue::Some(self.to_string())
    }
}

// impl<T: ToString> ToCSSValue for Option<T>
#[doc(hidden)]
#[allow(clippy::upper_case_acronyms)]
pub trait ToCSSValueForOptionToString {
    fn to_css_value(&self) -> CSSValue;
}

impl<T: ToString> ToCSSValueForOptionToString for Option<T> {
    fn to_css_value(&self) -> CSSValue {
        self.as_ref()
            .map_or(CSSValue::Ignored, |t| CSSValue::Some(t.to_string()))
    }
}

// ------------- AtValue -------------

/// Attribute value.
///
/// # Example
///
/// ```rust,no_run
/// use seed::{prelude::*, *};
///
/// struct Model {
///     message: String
/// }
///
/// let model = Model { message: "foo".to_string() };
///
/// let _ = attrs! {
///     At::Disabled => false.as_at_value(),  // same as `=> AtValue::Ignored`
///     At::Value => model.message,
///     At::AutoFocus => AtValue::None,
/// };
/// ```
#[derive(Clone, Debug, PartialEq, Eq)]
pub enum AtValue {
    /// The whole attribute is ignored (i.e. not rendered).
    Ignored,
    /// Attribute value is not used (i.e. rendered as empty string).
    None,
    /// Rendered attribute value.
    Some(String),
}

impl<T: ToString> From<T> for AtValue {
    fn from(value: T) -> Self {
        AtValue::Some(value.to_string())
    }
}

// `&` because `attrs!` macro automatically adds prefix `&` before values for more ergonomic API
// (otherwise it would fail when you use for example a Model's property in View functions as `AtValue`)
impl From<&AtValue> for AtValue {
    fn from(value: &AtValue) -> Self {
        value.clone()
    }
}

// -- AsAtValue --

pub trait AsAtValue {
    fn as_at_value(&self) -> AtValue;
}

impl AsAtValue for bool {
    fn as_at_value(&self) -> AtValue {
        match self {
            true => AtValue::None,
            false => AtValue::Ignored,
        }
    }
}

impl<T: ToString> AsAtValue for Option<T> {
    fn as_at_value(&self) -> AtValue {
        self.as_ref()
            .map_or(AtValue::Ignored, |v| AtValue::from(v.to_string()))
    }
}