mirror of
https://github.com/RGBCube/serenity
synced 2025-07-25 05:27:43 +00:00
LibWeb: Clarify naming and publicity of CSS Parser methods
`parse_as_foo()` implies that the Parser's internal data is used, whereas `parse_a_foo()` implies that the passed-in data is used. Also, made all the `parse_a_foo()` methods private, as they are only required within the Parser, and this makes the API clearer to outsiders. The `parse_a(s)_foo()` naming is a little awkward, but it comes from section 5.3 of the spec, so seemed worth keeping: https://www.w3.org/TR/css-syntax-3/#parser-entry-points
This commit is contained in:
parent
f4b3ab19c0
commit
eadcdd21e3
2 changed files with 51 additions and 59 deletions
|
@ -75,59 +75,56 @@ public:
|
|||
|
||||
// The normal parser entry point, for parsing stylesheets.
|
||||
NonnullRefPtr<CSSStyleSheet> parse_as_stylesheet();
|
||||
template<typename T>
|
||||
NonnullRefPtr<CSSStyleSheet> parse_as_stylesheet(TokenStream<T>&);
|
||||
|
||||
// For the content of at-rules such as @media. It differs from "Parse a stylesheet" in the handling of <CDO-token> and <CDC-token>.
|
||||
NonnullRefPtrVector<CSSRule> parse_as_list_of_rules();
|
||||
template<typename T>
|
||||
NonnullRefPtrVector<CSSRule> parse_as_list_of_rules(TokenStream<T>&);
|
||||
|
||||
// For use by the CSSStyleSheet#insertRule method, and similar functions which might exist, which parse text into a single rule.
|
||||
RefPtr<CSSRule> parse_as_rule();
|
||||
template<typename T>
|
||||
RefPtr<CSSRule> parse_as_rule(TokenStream<T>&);
|
||||
|
||||
// Used in @supports conditions. [CSS3-CONDITIONAL]
|
||||
Optional<StyleProperty> parse_as_declaration();
|
||||
template<typename T>
|
||||
Optional<StyleProperty> parse_as_declaration(TokenStream<T>&);
|
||||
|
||||
// For the contents of a style attribute, which parses text into the contents of a single style rule.
|
||||
RefPtr<CSSStyleDeclaration> parse_as_list_of_declarations();
|
||||
template<typename T>
|
||||
RefPtr<CSSStyleDeclaration> parse_as_list_of_declarations(TokenStream<T>&);
|
||||
|
||||
// For things that need to consume a single value, like the parsing rules for attr().
|
||||
Optional<StyleComponentValueRule> parse_as_component_value();
|
||||
template<typename T>
|
||||
Optional<StyleComponentValueRule> parse_as_component_value(TokenStream<T>&);
|
||||
|
||||
// For the contents of presentational attributes, which parse text into a single declaration’s value, or for parsing a stand-alone selector [SELECT] or list of Media Queries [MEDIAQ], as in Selectors API or the media HTML attribute.
|
||||
Vector<StyleComponentValueRule> parse_as_list_of_component_values();
|
||||
template<typename T>
|
||||
Vector<StyleComponentValueRule> parse_as_list_of_component_values(TokenStream<T>&);
|
||||
|
||||
Vector<Vector<StyleComponentValueRule>> parse_as_comma_separated_list_of_component_values();
|
||||
template<typename T>
|
||||
Vector<Vector<StyleComponentValueRule>> parse_as_comma_separated_list_of_component_values(TokenStream<T>&);
|
||||
|
||||
Optional<Selector::SimpleSelector::ANPlusBPattern> parse_a_n_plus_b_pattern(TokenStream<StyleComponentValueRule>&);
|
||||
|
||||
// FIXME: https://www.w3.org/TR/selectors-4/
|
||||
// Contrary to the name, these parse a comma-separated list of selectors, according to the spec.
|
||||
Optional<SelectorList> parse_a_selector();
|
||||
template<typename T>
|
||||
Optional<SelectorList> parse_a_selector(TokenStream<T>&);
|
||||
|
||||
Optional<SelectorList> parse_a_relative_selector();
|
||||
template<typename T>
|
||||
Optional<SelectorList> parse_a_relative_selector(TokenStream<T>&);
|
||||
Optional<SelectorList> parse_as_selector();
|
||||
Optional<SelectorList> parse_as_relative_selector();
|
||||
|
||||
// FIXME: These want to be private, but StyleResolver still uses them for now.
|
||||
RefPtr<StyleValue> parse_css_value(PropertyID, TokenStream<StyleComponentValueRule>&);
|
||||
static RefPtr<StyleValue> parse_css_value(ParsingContext const&, PropertyID, StyleComponentValueRule const&);
|
||||
|
||||
private:
|
||||
template<typename T>
|
||||
NonnullRefPtr<CSSStyleSheet> parse_a_stylesheet(TokenStream<T>&);
|
||||
template<typename T>
|
||||
NonnullRefPtrVector<CSSRule> parse_a_list_of_rules(TokenStream<T>&);
|
||||
template<typename T>
|
||||
RefPtr<CSSRule> parse_a_rule(TokenStream<T>&);
|
||||
template<typename T>
|
||||
Optional<StyleProperty> parse_a_declaration(TokenStream<T>&);
|
||||
template<typename T>
|
||||
RefPtr<CSSStyleDeclaration> parse_a_list_of_declarations(TokenStream<T>&);
|
||||
template<typename T>
|
||||
Optional<StyleComponentValueRule> parse_a_component_value(TokenStream<T>&);
|
||||
template<typename T>
|
||||
Vector<StyleComponentValueRule> parse_a_list_of_component_values(TokenStream<T>&);
|
||||
template<typename T>
|
||||
Vector<Vector<StyleComponentValueRule>> parse_a_comma_separated_list_of_component_values(TokenStream<T>&);
|
||||
template<typename T>
|
||||
Optional<SelectorList> parse_a_selector(TokenStream<T>&);
|
||||
template<typename T>
|
||||
Optional<SelectorList> parse_a_relative_selector(TokenStream<T>&);
|
||||
template<typename T>
|
||||
Optional<SelectorList> parse_a_selector_list(TokenStream<T>&);
|
||||
template<typename T>
|
||||
Optional<SelectorList> parse_a_relative_selector_list(TokenStream<T>&);
|
||||
|
||||
Optional<Selector::SimpleSelector::ANPlusBPattern> parse_a_n_plus_b_pattern(TokenStream<StyleComponentValueRule>&);
|
||||
|
||||
[[nodiscard]] NonnullRefPtrVector<StyleRule> consume_a_list_of_rules(bool top_level);
|
||||
template<typename T>
|
||||
[[nodiscard]] NonnullRefPtrVector<StyleRule> consume_a_list_of_rules(TokenStream<T>&, bool top_level);
|
||||
|
@ -191,11 +188,6 @@ private:
|
|||
static OwnPtr<CalculatedStyleValue::CalcNumberSumPartWithOperator> parse_calc_number_sum_part_with_operator(ParsingContext const&, TokenStream<StyleComponentValueRule>&);
|
||||
static OwnPtr<CalculatedStyleValue::CalcSum> parse_calc_expression(ParsingContext const&, Vector<StyleComponentValueRule> const&);
|
||||
|
||||
template<typename T>
|
||||
Optional<SelectorList> parse_a_selector_list(TokenStream<T>&);
|
||||
template<typename T>
|
||||
Optional<SelectorList> parse_a_relative_selector_list(TokenStream<T>&);
|
||||
|
||||
enum class SelectorParsingResult {
|
||||
Done,
|
||||
SyntaxError,
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue