lengthToPx

Convert a CSS length string such as px, rem, or em into a pixel number, with a configurable fallback for unrecognized values.

Usage

lengthToPx converts a CSS length string into a pixel value. It supports px, rem, and em units, where rem/em are resolved at a base of 16; a unitless value is treated as px; unrecognized values fall back to fallback.

import { lengthToPx } from '@movk/core'

lengthToPx('24px') // 24
lengthToPx('1rem') // 16
lengthToPx('2.5em') // 40
lengthToPx('16') // 16 (unitless treated as px)

Custom Fallback

lengthToPx('auto') // 16 (default fallback)
lengthToPx('auto', 0) // 0
lengthToPx('', 8) // 8 (empty string fallback)

API

lengthToPx(value, fallback?)

Convert a CSS length string into a pixel value.

Parameters

value
string required
A CSS length string such as '16px', '1rem', or '2.5em'.
fallback
number
Fallback pixel value when the input cannot be recognized. Defaults to 16.

Returns

returns
number
The resolved pixel value.

Changelog

No recent changes
Copyright © 2024 - 2026 YiXuan - MIT License