Automattic\WooCommerce\EmailEditor\Integrations\Utils

Html_Processing_Helper::sanitize_dimension_value │ public static │ WC 1.0

Sanitize dimension value to ensure it's a valid CSS dimension.

Supports numeric values (converted to px) and standard CSS units.

Method of the class: Html_Processing_Helper{}

No Hooks.

Returns

String. Sanitized dimension value or empty string if invalid.

Usage

$result = Html_Processing_Helper::sanitize_dimension_value( $value ): string;

$value(mixed) (required)

The dimension value to sanitize.

Html_Processing_Helper::sanitize_dimension_value() Html Processing Helper::sanitize dimension value code ^{WC 10.4.3}

public static function sanitize_dimension_value( $value ): string {
	if ( ! is_string( $value ) && ! is_numeric( $value ) ) {
		return '';
	}

	$value = (string) $value;

	// If it's just a number, assume pixels.
	if ( is_numeric( $value ) ) {
		$value = $value . 'px';
	}

	// Use existing CSS value sanitization for security.
	$sanitized_value = self::sanitize_css_value( $value );

	// Additional validation for dimension-specific units.
	if ( ! empty( $sanitized_value ) && preg_match( '/^(\d+(?:\.\d+)?)(px|em|rem|%|vh|vw|ex|ch|in|cm|mm|pt|pc)$/', $sanitized_value ) ) {
		return $sanitized_value;
	}

	return '';
}