dymokomi/luce-browser-engine
Source of release 0.6.1
0.6.1 / src / web / css / css_page_rule.lucb
#==============================================================================================
#
# css_page_rule - CSS::CSSPageRule: an @page rule (selectors, descriptors, margin rules)
#
# DESCRIPTION:
# Port of LibWeb/CSS/CSSPageRule.cpp (lines 1-112) and the inline members of
# CSSPageRule.h (lines 17-41); the PageSelector formatter of CSSPageRule.h (lines 45-55)
# is PageSelector::serialize, which its users call.
#
# Copyright (c) 2025, Sam Atkins <sam@ladybird.org>
# SPDX-License-Identifier: BSD-2-Clause
#
#==============================================================================================
## Ported from Libraries/LibWeb/CSS/CSSPageRule.h:29 Web::CSS::CSSPageRule::style.
pub func css_page_rule_style(this: CssPageRule*) -> CssPageDescriptors*:
return this.m_style
## Ported from Libraries/LibWeb/CSS/CSSPageRule.h:29 Web::CSS::CSSPageRule::descriptors.
pub func css_page_rule_descriptors(this: CssPageRule*) -> CssPageDescriptors*:
return this.m_style
## Ported from Libraries/LibWeb/CSS/CSSPageRule.cpp:19 Web::CSS::CSSPageRule::create.
pub func css_page_rule_create(realm: Realm*, selectors: ak.Vector[CssPageSelector], style: CssPageDescriptors*, rules: CssRuleList*) -> CssPageRule*:
return realm_create_css_page_rule(realm, realm, selectors, style, rules)
## Ported from Libraries/LibWeb/CSS/CSSPageRule.cpp:21 Web::CSS::CSSPageRule::CSSPageRule.
pub func css_page_rule_construct(this: CssPageRule*, realm: Realm*, selectors: ak.Vector[CssPageSelector], style: CssPageDescriptors*, rules: CssRuleList*):
css_grouping_rule_construct(this.css_grouping_rule(), realm, rules, CssRuleType.page)
this.m_selectors = selectors
this.m_style = style
css_style_declaration_set_parent_rule(this.m_style.css_style_declaration(), this.css_rule())
## Ported from Libraries/LibWeb/CSS/CSSPageRule.cpp:32 Web::CSS::CSSPageRule::initialize (override).
pub func css_page_rule_initialize_impl(base: JsCell*, realm: Realm*):
web_set_prototype_for_interface(base, realm, BindInterfaceName.css_page_rule)
css_grouping_rule_initialize_impl(base, realm)
## Ported from Libraries/LibWeb/CSS/CSSPageRule.cpp:39 Web::CSS::CSSPageRule::selector_text.
# https://drafts.csswg.org/cssom/#dom-csspagerule-selectortext
pub func css_page_rule_selector_text(this: CssPageRule*) -> ak.String:
# The selectorText attribute, on getting, must return the result of serializing the associated selector list.
# https://www.w3.org/TR/cssom/#serialize-a-group-of-selectors
# To serialize a group of selectors serialize each selector in the group of selectors and then serialize a comma-separated list of these serializations.
var builder = ak.string_builder_new()
for i in 0..<ak.vector_size(&this.m_selectors):
if i != 0:
ak.string_builder_append(&builder, ", ")
let selector = css_page_selector_serialize(ak.vector_at(&this.m_selectors, i))
ak.string_builder_append_string_view(&builder, ak.string_bytes_as_string_view(&selector))
return ak.string_builder_to_string(&builder) else trap("MUST: String::join")
## Ported from Libraries/LibWeb/CSS/CSSPageRule.cpp:49 Web::CSS::CSSPageRule::set_selector_text.
# https://drafts.csswg.org/cssom/#dom-csspagerule-selectortext
pub func css_page_rule_set_selector_text(this: CssPageRule*, text: ak.StringView):
# On setting the selectorText attribute these steps must be run:
# 1. Run the parse a list of CSS page selectors algorithm on the given value.
var parsing_params: CssParsingParams = ---
css_parsing_params_construct_css_parsing_mode(&parsing_params)
let page_selector_list = parse_page_selector_list(parsing_params, text)
# 2. If the algorithm returns a non-null value replace the associated selector list with the returned value.
if let selectors = page_selector_list:
this.m_selectors = selectors
# 3. Otherwise, if the algorithm returns a null value, do nothing.
## Ported from Libraries/LibWeb/CSS/CSSPageRule.cpp:63 Web::CSS::CSSPageRule::serialized (override).
# https://drafts.csswg.org/cssom/#ref-for-csspagerule
pub func css_page_rule_serialized_impl(base: CssRule*) -> ak.String:
let this = (CssPageRule*)base
let descriptors = this.m_style.css_style_declaration()
let rules = css_grouping_rule_css_rules(this.css_grouping_rule())
var builder = ak.string_builder_new()
# AD-HOC: There's no spec for this yet, but Chrome puts declarations before margin rules.
ak.string_builder_append(&builder, "@page ")
let selector = css_page_rule_selector_text(this)
if not ak.string_is_empty(&selector):
dump_appendff(&builder, "{} ", [css_arg_string(&selector)])
ak.string_builder_append(&builder, "{ ")
if css_style_declaration_length(descriptors) > 0:
let text = css_style_declaration_serialized(descriptors)
ak.string_builder_append_string_view(&builder, ak.string_bytes_as_string_view(&text))
ak.string_builder_append_u8(&builder, ' ')
for i in 0..<css_rule_list_length(rules):
let rule = css_rule_list_item(rules, i) else trap("null rule")
let result = css_rule_css_text(rule)
if ak.string_is_empty(&result):
continue
dump_appendff(&builder, "{} ", [css_arg_string(&result)])
ak.string_builder_append(&builder, "}")
return ak.string_builder_to_string_without_validation(&builder)
## Ported from Libraries/LibWeb/CSS/CSSPageRule.cpp:92 Web::CSS::CSSPageRule::visit_edges (override).
pub func css_page_rule_visit_edges_impl(base: gc.Cell*, visitor: gc.CellVisitor*):
let this = (CssPageRule*)base
css_grouping_rule_visit_edges_impl(base, visitor)
gc.cell_visitor_visit_t_2(visitor, this.m_style)
## Ported from Libraries/LibWeb/CSS/CSSPageRule.cpp:98 Web::CSS::CSSPageRule::dump (override).
pub func css_page_rule_dump_impl(base: CssRule*, builder: ak.StringBuilder*, indent_levels: i32):
let this = (CssPageRule*)base
let rules = css_grouping_rule_css_rules(this.css_grouping_rule())
css_rule_dump_impl(base, builder, indent_levels)
dump_indent(builder, indent_levels + 1)
let selector = css_page_rule_selector_text(this)
dump_appendff(builder, "Selector: {}\n", [css_arg_string(&selector)])
dump_descriptors(builder, css_page_rule_descriptors(this).css_descriptors(), indent_levels + 1)
dump_indent(builder, indent_levels + 1)
dump_appendff(builder, "Rules ({}):\n", [ak.arg_u64((u64)css_rule_list_length(rules))])
for rule in ak.vector_span(&rules.m_rules):
dump_rule_string_builder(builder, rule, indent_levels + 2)