wp_tinycolor_string_to_rgb

WordPress Version: 5.9

/**
 * Parses hex, hsl, and rgb CSS strings using the same regex as TinyColor v1.4.2
 * used in the JavaScript. Only colors output from react-color are implemented.
 *
 * Direct port of TinyColor's function, lightly simplified to maintain
 * consistency with TinyColor.
 *
 * @see https://github.com/bgrins/TinyColor
 * @see https://github.com/casesandberg/react-color/
 *
 * @since 5.8.0
 * @since 5.9.0 Added alpha processing.
 * @access private
 *
 * @param string $color_str CSS color string.
 * @return array RGB object.
 */
function wp_tinycolor_string_to_rgb($color_str)
{
    $color_str = strtolower(trim($color_str));
    $css_integer = '[-\+]?\d+%?';
    $css_number = '[-\+]?\d*\.\d+%?';
    $css_unit = '(?:' . $css_number . ')|(?:' . $css_integer . ')';
    $permissive_match3 = '[\s|\(]+(' . $css_unit . ')[,|\s]+(' . $css_unit . ')[,|\s]+(' . $css_unit . ')\s*\)?';
    $permissive_match4 = '[\s|\(]+(' . $css_unit . ')[,|\s]+(' . $css_unit . ')[,|\s]+(' . $css_unit . ')[,|\s]+(' . $css_unit . ')\s*\)?';
    $rgb_regexp = '/^rgb' . $permissive_match3 . '$/';
    if (preg_match($rgb_regexp, $color_str, $match)) {
        $rgb = wp_tinycolor_rgb_to_rgb(array('r' => $match[1], 'g' => $match[2], 'b' => $match[3]));
        $rgb['a'] = 1;
        return $rgb;
    }
    $rgba_regexp = '/^rgba' . $permissive_match4 . '$/';
    if (preg_match($rgba_regexp, $color_str, $match)) {
        $rgb = wp_tinycolor_rgb_to_rgb(array('r' => $match[1], 'g' => $match[2], 'b' => $match[3]));
        $rgb['a'] = _wp_tinycolor_bound_alpha($match[4]);
        return $rgb;
    }
    $hsl_regexp = '/^hsl' . $permissive_match3 . '$/';
    if (preg_match($hsl_regexp, $color_str, $match)) {
        $rgb = wp_tinycolor_hsl_to_rgb(array('h' => $match[1], 's' => $match[2], 'l' => $match[3]));
        $rgb['a'] = 1;
        return $rgb;
    }
    $hsla_regexp = '/^hsla' . $permissive_match4 . '$/';
    if (preg_match($hsla_regexp, $color_str, $match)) {
        $rgb = wp_tinycolor_hsl_to_rgb(array('h' => $match[1], 's' => $match[2], 'l' => $match[3]));
        $rgb['a'] = _wp_tinycolor_bound_alpha($match[4]);
        return $rgb;
    }
    $hex8_regexp = '/^#?([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})$/';
    if (preg_match($hex8_regexp, $color_str, $match)) {
        $rgb = wp_tinycolor_rgb_to_rgb(array('r' => base_convert($match[1], 16, 10), 'g' => base_convert($match[2], 16, 10), 'b' => base_convert($match[3], 16, 10)));
        $rgb['a'] = _wp_tinycolor_bound_alpha(base_convert($match[4], 16, 10) / 255);
        return $rgb;
    }
    $hex6_regexp = '/^#?([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})$/';
    if (preg_match($hex6_regexp, $color_str, $match)) {
        $rgb = wp_tinycolor_rgb_to_rgb(array('r' => base_convert($match[1], 16, 10), 'g' => base_convert($match[2], 16, 10), 'b' => base_convert($match[3], 16, 10)));
        $rgb['a'] = 1;
        return $rgb;
    }
    $hex4_regexp = '/^#?([0-9a-fA-F]{1})([0-9a-fA-F]{1})([0-9a-fA-F]{1})([0-9a-fA-F]{1})$/';
    if (preg_match($hex4_regexp, $color_str, $match)) {
        $rgb = wp_tinycolor_rgb_to_rgb(array('r' => base_convert($match[1] . $match[1], 16, 10), 'g' => base_convert($match[2] . $match[2], 16, 10), 'b' => base_convert($match[3] . $match[3], 16, 10)));
        $rgb['a'] = _wp_tinycolor_bound_alpha(base_convert($match[4] . $match[4], 16, 10) / 255);
        return $rgb;
    }
    $hex3_regexp = '/^#?([0-9a-fA-F]{1})([0-9a-fA-F]{1})([0-9a-fA-F]{1})$/';
    if (preg_match($hex3_regexp, $color_str, $match)) {
        $rgb = wp_tinycolor_rgb_to_rgb(array('r' => base_convert($match[1] . $match[1], 16, 10), 'g' => base_convert($match[2] . $match[2], 16, 10), 'b' => base_convert($match[3] . $match[3], 16, 10)));
        $rgb['a'] = 1;
        return $rgb;
    }
    /*
     * The JS color picker considers the string "transparent" to be a hex value,
     * so we need to handle it here as a special case.
     */
    if ('transparent' === $color_str) {
        return array('r' => 0, 'g' => 0, 'b' => 0, 'a' => 0);
    }
}