Skip to content

CupertinoColors

Inherits: str, Enum

with_opacity(opacity: int | float, color: ColorValue) -> str staticmethod #

Returns the color with the specified opacity.

Parameters:

  • opacity (int | float) –

    The opacity value between 0.0 and 1.0.

  • color (ColorValue) –

    The color to apply opacity to.

Returns:

  • str

    A string representing the color with opacity, in the format "color,opacity".

Examples:

>>> CupertinoColors.with_opacity(0.5, CupertinoColors.WHITE)
'white,0.5'

Raises:

  • ValueError

    If the opacity is not between 0 and 1 (inclusive).

random(exclude: list[CupertinoColors] | None = None, weights: dict[CupertinoColors, int] | None = None) -> CupertinoColors | None staticmethod #

Selects a random color, with optional exclusions and weights.

Parameters:

  • exclude (list[CupertinoColors] | None, default: None ) –

    A list of colors members to exclude from the selection.

  • weights (dict[CupertinoColors, int] | None, default: None ) –

    A dictionary mapping color members to their respective weights for weighted random selection.

Returns:

  • CupertinoColors | None

    A randomly selected color, or None if all members are excluded.

Examples:

>>> CupertinoColors.random(exclude=[CupertinoColors.WHITE])
CupertinoColors.ON_PRIMARY

ACTIVE_BLUE = 'activeBlue' class-attribute instance-attribute #

ACTIVE_GREEN = 'activeGreen' class-attribute instance-attribute #

ACTIVE_ORANGE = 'activeOrange' class-attribute instance-attribute #

BLACK = 'cupertinoBlack' class-attribute instance-attribute #

DARK_BACKGROUND_GRAY = 'darkBackgroundGray' class-attribute instance-attribute #

DESTRUCTIVE_RED = 'destructiveRed' class-attribute instance-attribute #

EXTRA_LIGHT_BACKGROUND_GRAY = 'extraLightBackgroundGray' class-attribute instance-attribute #

INACTIVE_GRAY = 'inactiveGray' class-attribute instance-attribute #

LABEL = 'label' class-attribute instance-attribute #

LIGHT_BACKGROUND_GRAY = 'lightBackgroundGray' class-attribute instance-attribute #

ON_PRIMARY = 'onprimary' class-attribute instance-attribute #

OPAQUE_SEPARATOR = 'opaqueSeparator' class-attribute instance-attribute #

PLACEHOLDER_TEXT = 'placeholderText' class-attribute instance-attribute #

PRIMARY = 'primary' class-attribute instance-attribute #

QUATERNARY_LABEL = 'quaternaryLabel' class-attribute instance-attribute #

QUATERNARY_SYSTEM_FILL = 'quaternarySystemFill' class-attribute instance-attribute #

SECONDARY_LABEL = 'secondaryLabel' class-attribute instance-attribute #

SECONDARY_SYSTEM_BACKGROUND = 'secondarySystemBackground' class-attribute instance-attribute #

SECONDARY_SYSTEM_FILL = 'secondarySystemFill' class-attribute instance-attribute #

SECONDARY_SYSTEM_GROUPED_BACKGROUND = 'secondarySystemGroupedBackground' class-attribute instance-attribute #

SEPARATOR = 'separator' class-attribute instance-attribute #

SYSTEM_BACKGROUND = 'systemBackground' class-attribute instance-attribute #

SYSTEM_BLUE = 'systemBlue' class-attribute instance-attribute #

SYSTEM_BROWN = 'systemBrown' class-attribute instance-attribute #

SYSTEM_CYAN = 'systemCyan' class-attribute instance-attribute #

SYSTEM_FILL = 'systemFill' class-attribute instance-attribute #

SYSTEM_GREEN = 'systemGreen' class-attribute instance-attribute #

SYSTEM_GREY = 'systemGrey' class-attribute instance-attribute #

SYSTEM_GREY2 = 'systemGrey2' class-attribute instance-attribute #

SYSTEM_GREY3 = 'systemGrey3' class-attribute instance-attribute #

SYSTEM_GREY4 = 'systemGrey4' class-attribute instance-attribute #

SYSTEM_GREY5 = 'systemGrey5' class-attribute instance-attribute #

SYSTEM_GREY6 = 'systemGrey6' class-attribute instance-attribute #

SYSTEM_GROUPED_BACKGROUND = 'systemGroupedBackground' class-attribute instance-attribute #

SYSTEM_INDIGO = 'systemIndigo' class-attribute instance-attribute #

SYSTEM_MINT = 'systemMint' class-attribute instance-attribute #

SYSTEM_ORANGE = 'systemOrange' class-attribute instance-attribute #

SYSTEM_PINK = 'systemPink' class-attribute instance-attribute #

SYSTEM_PURPLE = 'systemPurple' class-attribute instance-attribute #

SYSTEM_RED = 'systemRed' class-attribute instance-attribute #

SYSTEM_TEAL = 'systemTeal' class-attribute instance-attribute #

SYSTEM_YELLOW = 'systemYellow' class-attribute instance-attribute #

TERTIARY_LABEL = 'tertiaryLabel' class-attribute instance-attribute #

TERTIARY_SYSTEM_BACKGROUND = 'tertiarySystemBackground' class-attribute instance-attribute #

TERTIARY_SYSTEM_FILL = 'tertiarySystemFill' class-attribute instance-attribute #

TERTIARY_SYSTEM_GROUPED_BACKGROUND = 'tertiarySystemGroupedBackground' class-attribute instance-attribute #

WHITE = 'cupertinoWhite' class-attribute instance-attribute #