Struct Token 

pub struct Token<T> { /* private fields */ }

A named value of type T, written as the custom property --<name>.

Token::var reads it as var(--<name>, <default>), so a page without a Theme shows the default. A Theme sets it for the whole page, and Style::token for one element and those inside it.

Two tokens with the same name are one custom property to the browser, and nothing checks that each name is used once.

use hypersig_style::value::{Color, px};
use hypersig_style::{Media, Style, Theme, Token};

let brand = Token::new("brand", Color::hex(0xb83f45));
let button = Style::new().background_color(brand.var()).padding(px(8));
let theme = Theme::new().on(Media::Dark, Theme::new().set(&brand, Color::hex(0xff6b6b)));
assert!(theme.to_css().contains("@media (prefers-color-scheme: dark){:root{--brand:#ff6b6b}}"));

Implementations

impl<T: TokenValue> Token<T>

pub fn new(name: &'static str, default: T) -> Self

A token named name whose value is default until something sets it.

Panics

Panics if name is empty or holds a character other than an ASCII letter, digit, -, or _, which a custom property name would need escaped.

pub fn name(&self) -> &'static str

The name, without the leading --.

pub fn var(&self) -> T

The token’s current value, as var(--<name>, <default>).

Trait Implementations

impl<T: Clone> Clone for Token<T>

fn clone(&self) -> Token<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Token<T>

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

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for Token<T>

fn eq(&self, other: &Token<T>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<T: PartialEq> StructuralPartialEq for Token<T>