/* * Copyright (c) 2021-2025, Sam Atkins * * SPDX-License-Identifier: BSD-2-Clause */ #include #include #include #include #include #include #include #include #include #include #include #include #include namespace Web::CSS { GC_DEFINE_ALLOCATOR(CSSRuleList); GC::Ref CSSRuleList::create(JS::Realm& realm, ReadonlySpan> rules) { auto rule_list = realm.create(realm); for (auto rule : rules) rule_list->m_rules.append(rule); return rule_list; } CSSRuleList::CSSRuleList(JS::Realm& realm) : Bindings::PlatformObject(realm) { m_legacy_platform_object_flags = LegacyPlatformObjectFlags { .supports_indexed_properties = 1 }; } void CSSRuleList::initialize(JS::Realm& realm) { WEB_SET_PROTOTYPE_FOR_INTERFACE(CSSRuleList); Base::initialize(realm); } void CSSRuleList::visit_edges(Cell::Visitor& visitor) { Base::visit_edges(visitor); visitor.visit(m_rules); visitor.visit(m_owner_rule); } // https://drafts.csswg.org/cssom/#insert-a-css-rule WebIDL::ExceptionOr CSSRuleList::insert_a_css_rule(Variant rule, u32 index, Nested nested) { // 1. Set length to the number of items in list. auto length = m_rules.size(); // 2. If index is greater than length, then throw an IndexSizeError exception. if (index > length) return WebIDL::IndexSizeError::create(realm(), "CSS rule index out of bounds."_string); // 3. Set new rule to the results of performing parse a CSS rule on argument rule. // NOTE: The insert-a-css-rule spec expects `rule` to be a string, but the CSSStyleSheet.insertRule() // spec calls this algorithm with an already-parsed CSSRule. So, we use a Variant and skip step 3 // if that variant holds a CSSRule already. Parser::ParsingParams parsing_params { realm() }; parsing_params.rule_context = rule_context(); CSSRule* new_rule = nullptr; if (rule.has()) { new_rule = parse_css_rule(parsing_params, rule.get()); } else { new_rule = rule.get(); } // 4. If new rule is a syntax error, and nested is set, perform the following substeps: if (!new_rule && nested == Nested::Yes) { // - Set declarations to the results of performing parse a CSS declaration block, on argument rule. auto declarations = parse_css_property_declaration_block(parsing_params, rule.get()); // - If declarations is empty, throw a SyntaxError exception. if (declarations.custom_properties.is_empty() && declarations.properties.is_empty()) return WebIDL::SyntaxError::create(realm(), "Unable to parse CSS declarations block."_string); // - Otherwise, set new rule to a new nested declarations rule with declarations as it contents. new_rule = CSSNestedDeclarations::create(realm(), CSSStyleProperties::create(realm(), move(declarations.properties), move(declarations.custom_properties))); } // 5. If new rule is a syntax error, throw a SyntaxError exception. if (!new_rule) return WebIDL::SyntaxError::create(realm(), "Unable to parse CSS rule."_string); // FIXME: 6. If new rule cannot be inserted into list at the zero-index position index due to constraints specified by CSS, then throw a HierarchyRequestError exception. [CSS21] // FIXME: 7. If new rule is an @namespace at-rule, and list contains anything other than @import at-rules, and @namespace at-rules, throw an InvalidStateError exception. // 8. Insert new rule into list at the zero-indexed position index. m_rules.insert(index, *new_rule); // 9. Return index. if (on_change) on_change(); return index; } // https://www.w3.org/TR/cssom/#remove-a-css-rule WebIDL::ExceptionOr CSSRuleList::remove_a_css_rule(u32 index) { // 1. Set length to the number of items in list. auto length = m_rules.size(); // 2. If index is greater than or equal to length, then throw an IndexSizeError exception. if (index >= length) return WebIDL::IndexSizeError::create(realm(), "CSS rule index out of bounds."_string); // 3. Set old rule to the indexth item in list. CSSRule& old_rule = m_rules[index]; // 4. If old rule is an @namespace at-rule, and list contains anything other than @import at-rules, and @namespace at-rules, throw an InvalidStateError exception. if (old_rule.type() == CSSRule::Type::Namespace) { for (auto& rule : m_rules) { if (rule->type() != CSSRule::Type::Import && rule->type() != CSSRule::Type::Namespace) return WebIDL::InvalidStateError::create(realm(), "Cannot remove @namespace rule from a stylesheet with non-namespace/import rules."_string); } } // 5. Remove rule old rule from list at the zero-indexed position index. m_rules.remove(index); // 6. Set old rule’s parent CSS rule and parent CSS style sheet to null. old_rule.set_parent_rule(nullptr); old_rule.set_parent_style_sheet(nullptr); if (on_change) on_change(); return {}; } void CSSRuleList::for_each_effective_rule(TraversalOrder order, Function const& callback) const { for (auto const& rule : m_rules) { if (order == TraversalOrder::Preorder) callback(rule); switch (rule->type()) { case CSSRule::Type::Import: { auto const& import_rule = static_cast(*rule); if (import_rule.loaded_style_sheet()) import_rule.loaded_style_sheet()->for_each_effective_rule(order, callback); break; } case CSSRule::Type::LayerBlock: case CSSRule::Type::Media: case CSSRule::Type::Style: case CSSRule::Type::Supports: static_cast(*rule).for_each_effective_rule(order, callback); break; case CSSRule::Type::FontFace: case CSSRule::Type::Keyframe: case CSSRule::Type::Keyframes: case CSSRule::Type::LayerStatement: case CSSRule::Type::Namespace: case CSSRule::Type::NestedDeclarations: case CSSRule::Type::Property: break; } if (order == TraversalOrder::Postorder) callback(rule); } } bool CSSRuleList::evaluate_media_queries(HTML::Window const& window) { bool any_media_queries_changed_match_state = false; for (auto& rule : m_rules) { switch (rule->type()) { case CSSRule::Type::Import: { auto& import_rule = as(*rule); if (import_rule.loaded_style_sheet() && import_rule.loaded_style_sheet()->evaluate_media_queries(window)) any_media_queries_changed_match_state = true; break; } case CSSRule::Type::LayerBlock: { auto& layer_rule = as(*rule); if (layer_rule.css_rules().evaluate_media_queries(window)) any_media_queries_changed_match_state = true; break; } case CSSRule::Type::Media: { auto& media_rule = as(*rule); bool did_match = media_rule.condition_matches(); bool now_matches = media_rule.evaluate(window); if (did_match != now_matches) any_media_queries_changed_match_state = true; if (now_matches && media_rule.css_rules().evaluate_media_queries(window)) any_media_queries_changed_match_state = true; break; } case CSSRule::Type::Supports: { auto& supports_rule = as(*rule); if (supports_rule.condition_matches() && supports_rule.css_rules().evaluate_media_queries(window)) any_media_queries_changed_match_state = true; break; } case CSSRule::Type::Style: { auto& style_rule = as(*rule); if (style_rule.css_rules().evaluate_media_queries(window)) any_media_queries_changed_match_state = true; break; } case CSSRule::Type::FontFace: case CSSRule::Type::Keyframe: case CSSRule::Type::Keyframes: case CSSRule::Type::LayerStatement: case CSSRule::Type::Namespace: case CSSRule::Type::NestedDeclarations: case CSSRule::Type::Property: break; } } return any_media_queries_changed_match_state; } Optional CSSRuleList::item_value(size_t index) const { if (auto value = item(index)) return value; return {}; } Vector CSSRuleList::rule_context() const { Vector context; for (auto* rule = m_owner_rule.ptr(); rule; rule = rule->parent_rule()) context.append(Parser::rule_context_type_for_rule(rule->type())); context.reverse(); return context; } }