SheetXL - v0.8.0-beta.9+sites.210.e2d420901
    Preparing search index...

    Interface IColor

    Represents a color with optional adjustments applied.

    An IColor consists of:

    • baseColor: The underlying color, which can be a scheme color (e.g., Accent1), a built-in color (e.g., 'red', 'blue'), or defined using various color models (RGB, Hex, HSL).
    • adjustments (optional): An ordered list of color adjustments that modify the baseColor. These adjustments can include effects like grayscale, inversion, or modifications to specific color components (red, alpha, etc.).

    AdjustmentType

    interface IColor {
        isIColor: true;
        adjust(adjustments: readonly Adjustment[]): IColor;
        getAdjustments(): readonly Adjustment[];
        getBaseColor(): IColor;
        getLastColor(): string | null;
        getType(): IColor.Type;
        getVal(): string;
        isEqual(other: any): boolean;
        toBlackOrWhite(darkMode?: boolean, threshold?: number): IColor;
        toCSS(mode?: CSSMode, alpha?: boolean): string;
        toHex(darkMode?: boolean): HEX;
        toHSLA(darkMode?: boolean): HSLA;
        toRGBA(darkMode?: boolean): RGBA;
        toString(): string;
    }

    Implemented by

    Index
    isIColor
    adjust getAdjustments getBaseColor getLastColor getType getVal isEqual toBlackOrWhite toCSS toHex toHSLA toRGBA toString
    isIColor: true

    For runtime type checking.

    • Returns a new color that is derived from this color with the adjustments applied.

      Parameters

      • adjustments: readonly Adjustment[]

        An array of Adjustments

      Returns IColor

    • Return the color adjustments.

      Returns readonly Adjustment[]

    • Returns the base color without any adjustments applied.

      Returns IColor

    • For a system color, returns the authored fallback value (OOXML lastClr) as a 6-digit hex string (no leading #), or null if none. This is the value used when no IColor.SystemLookup resolves the color (e.g. headless rendering).

      Returns string | null

    • Return the type of color value used (e.g., scheme, named, index, hsl, rgb, hex).

      Returns IColor.Type

    • The base value for the color before adjustments.

      Returns string

    • Returns true if the other color will resolve to the same rgb values as this color.

      Parameters

      • other: any

        The other color to compare.

      Returns boolean

    • Returns the color as either 'black or white' depending on the luminance.

      Parameters

      • OptionaldarkMode: boolean
      • Optionalthreshold: number

        The threshold to determine if the color is dark or light.

      Returns IColor

      '186'

    • Return a string usable with CSS color properties.

      Parameters

      • Optionalmode: CSSMode

        false/true bake a concrete light/dark value — use when the output leaves live CSS (clipboard HTML, export, canvas). 'adaptive' emits a light-dark() expression the browser re-resolves from the subtree's color-scheme — a light/dark flip needs no re-render (renderers should prefer this; see IColor.CSSMode).

      • Optionalalpha: boolean

        If true alpha will be applied.

      Returns string

    • Return a HEX with adjustments applied.

      Parameters

      • OptionaldarkMode: boolean

      Returns HEX

    • Return as HSLA with adjustments applied.

      Parameters

      • OptionaldarkMode: boolean

      Returns HSLA

    • Return as RGBA with adjustments applied.

      Parameters

      • OptionaldarkMode: boolean

      Returns RGBA

    • Return the color as a string.

      Returns string

    Settings
    Member Visibility

    On This Page
    Properties
    Methods