Donner SVG Editor & Engine
SVG-native editor and embeddable SVG2 + CSS3 engine in C++20, with GPU (WebGPU) and compact CPU renderers, built for correctness, security, and performance.
Loading...
Searching...
No Matches
donner::css::CompoundSelector Struct Reference

A compound selector is a sequence of simple selectors, which represents a set of conditions that are combined to match a single element. More...

#include "donner/css/selectors/CompoundSelector.h"

Public Types

using Entry
 A single entry in a compound selector, which can be any of the simple selectors in this variant.

Public Member Functions

 CompoundSelector ()=default
 Default constructor.
 ~CompoundSelector () noexcept=default
 Destructor.
 CompoundSelector (const CompoundSelector &)=default
 Copy constructor.
 CompoundSelector (CompoundSelector &&)=default
 Move constructor.
CompoundSelector & operator= (const CompoundSelector &)=default
 Copy assignment operator.
CompoundSelector & operator= (CompoundSelector &&)=default
 Move assignment operator.
bool isValid () const
 Return true if this selector is valid and supported by this implementation.
template<ElementLike T>
bool matches (const T &element, bool requirePrimary, const SelectorMatchOptions< T > &options) const
 Returns true if the provided element matches this selector.

Public Attributes

std::vector< Entry > entries
 The list of simple selectors in this compound selector.

Friends

std::ostream & operator<< (std::ostream &os, const CompoundSelector &obj)
 Ostream output operator, outputs a debug string, e.g. CompoundSelector(TypeSelector(name)).

Detailed Description

A compound selector is a sequence of simple selectors, which represents a set of conditions that are combined to match a single element.

For example, the selector div#foo.bar is a compound selector, while div > #foo is two compound selectors separated by a combinator. Combinators are handled as part of ComplexSelector.

Member Typedef Documentation

◆ Entry

using donner::css::CompoundSelector::Entry
Initial value:
std::variant<PseudoElementSelector, TypeSelector, IdSelector, ClassSelector,
PseudoClassSelector, AttributeSelector>
donner::css::AttributeSelector
Selectors which match against element attributes, such as a[href^="https://"] or h1[title].
Definition AttributeSelector.h:54
donner::css::ClassSelector
Selector which match the element's class attribute, for example .foo matches an element with class fo...
Definition ClassSelector.h:15
donner::css::IdSelector
Selector which match the element's id attribute, for example #foo matches an element with an id="foo"...
Definition IdSelector.h:15
donner::css::PseudoClassSelector
Selectors which start with one colon, e.g.
Definition PseudoClassSelector.h:95
donner::css::PseudoElementSelector
Selectors which start with two colons are called pseudo-elements, e.g.
Definition PseudoElementSelector.h:23
donner::css::TypeSelector
Selector which matches the element type, e.g.
Definition TypeSelector.h:24

A single entry in a compound selector, which can be any of the simple selectors in this variant.

Member Function Documentation

◆ isValid()

bool donner::css::CompoundSelector::isValid ( ) const
inline

Return true if this selector is valid and supported by this implementation.

See also
https://www.w3.org/TR/selectors-4/#invalid

◆ matches()

template<ElementLike T>
bool donner::css::CompoundSelector::matches ( const T & element,
bool requirePrimary,
const SelectorMatchOptions< T > & options ) const
inline

Returns true if the provided element matches this selector.

Template Parameters
TA type that fulfills the ElementLike concept, to enable traversing the tree to match the selector.
Parameters
elementThe element to check.
requirePrimaryIf true, only primary selectors are considered.
optionsOptions to control matching.
The documentation for this struct was generated from the following file: