Struct StyleChain

pub struct StyleChain<'a> { /* private fields */ }

A chain of styles, similar to a linked list.

A style chain allows to combine properties from multiple style lists in a element hierarchy in a non-allocating way. Rather than eagerly merging the lists, each access walks the hierarchy from the innermost to the outermost map, trying to find a match and then folding it with matches further up the chain.

Implementations

impl<'a> StyleChain<'a>

pub fn new(root: &'a Styles) -> StyleChain<'a>

Start a new style chain with root styles.

pub fn chain<'b, C>(&'b self, local: &'b C) -> StyleChain<'b>

where C: Chainable + ?Sized,

Make the given chainable the first link of this chain.

The resulting style chain contains styles from local as well as self. The ones from local take precedence over the ones from self. For folded properties local contributes the inner value.

pub fn get<T>( self, func: Element, id: u8, inherent: Option<&T>, default: impl Fn() -> T, ) -> T

where T: Clone + 'static,

Cast the first value for the given property in the chain.

pub fn get_ref<T>( self, func: Element, id: u8, inherent: Option<&'a T>, default: impl Fn() -> &'a T, ) -> &'a T

where T: 'static,

Cast the first value for the given property in the chain, returning a borrowed value.

pub fn get_folded<T>( self, func: Element, id: u8, inherent: Option<&T>, default: impl Fn() -> T, ) -> T

where T: Fold + Clone + 'static,

Cast the first value for the given property in the chain, taking Fold implementations into account.

pub fn entries(self) -> Entries<'a>

Iterate over the entries of the chain.

pub fn recipes(self) -> impl Iterator<Item = &'a Recipe>

Iterate over the recipes in the chain.

pub fn links(self) -> Links<'a>

Iterate over the links of the chain.

pub fn to_map(self) -> Styles

Convert to a style map.

pub fn suffix(self, len: usize) -> Styles

Build owned styles from the suffix (all links beyond the len) of the chain.

pub fn pop(&mut self)

Remove the last link from the chain.

pub fn trunk( iter: impl IntoIterator<Item = StyleChain<'a>>, ) -> Option<StyleChain<'a>>

Determine the shared trunk of a collection of style chains.

Trait Implementations

impl<'a> Clone for StyleChain<'a>

fn clone(&self) -> StyleChain<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for StyleChain<'_>

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

Formats the value using the given formatter.

impl<'a> Default for StyleChain<'a>

fn default() -> StyleChain<'a>

Returns the “default value” for a type.

impl<'a> Hash for StyleChain<'a>

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for StyleChain<'_>

fn eq(&self, other: &StyleChain<'_>) -> 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<'a> Copy for StyleChain<'a>