Skip to content

DOM and styles API

addCssUnit Units

Adds CSS units to numbers or numeric strings.

Signature

ts
export function addCssUnit(value?: string | number | null, unit = "px"): string;

Example

ts
import { addCssUnit } from "@fast-china/utils";

const result = addCssUnit(12);

Input

InputTypeRequired / defaultDescription
valuestring | number | nullOptionalNumber, numeric string, or CSS value with units; nullish values return an empty string.
unitunknownOptional; defaults to "px"Unit for nonzero numbers; defaults to px.

Returns

ValueTypeDescription
resultstringZero always becomes "0"; nonnumeric strings remain unchanged.

serializeStyle Styles

Serializes style strings, objects, or nested arrays into inline CSS.

Signature

ts
export function serializeStyle(styles: StyleInput): string;

Example

ts
import { serializeStyle } from "@fast-china/utils";

const result = serializeStyle({ color: "red", width: 12 });

Input

InputTypeRequired / defaultDescription
stylesStyleInputRequiredPossibly nested style input; later declarations override earlier ones through the CSS cascade.

Returns

ValueTypeDescription
resultstringSpace-separated CSS declarations ending in semicolons.