@wix/css-property-parser
Version:
A comprehensive TypeScript library for parsing and serializing CSS property values with full MDN specification compliance
69 lines (68 loc) • 2.31 kB
JavaScript
// Shared border color evaluator
// Provides parsing and serialization for individual border color properties
// Used by border-top-color, border-right-color, border-bottom-color, border-left-color
import { parse as parseColor, toCSSValue as colorToCSSValue } from './color.js';
import { isCssVariable, isGlobalKeyword } from '../utils/shared-utils.js';
import { parse as parseCSSVariable, toCSSValue as cssVariableToCSSValue } from './css-variable.js';
/**
* Check if value is a border color keyword
*/
function isBorderColorKeyword(value) {
return value.toLowerCase() === 'currentcolor';
}
/**
* Parse a border color property value (color value or keyword)
* Accepts color values and border color keywords (currentcolor)
*
* @param value - CSS border color value string
* @returns Parsed border color value or null if invalid
*/
export function parseBorderColorProperty(value) {
if (!value || typeof value !== 'string') {
return null;
}
const trimmed = value.trim();
if (trimmed === '') {
return null;
}
// CSS variables - return proper CSSVariable object
if (isCssVariable(trimmed)) {
return parseCSSVariable(trimmed);
}
// Global keywords
if (isGlobalKeyword(trimmed)) {
return { type: 'keyword', keyword: trimmed.toLowerCase() };
}
// Border color keyword (currentcolor)
if (isBorderColorKeyword(trimmed)) {
return { type: 'keyword', keyword: 'currentcolor' };
}
// Color values - delegate to color evaluator
const colorResult = parseColor(trimmed);
if (colorResult && 'format' in colorResult) {
// Only return actual color values, not CSS variables
return colorResult;
}
return null;
}
/**
* Convert a border color property value back to CSS string
*
* @param parsed - Parsed border color value
* @returns CSS string representation or null if invalid
*/
export function borderColorToCSSValue(parsed) {
if (!parsed) {
return null;
}
// Handle CSS variables
if ('CSSvariable' in parsed) {
return cssVariableToCSSValue(parsed);
}
// Handle keyword values (global keywords and currentcolor)
if ('keyword' in parsed) {
return parsed.keyword;
}
// Handle color values
return colorToCSSValue(parsed);
}