Enum parcel_selectors::parser::Component

pub enum Component<'i, Impl: SelectorImpl<'i>> {
    Combinator(Combinator),
    ExplicitAnyNamespace,
    ExplicitNoNamespace,
    DefaultNamespace(Impl::NamespaceUrl),
    Namespace(Impl::NamespacePrefix, Impl::NamespaceUrl),
    ExplicitUniversalType,
    LocalName(LocalName<'i, Impl>),
    ID(Impl::Identifier),
    Class(Impl::Identifier),
    AttributeInNoNamespaceExists {
        local_name: Impl::LocalName,
        local_name_lower: Impl::LocalName,
    },
    AttributeInNoNamespace {
        local_name: Impl::LocalName,
        operator: AttrSelectorOperator,
        value: Impl::AttrValue,
        case_sensitivity: ParsedCaseSensitivity,
        never_matches: bool,
    },
    AttributeOther(Box<AttrSelectorWithOptionalNamespace<'i, Impl>>),
    Negation(Box<[Selector<'i, Impl>]>),
    FirstChild,
    LastChild,
    OnlyChild,
    Root,
    Empty,
    Scope,
    NthChild(i32, i32),
    NthLastChild(i32, i32),
    NthCol(i32, i32),
    NthLastCol(i32, i32),
    NthOfType(i32, i32),
    NthLastOfType(i32, i32),
    FirstOfType,
    LastOfType,
    OnlyOfType,
    NonTSPseudoClass(Impl::NonTSPseudoClass),
    Slotted(Selector<'i, Impl>),
    Part(Box<[Impl::Identifier]>),
    Host(Option<Selector<'i, Impl>>),
    Where(Box<[Selector<'i, Impl>]>),
    Is(Box<[Selector<'i, Impl>]>),
    Any(Impl::VendorPrefix, Box<[Selector<'i, Impl>]>),
    Has(Box<[Selector<'i, Impl>]>),
    PseudoElement(Impl::PseudoElement),
    Nesting,
}

A CSS simple selector or combinator. We store both in the same enum for optimal packing and cache performance, see [1].

[1] https://bugzilla.mozilla.org/show_bug.cgi?id=1357973

Variants

Combinator(Combinator)

ExplicitAnyNamespace

ExplicitNoNamespace

DefaultNamespace(Impl::NamespaceUrl)

Namespace(Impl::NamespacePrefix, Impl::NamespaceUrl)

ExplicitUniversalType

LocalName(LocalName<'i, Impl>)

ID(Impl::Identifier)

Class(Impl::Identifier)

AttributeInNoNamespaceExists

Fields

local_name: Impl::LocalName

local_name_lower: Impl::LocalName

AttributeInNoNamespace

Fields

local_name: Impl::LocalName

operator: AttrSelectorOperator

value: Impl::AttrValue

case_sensitivity: ParsedCaseSensitivity

never_matches: bool

AttributeOther(Box<AttrSelectorWithOptionalNamespace<'i, Impl>>)

Negation(Box<[Selector<'i, Impl>]>)

Pseudo-classes

FirstChild

LastChild

OnlyChild

Root

Empty

Scope

NthChild(i32, i32)

NthLastChild(i32, i32)

NthCol(i32, i32)

NthLastCol(i32, i32)

NthOfType(i32, i32)

NthLastOfType(i32, i32)

FirstOfType

LastOfType

OnlyOfType

NonTSPseudoClass(Impl::NonTSPseudoClass)

Slotted(Selector<'i, Impl>)

The ::slotted() pseudo-element:

https://drafts.csswg.org/css-scoping/#slotted-pseudo

The selector here is a compound selector, that is, no combinators.

NOTE(emilio): This should support a list of selectors, but as of this writing no other browser does, and that allows them to put ::slotted() in the rule hash, so we do that too.

See https://github.com/w3c/csswg-drafts/issues/2158

Part(Box<[Impl::Identifier]>)

The ::part pseudo-element. https://drafts.csswg.org/css-shadow-parts/#part

Host(Option<Selector<'i, Impl>>)

The :host pseudo-class:

https://drafts.csswg.org/css-scoping/#host-selector

NOTE(emilio): This should support a list of selectors, but as of this writing no other browser does, and that allows them to put :host() in the rule hash, so we do that too.

See https://github.com/w3c/csswg-drafts/issues/2158

Where(Box<[Selector<'i, Impl>]>)

The :where pseudo-class.

https://drafts.csswg.org/selectors/#zero-matches

The inner argument is conceptually a SelectorList, but we move the selectors to the heap to keep Component small.

Is(Box<[Selector<'i, Impl>]>)

The :is pseudo-class.

https://drafts.csswg.org/selectors/#matches-pseudo

Same comment as above re. the argument.

Any(Impl::VendorPrefix, Box<[Selector<'i, Impl>]>)

Has(Box<[Selector<'i, Impl>]>)

The :has pseudo-class.

https://www.w3.org/TR/selectors/#relational

PseudoElement(Impl::PseudoElement)

An implementation-dependent pseudo-element selector.

Nesting

A nesting selector:

https://drafts.csswg.org/css-nesting-1/#nest-selector

NOTE: This is a lightningcss addition.

Implementations

impl<'i, Impl: SelectorImpl<'i>> Component<'i, Impl>

pub fn is_combinator(&self) -> bool

Returns true if this is a combinator.

pub fn as_combinator(&self) -> Option<Combinator>

Returns the value as a combinator if applicable, None otherwise.

pub fn maybe_allowed_after_pseudo_element(&self) -> bool

Whether this component is valid after a pseudo-element. Only intended for sanity-checking.

pub fn visit<V>(&self, visitor: &mut V) -> boolwhere
    V: SelectorVisitor<'i, Impl = Impl>,

Trait Implementations

impl<'i, Impl: Clone + SelectorImpl<'i>> Clone for Component<'i, Impl>where
    Impl::NamespaceUrl: Clone,
    Impl::NamespacePrefix: Clone,
    Impl::NamespaceUrl: Clone,
    Impl::Identifier: Clone,
    Impl::Identifier: Clone,
    Impl::LocalName: Clone,
    Impl::LocalName: Clone,
    Impl::LocalName: Clone,
    Impl::AttrValue: Clone,
    Impl::NonTSPseudoClass: Clone,
    Impl::Identifier: Clone,
    Impl::VendorPrefix: Clone,
    Impl::PseudoElement: Clone,

fn clone(&self) -> Component<'i, Impl>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'i, Impl: SelectorImpl<'i>> Debug for Component<'i, Impl>

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

Formats the value using the given formatter.

impl<'i, Impl: PartialEq + SelectorImpl<'i>> PartialEq<Component<'i, Impl>> for Component<'i, Impl>where
    Impl::NamespaceUrl: PartialEq,
    Impl::NamespacePrefix: PartialEq,
    Impl::NamespaceUrl: PartialEq,
    Impl::Identifier: PartialEq,
    Impl::Identifier: PartialEq,
    Impl::LocalName: PartialEq,
    Impl::LocalName: PartialEq,
    Impl::LocalName: PartialEq,
    Impl::AttrValue: PartialEq,
    Impl::NonTSPseudoClass: PartialEq,
    Impl::Identifier: PartialEq,
    Impl::VendorPrefix: PartialEq,
    Impl::PseudoElement: PartialEq,

fn eq(&self, other: &Component<'i, Impl>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'i, Impl: SelectorImpl<'i>> ToCss for Component<'i, Impl>

fn to_css<W>(&self, dest: &mut W) -> Resultwhere
    W: Write,

Serialize self in CSS syntax, writing to dest.

fn to_css_string(&self) -> String

Serialize self in CSS syntax and return a string.

impl<'i, Impl: SelectorImpl<'i>> StructuralPartialEq for Component<'i, Impl>