ladybird/Libraries/LibWeb/CSS/CSSRule.h
Sam Atkins ee24561ab4 LibWeb/CSS: Store source positions on CSS rules
DevTools needs rule-level source positions to link applied style
rules back to their source sheets. The parser already tracks token
line and column information, so carry that through qualified rules
and nested declarations when creating CSSRule objects.
2026-06-04 20:54:33 +01:00

98 lines
2.9 KiB
C++

/*
* Copyright (c) 2021, the SerenityOS developers.
* Copyright (c) 2022, Andreas Kling <andreas@ladybird.org>
*
* SPDX-License-Identifier: BSD-2-Clause
*/
#pragma once
#include <AK/String.h>
#include <LibGC/Ptr.h>
#include <LibWeb/Bindings/PlatformObject.h>
#include <LibWeb/CSS/CSSStyleDeclaration.h>
#include <LibWeb/CSS/Selector.h>
#include <LibWeb/Export.h>
#include <LibWeb/WebIDL/Types.h>
namespace Web::CSS {
class WEB_API CSSRule : public Bindings::PlatformObject {
WEB_PLATFORM_OBJECT(CSSRule, Bindings::PlatformObject);
public:
virtual ~CSSRule() = default;
// https://drafts.csswg.org/cssom/#dom-cssrule-type
enum class Type : WebIDL::UnsignedShort {
Style = 1,
Import = 3,
Media = 4,
FontFace = 5,
Page = 6,
Keyframes = 7,
Keyframe = 8,
Margin = 9,
Namespace = 10,
CounterStyle = 11,
Supports = 12,
FontFeatureValues = 14,
// AD-HOC: These are not included in the spec, but we need them internally. So, their numbers are arbitrary.
LayerBlock = 100,
LayerStatement = 101,
NestedDeclarations = 102,
Property = 103,
Function = 104,
FunctionDeclarations = 105,
Container = 106,
Scope = 107,
};
Type type() const { return m_type; }
WebIDL::UnsignedShort type_for_bindings() const;
String css_text() const;
void set_css_text(StringView);
CSSRule* parent_rule() { return m_parent_rule.ptr(); }
CSSRule const* parent_rule() const { return m_parent_rule.ptr(); }
void set_parent_rule(CSSRule*);
CSSStyleSheet* parent_style_sheet() { return m_parent_style_sheet.ptr(); }
CSSStyleSheet const* parent_style_sheet() const { return m_parent_style_sheet.ptr(); }
MUST_UPCALL virtual void set_parent_style_sheet(CSSStyleSheet*);
Optional<SourcePosition> const& source_location() const { return m_source_position; }
void set_source_position(Optional<SourcePosition> source_location) { m_source_position = move(source_location); }
template<typename T>
bool fast_is() const = delete;
// https://drafts.csswg.org/cssom-1/#serialize-a-css-rule
virtual String serialized() const = 0;
MUST_UPCALL virtual void dump(StringBuilder&, int indent_levels = 0) const;
MUST_UPCALL virtual void clear_caches();
protected:
CSSRule(JS::Realm&, Type);
virtual void visit_edges(Cell::Visitor&) override;
[[nodiscard]] FlyString const& parent_layer_internal_qualified_name() const
{
return m_cached_layer_name.ensure([&] { return parent_layer_internal_qualified_name_slow_case(); });
}
[[nodiscard]] FlyString parent_layer_internal_qualified_name_slow_case() const;
Type m_type;
GC::Ptr<CSSRule> m_parent_rule;
GC::Ptr<CSSStyleSheet> m_parent_style_sheet;
Optional<SourcePosition> m_source_position;
mutable Optional<FlyString> m_cached_layer_name;
};
}