Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Enterprise Open source

colorManipulator.getLuminance() function

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

colorManipulator.getLuminance() function

The relative brightness of any point in a color space, normalized to 0 for darkest black and 1 for lightest white.

Formula: https://www.w3.org/TR/WCAG20-TECHS/G17.html#G17-tests

Signature

typescript
export declare function getLuminance(color: string, background?: string): number;

Import

typescript
import { colorManipulator } from '@grafana/data';
const { getLuminance } = colorManipulator;

Parameters

ParameterTypeDescription
colorstringCSS color, i.e. one of: #nnn, #nnnnnn, rgb(), rgba(), hsl(), hsla(), color()
backgroundstringCSS color that needs to be take in to account to calculate luminance for colors with opacity

Returns:

number

The relative brightness of the color in the range 0 - 1