Expand description
MusKitty CSS Values — CSS Values Level 4 typed value parsing.
实现 CSS Values Level 4 的类型化值解析:数值(length/angle/time/ frequency/resolution/ratio/number/integer)、文本类型(keyword/ident/ string/url)、数学函数 AST(calc/min/max/clamp)、var() 语法解析。
§设计原则
解析与求值分离:本 crate 只构建类型化 AST,不做数值计算和 var() 替换求值(留到 Cascade 阶段)。
§规范依据
- CSS Values Level 4:
d:\csswg\css-values-4\Overview.md - CSS Variables Level 1:
d:\csswg\css-variables-1\Overview.md
§快速上手
use muskitty_css_values::parse_length;
let len = parse_length("10px").unwrap();
assert_eq!(len.value, 10.0);通过 grammar hook 解析任意类型化值:
use muskitty_css_values::{parse_value, grammar::ValueKind};
let v = parse_value("45deg", ValueKind::Angle).unwrap();
println!("{:?}", v);Modules§
- grammar
- Grammar trait 接入 — CSS Syntax §5.4.1。
- math
- 数学表达式 AST — CSS Values Level 4 §9。
- numeric
- 数值类型 — CSS Values Level 4 §4-§6。
- serialize
- 序列化 — CSS Values Level 4 §8.1 + §9.7 calc-serialize。
- textual
- 文本类型 — CSS Values Level 4 §3。
- var
- var() 语法解析 — CSS Variables Level 1 §3。
Functions§
- parse_
calc - 解析一个 calc() 数学表达式(也接受 min/max/clamp)。
- parse_
integer - 解析一个
<integer>值。 - parse_
length - 解析一个
<length>值。 - parse_
number - 解析一个
<number>值。 - parse_
percentage - 解析一个
<percentage>值。 - parse_
value - 通过 grammar hook(§5.4.1
parse_a_grammar)解析任意类型化值。 - parse_
var - 解析一个 var() 引用(含 fallback)。