pub struct MatchingContext<'a, Impl>where
    Impl: SelectorImpl,{
Show 16 fields matching_mode: MatchingMode, pub bloom_filter: Option<&'a BloomFilter>, pub nth_index_cache: &'a mut NthIndexCache, pub scope_element: Option<OpaqueElement>, pub current_host: Option<OpaqueElement>, visited_handling: VisitedHandlingMode, nesting_level: usize, in_negation: bool, pub pseudo_element_matching_fn: Option<&'a dyn Fn(&Impl::PseudoElement) -> bool>, pub extra_data: Impl::ExtraMatchingData<'a>, current_relative_selector_anchor: Option<OpaqueElement>, pub considered_relative_selector: RelativeSelectorMatchingState, quirks_mode: QuirksMode, needs_selector_flags: NeedsSelectorFlags, classes_and_ids_case_sensitivity: CaseSensitivity, _impl: PhantomData<Impl>,
}
Expand description

Data associated with the matching process for a element. This context is used across many selectors for an element, so it’s not appropriate for transient data that applies to only a single selector.

Fields§

§matching_mode: MatchingMode

Input with the matching mode we should use when matching selectors.

§bloom_filter: Option<&'a BloomFilter>

Input with the bloom filter used to fast-reject selectors.

§nth_index_cache: &'a mut NthIndexCache

A cache to speed up nth-index-like selectors.

§scope_element: Option<OpaqueElement>

The element which is going to match :scope pseudo-class. It can be either one :scope element, or the scoping element.

Note that, although in theory there can be multiple :scope elements, in current specs, at most one is specified, and when there is one, scoping element is not relevant anymore, so we use a single field for them.

When this is None, :scope will match the root element.

See https://drafts.csswg.org/selectors-4/#scope-pseudo

§current_host: Option<OpaqueElement>

The current shadow host we’re collecting :host rules for.

§visited_handling: VisitedHandlingMode

Controls how matching for links is handled.

§nesting_level: usize

The current nesting level of selectors that we’re matching.

§in_negation: bool

Whether we’re inside a negation or not.

§pseudo_element_matching_fn: Option<&'a dyn Fn(&Impl::PseudoElement) -> bool>

An optional hook function for checking whether a pseudo-element should match when matching_mode is ForStatelessPseudoElement.

§extra_data: Impl::ExtraMatchingData<'a>

Extra implementation-dependent matching data.

§current_relative_selector_anchor: Option<OpaqueElement>

The current element we’re anchoring on for evaluating the relative selector.

§considered_relative_selector: RelativeSelectorMatchingState§quirks_mode: QuirksMode§needs_selector_flags: NeedsSelectorFlags§classes_and_ids_case_sensitivity: CaseSensitivity§_impl: PhantomData<Impl>

Implementations§

source§

impl<'a, Impl> MatchingContext<'a, Impl>where Impl: SelectorImpl,

source

pub fn new( matching_mode: MatchingMode, bloom_filter: Option<&'a BloomFilter>, nth_index_cache: &'a mut NthIndexCache, quirks_mode: QuirksMode, needs_selector_flags: NeedsSelectorFlags ) -> Self

Constructs a new MatchingContext.

source

pub fn new_for_visited( matching_mode: MatchingMode, bloom_filter: Option<&'a BloomFilter>, nth_index_cache: &'a mut NthIndexCache, visited_handling: VisitedHandlingMode, quirks_mode: QuirksMode, needs_selector_flags: NeedsSelectorFlags ) -> Self

Constructs a new MatchingContext for use in visited matching.

source

pub fn nth_index_cache( &mut self, is_of_type: bool, is_from_end: bool, selectors: &[Selector<Impl>] ) -> &mut NthIndexCacheInner

source

pub fn is_nested(&self) -> bool

Whether we’re matching a nested selector.

source

pub fn in_negation(&self) -> bool

Whether we’re matching inside a :not(..) selector.

source

pub fn quirks_mode(&self) -> QuirksMode

The quirks mode of the document.

source

pub fn matching_mode(&self) -> MatchingMode

The matching-mode for this selector-matching operation.

source

pub fn needs_selector_flags(&self) -> bool

Whether we need to set selector flags.

source

pub fn classes_and_ids_case_sensitivity(&self) -> CaseSensitivity

The case-sensitivity for class and ID selectors

source

pub fn nest<F, R>(&mut self, f: F) -> Rwhere F: FnOnce(&mut Self) -> R,

Runs F with a deeper nesting level.

source

pub fn nest_for_negation<F, R>(&mut self, f: F) -> Rwhere F: FnOnce(&mut Self) -> R,

Runs F with a deeper nesting level, and marking ourselves in a negation, for a :not(..) selector, for example.

source

pub fn visited_handling(&self) -> VisitedHandlingMode

source

pub fn with_visited_handling_mode<F, R>( &mut self, handling_mode: VisitedHandlingMode, f: F ) -> Rwhere F: FnOnce(&mut Self) -> R,

Runs F with a different VisitedHandlingMode.

source

pub fn with_shadow_host<F, E, R>(&mut self, host: Option<E>, f: F) -> Rwhere E: Element, F: FnOnce(&mut Self) -> R,

Runs F with a given shadow host which is the root of the tree whose rules we’re matching.

source

pub fn shadow_host(&self) -> Option<OpaqueElement>

Returns the current shadow host whose shadow root we’re matching rules against.

source

pub fn nest_for_relative_selector<F, R>( &mut self, anchor: OpaqueElement, f: F ) -> Rwhere F: FnOnce(&mut Self) -> R,

Runs F with a deeper nesting level, with the given element as the anchor, for a :has(…) selector, for example.

source

pub fn relative_selector_anchor(&self) -> Option<OpaqueElement>

Returns the current anchor element to evaluate the relative selector against.

Auto Trait Implementations§

§

impl<'a, Impl> !RefUnwindSafe for MatchingContext<'a, Impl>

§

impl<'a, Impl> !Send for MatchingContext<'a, Impl>

§

impl<'a, Impl> !Sync for MatchingContext<'a, Impl>

§

impl<'a, Impl> Unpin for MatchingContext<'a, Impl>where Impl: Unpin, <Impl as SelectorImpl>::ExtraMatchingData<'a>: Unpin,

§

impl<'a, Impl> !UnwindSafe for MatchingContext<'a, Impl>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.