---
title: "lengthToPx"
description: "将 CSS 长度字符串折算为像素数值，支持 px、rem、em 单位"
seo_title: "lengthToPx"
seo_description: "Convert a CSS length string such as px, rem, or em into a pixel number, with a configurable fallback for unrecognized values."
canonical_url: "https://core.mhaibaraai.cn/docs/utilities/css/length-to-px"
---
# lengthToPx

> 将 CSS 长度字符串折算为像素数值，支持 px、rem、em 单位

## 用法

`lengthToPx` 函数将 CSS 长度字符串折算为像素数值。支持 `px`、`rem`、`em` 单位，其中 `rem`/`em` 按 16 折算；无单位时视为 `px`；无法识别时回退到 `fallback`。

```ts
import { lengthToPx } from '@movk/core'

lengthToPx('24px') // 24
lengthToPx('1rem') // 16
lengthToPx('2.5em') // 40
lengthToPx('16') // 16（无单位视为 px）
```

### 自定义回退值

```ts
lengthToPx('auto') // 16（默认 fallback）
lengthToPx('auto', 0) // 0
lengthToPx('', 8) // 8（空字符串回退）
```

## API

### `lengthToPx(value, fallback?)`

将 CSS 长度字符串折算为像素数值。

### 参数

**value** (`string`) *required*: CSS 长度字符串，如 '16px'、'1rem'、'2.5em'。

**fallback** (`number`): 无法识别时的回退像素值，默认 16。

### 返回值

**返回值** (`number`): 折算后的像素数值。

## Changelog

See commit history for [src/utilities/css/lengthToPx.ts](https://github.com/mhaibaraai/movk-core/commits/main/src/utilities/css/lengthToPx.ts).


## Sitemap

See the full [sitemap](/sitemap.md) for all pages.