servo/components/selectors
Emilio Cobos Álvarez db5db13559
style: Implement the non-functional :host selector.
Kinda tricky because :host only matches rules on the shadow root where the rules
come from. So we need to be careful during invalidation and style sharing.

I didn't use the non_ts_pseudo_class_list bits because as soon as we implement
the :host(..) bits we're going to need to special-case it anyway.

The general schema is the following:

 * Rightmost featureless :host selectors are handled inserting them in the
   host_rules hashmap. Note that we only insert featureless stuff there. We
   could insert all of them and just filter during matching, but that's slightly
   annoying.

 * The other selectors, like non-featureless :host or what not, are added to the
   normal cascade data. This is harmless, since the shadow host rules are never
   matched against the host, so we know they'll just never match, and avoids
   adding more special-cases.

 * Featureless :host selectors to the left of a combinator are handled during
   matching, in the special-case of next_element_for_combinator in selectors.
   This prevents this from being more invasive, and keeps the usual fast path
   slim, but it's a bit hard to match the spec and the implementation.

   We could keep a copy of the SelectorIter instead in the matching context to
   make the handling of featureless-ness explicit in match_non_ts_pseudo_class,
   but we'd still need the special-case anyway, so I'm not fond of it.

 * We take advantage of one thing that makes this sound. As you may have
   noticed, if you had `root` element which is a ShadowRoot, and you matched
   something like `div:host` against it, using a MatchingContext with
   current_host == root, we'd incorrectly report a match. But this is impossible
   due to the following constraints:

    * Shadow root rules aren't matched against the host during styling (except
      these featureless selectors).

    * DOM APIs' current_host needs to be the _containing_ host, not the element
      itself if you're a Shadow host.

Bug: 992245
Reviewed-by: xidorn
MozReview-Commit-ID: KayYNfTXb5h
2018-04-09 12:19:05 +02:00
..
attr.rs Remove useless AsciiExt imports. 2018-03-27 10:30:02 +02:00
bloom.rs Rename the 'unstable' feature of the selectors crate to 'bench' 2017-10-12 17:19:02 +02:00
build.rs Use env::var_os to read paths from the environment 2017-10-20 09:03:21 -07:00
builder.rs style: Implement the non-functional :host selector. 2018-04-09 12:19:05 +02:00
Cargo.toml Bump env_logger to 0.5 and log to 0.4 in every servo crate 2018-03-28 19:50:58 +02:00
context.rs style: Implement the non-functional :host selector. 2018-04-09 12:19:05 +02:00
lib.rs Move selectors size_of tests to Stylo tests 2018-01-12 15:10:56 +01:00
matching.rs style: Implement the non-functional :host selector. 2018-04-09 12:19:05 +02:00
nth_index_cache.rs Implement an nth-index cache. 2017-09-21 15:25:38 -07:00
parser.rs style: Implement the non-functional :host selector. 2018-04-09 12:19:05 +02:00
README.md Move rust-selectors in-tree. 2017-02-07 22:53:10 -08:00
sink.rs Hoist sink into selectors. 2017-06-20 11:59:10 -07:00
tree.rs style: Add infrastructure to match :host. 2018-03-14 15:10:05 +01:00
visitor.rs Document selectors::Visit 2018-01-12 15:40:16 +01:00

rust-selectors

CSS Selectors library for Rust. Includes parsing and serilization of selectors, as well as matching against a generic tree of elements. Pseudo-elements and most pseudo-classes are generic as well.

Warning: breaking changes are made to this library fairly frequently (13 times in 2016, for example). However you can use this crate without updating it that often, old versions stay available on crates.io and Cargo will only automatically update to versions that are numbered as compatible.

To see how to use this library with your own tree representation, see Kuchikis src/select.rs. (Note however that Kuchiki is not always up to date with the latest rust-selectors version, so that code may need to be tweaked.) If you dont already have a tree data structure, consider using Kuchiki itself.