Skip to main content

Crate muskitty_css_values

Crate muskitty_css_values 

Source
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)。