Skip to content

Hex.TextColour

Determines appropriate text color (black/white) for contrast against background

EvaluationContext.Colour.Hex.TextColour( backgroundHex )
Parameter Type Required Description
backgroundHex STRING The background hex color to evaluate (e.g., ■ #01B8AA")

STRING #000000 for dark text or #FFFFFF for light text

EvaluationContext.Colour.Hex.TextColour("#5E81AC") // Returns "#FFFFFF"

EvaluationContext.Colour.Hex.TextColour =
    (
        backgroundHex: STRING
    ) =>

        VAR L = EvaluationContext.Colour.Hex.Luminance( backgroundHex )
        VAR result = IF( L > 0.5, "#000000", "#FFFFFF")  // dark text for light backgrounds, light text for dark backgrounds

        RETURN result