Mirrors/servo
1
0
Fork 0
mirror of https://github.com/servo/servo.git synced 2025-07-29 18:20:24 +01:00
Code Issues Projects Releases Packages Wiki Activity

style: Add doc-comment about is_eagerly_cascaded_pseudo_element

Browse source
This commit is contained in:
Emilio Cobos Álvarez 2016-04-28 03:19:43 +02:00 • committed by Emilio Cobos Álvarez
parent 2dbd17040a
commit f12e4b826f
No known key found for this signature in database
GPG key ID: 056B727BB9C1027C
1 changed files with 18 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

18
components/style/selector_impl.rs
View file

@ -18,6 +18,24 @@ pub trait SelectorImplExt : SelectorImpl + Sized {
fn each_pseudo_element<F>(mut fun: F)
where F: FnMut(<Self as SelectorImpl>::PseudoElement);
/// This function determines if a pseudo-element is eagerly cascaded or not.
///
/// Eagerly cascaded pseudo-elements are "normal" pseudo-elements (i.e.
/// `::before` and `::after`). They inherit styles normally as another
/// selector would do.
///
/// Non-eagerly cascaded ones skip the cascade process entirely, mostly as
/// an optimisation since they are private pseudo-elements (like
/// `::-servo-details-content`). This pseudo-elements are resolved on the
/// fly using global rules (rules of the form `*|*`), and applying them to
/// the parent style.
///
/// If you're implementing a public selector that the end-user might
/// customize, then you probably need doing the whole cascading process and
/// return true in this function for that pseudo.
///
/// But if you are implementing a private pseudo-element, please consider if
/// it might be possible to skip the cascade for it.
fn is_eagerly_cascaded_pseudo_element(pseudo: &<Self as SelectorImpl>::PseudoElement) -> bool;
#[inline]