Skip to main content

Crate muskitty_cssom

Crate muskitty_cssom 

Source
Expand description

MusKitty CSSOM — CSS Object Model 数据结构层。

将 css-parser 的语法层结构(Stylesheet/Rule/AtRule/ QualifiedRule/Declaration,CSS Syntax §5.2)映射到 CSSOM 语义层结构(CssStyleSheet/CssStyleRule/CssMediaRule/ CssStyleDeclaration 等,CSSOM §8)。

§设计

单向转换:语法→语义是 one-way 的。转换后 CSSOM 树独立存在, 不反向引用 css-parser 的 Stylesheet,避免生命周期耦合。

枚举分发:CssRule 用 Rust enum 而非 trait 对象,符合值语义, pattern matching 清晰,避免 Rc<RefCell<>> 所有权复杂度。

§规范依据

  • CSSOM: d:\csswg\cssom-1\Overview.md(§3 序列化、§8.1 CSSStyleSheet、§8.4 CSS Rules、§8.5 CSS Declarations、§8.6 CSS Declaration Blocks)
  • CSS Syntax: d:\csswg\css-syntax-3\Overview.md(§5.2 数据结构)

§快速上手

use muskitty_cssom::{CssDeclaration, CssStyleDeclaration};

let mut block = CssStyleDeclaration::new();
block.push(CssDeclaration::new("color", Vec::new(), false));
assert_eq!(block.len(), 1);

Re-exports§

pub use convert::from_stylesheet;
pub use convert::from_stylesheet_with_origin;
pub use convert::parse_declaration_block;
pub use declaration::CssDeclaration;
pub use declaration::CssStyleDeclaration;
pub use element_style::ElementStyle;
pub use rule::CssContainerRule;
pub use rule::CssCounterStyleRule;
pub use rule::CssFontFaceRule;
pub use rule::CssImportRule;
pub use rule::CssKeyframeRule;
pub use rule::CssKeyframesRule;
pub use rule::CssLayerBlockRule;
pub use rule::CssLayerStatementRule;
pub use rule::CssMediaRule;
pub use rule::CssNamespaceRule;
pub use rule::CssPageRule;
pub use rule::CssPropertyRule;
pub use rule::CssRule;
pub use rule::CssScopeRule;
pub use rule::CssStyleRule;
pub use rule::CssSupportsRule;
pub use rule::OtherRule;
pub use serialize::serialize_component_value;
pub use serialize::serialize_component_values;
pub use serialize::serialize_identifier;
pub use serialize::serialize_string;
pub use serialize::serialize_url;
pub use serialize::ToCss;
pub use stylesheet::CssStyleSheet;
pub use stylesheet::Origin;

Modules§

convert
从 css-parser 语法层到 CSSOM 语义层的单向转换。
declaration
§8.5 CSS Declarations + §8.6 CSS Declaration Blocks。
element_style
element.style — 把 Element 的 style 属性当作 [CssStyleDeclaration] 读写。参见 CSSOM §4(CSSStyleDeclaration 接口:cssText / getPropertyValue / setProperty / removeProperty)。
rule
§8.4 CSS Rules。
serialize
序列化(CSSOM §3 + §8.4-§8.6)。
stylesheet
§8.1 CSSStyleSheet。

Enums§

ComponentValue
§5.2 L1681-1685: A component value is one of the preserved tokens, a function, or a simple block.