Struct style::custom_properties::CustomPropertiesBuilder

pub struct CustomPropertiesBuilder<'a, 'b: 'a> {
    seen: PrecomputedHashSet<&'a Name>,
    may_have_cycles: bool,
    custom_properties: ComputedCustomProperties,
    reverted: PrecomputedHashMap<&'a Name, (CascadePriority, bool)>,
    stylist: &'a Stylist,
    computed_context: &'a mut Context<'b>,
    references_from_non_custom_properties: NonCustomReferenceMap<Vec<Name>>,
}

A struct that takes care of encapsulating the cascade process for custom properties.

Fields

seen: PrecomputedHashSet<&'a Name>

may_have_cycles: bool

custom_properties: ComputedCustomProperties

reverted: PrecomputedHashMap<&'a Name, (CascadePriority, bool)>

stylist: &'a Stylist

computed_context: &'a mut Context<'b>

references_from_non_custom_properties: NonCustomReferenceMap<Vec<Name>>

Implementations

impl<'a, 'b: 'a> CustomPropertiesBuilder<'a, 'b>

pub fn new_with_properties( stylist: &'a Stylist, custom_properties: ComputedCustomProperties, computed_context: &'a mut Context<'b> ) -> Self

Create a new builder, inheriting from a given custom properties map.

We expose this publicly mostly for @keyframe blocks.

pub fn new(stylist: &'a Stylist, context: &'a mut Context<'b>) -> Self

Create a new builder, inheriting from the right style given context.

pub fn cascade( &mut self, declaration: &'a CustomDeclaration, priority: CascadePriority )

Cascade a given custom property declaration.

pub fn note_potentially_cyclic_non_custom_dependency( &mut self, id: LonghandId, decl: &VariableDeclaration )

Note a non-custom property with variable reference that may in turn depend on that property. e.g. font-size depending on a custom property that may be a registered property using em.

fn value_may_affect_style( &self, name: &Name, value: &CustomDeclarationValue ) -> bool

pub fn build( self, defer: DeferFontRelativeCustomPropertyResolution ) -> Option<ComputedCustomProperties>

Computes the map of applicable custom properties, as well as longhand properties that are now considered invalid-at-compute time. The result is saved into the computed context.

If there was any specified property or non-inherited custom property with an initial value, we’ve created a new map and now we need to remove any potential cycles (And marking non-custom properties), and wrap it in an arc.

Some registered custom properties may require font-related properties be resolved to resolve. If these properties are not resolved at this time, defer should be set to Yes, which will leave such custom properties, and other properties referencing them, untouched. These properties are returned separately, to be resolved by build_deferred to fully resolve all custom properties after all necessary non-custom properties are resolved.

pub fn build_deferred( deferred: ComputedCustomProperties, stylist: &Stylist, computed_context: &mut Context<'_> )

Fully resolve all deferred custom properties, assuming that the incoming context has necessary properties resolved.