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§
- Component
Value - §5.2 L1681-1685: A component value is one of the preserved tokens, a function, or a simple block.