sanitize_hex_color_no_hash( string $color )

Sanitizes a hex color without a hash. Use sanitize_hex_color() when possible.

Description

Saving hex colors without a hash puts the burden of adding the hash on the UI, which makes it difficult to use or upgrade to other color types such as rgba, hsl, rgb, and HTML color names.

Returns either ”, a 3 or 6 digit hex color (without a #), or null.

Parameters

$color: (string) (Required)

Return

(string|null)

Source

File: wp-includes/formatting.php

function sanitize_hex_color_no_hash( $color ) {
	$color = ltrim( $color, '#' );

	if ( '' === $color ) {
		return '';
	}

	return sanitize_hex_color( '#' . $color ) ? $color : null;
}

Uses

Uses	Description
wp-includes/formatting.php: sanitize_hex_color()	Sanitizes a hex color.

Used By

Used By	Description
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::_sanitize_header_textcolor()	Callback for validating the header_textcolor value.
wp-includes/formatting.php: maybe_hash_hex_color()	Ensures that any hex color is properly hashed.

Changelog

Version	Description
3.4.0	Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/sanitize_hex_color_no_hash