readCssLengthVar
读取 CSS 自定义属性长度(支持 rem / px),失败时返回 fallback 像素值。
前置依赖
依赖参数
| 参数名 | 类型 | 说明 |
|---|---|---|
options.getPropertyValue | (propertyName: string) => string | 读取 CSS 变量原始值,通常来自 getComputedStyle |
options.rootFontSizePx | number | 可选,解析 rem 时的根字号,默认 16 |
函数签名
typescript
function readCssLengthVar(
name: string,
fallbackPx: number,
options: {
getPropertyValue: (propertyName: string) => string
rootFontSizePx?: number
},
): number参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | CSS 变量名,如 '--launcher-topbar-height' |
fallbackPx | number | 是 | 变量缺失或无法解析时的像素回退值 |
options.getPropertyValue | function | 是 | 注入的 DOM 读取函数 |
options.rootFontSizePx | number | 否 | rem 换算基准,默认 16 |
返回值
| 类型 | 说明 |
|---|---|
number | 解析后的像素长度 |
工作原理
- 调用
getPropertyValue(name)并trim;空字符串返回fallbackPx。 - 以
rem结尾:解析浮点数后乘以rootFontSizePx。 - 以
px结尾:直接解析浮点数。 - 否则尝试解析裸数字;任一环节非有限数则回退
fallbackPx。