Struct Color 

pub struct Color(/* private fields */);

A color value that can be resolved in different color spaces.

This is the main color type that wraps a resolvable color value. Colors can be created from sRGB, P3, OKLCH, or custom color spaces.

Layout Behavior

Color is a greedy view that expands to fill all available space in both directions. Use .frame() to constrain its size, or use it as a background.

Examples

// Fills entire container
Color::blue()

// Constrained to specific size
Color::red().frame().width(100.0).height(50.0)

// As a background
text("Hello").background(Color::yellow())

Implementations

impl Color

pub fn new(custom: impl Resolvable<Resolved = ResolvedColor> + 'static) -> Color

Creates a new color from a custom resolvable color value.

Arguments

• custom - A resolvable color implementation

pub fn srgb(red: u8, green: u8, blue: u8) -> Color

Creates an sRGB color from 8-bit color components.

Arguments

• red - Red component (0-255)
• green - Green component (0-255)
• blue - Blue component (0-255)

pub fn srgb_f32(red: f32, green: f32, blue: f32) -> Color

Creates an sRGB color from floating-point color components.

Arguments

• red - Red component (0.0 to 1.0)
• green - Green component (0.0 to 1.0)
• blue - Blue component (0.0 to 1.0)

pub fn p3(red: f32, green: f32, blue: f32) -> Color

Creates a P3 color from floating-point color components.

Arguments

• red - Red component (0.0 to 1.0)
• green - Green component (0.0 to 1.0)
• blue - Blue component (0.0 to 1.0)

pub fn oklch(lightness: f32, chroma: f32, hue: f32) -> Color

Creates an OKLCH color from perceptual lightness, chroma, and hue values.

OKLCH is recommended for authoring UI colors due to its perceptual uniformity.

pub fn srgb_hex(hex: &str) -> Color

Creates an sRGB color from a hexadecimal color string.

Panics if the string does not contain exactly six hexadecimal digits.

pub fn try_srgb_hex(hex: &str) -> Result<Color, HexColorError>

Tries to create an sRGB color from a hexadecimal color string.

Errors

Returns HexColorError if the provided string is not a valid six-digit hexadecimal color.

pub fn srgb_u32(rgb: u32) -> Color

Creates an sRGB color from a packed 0xRRGGBB value.

pub fn transparent() -> Color

Returns a fully transparent color.

pub fn with_opacity(self, opacity: f32) -> Color

Creates a new color with the specified opacity applied.

Arguments

• opacity - Opacity value (0.0 = transparent, 1.0 = opaque)

pub fn with_alpha(self, opacity: f32) -> Color

Alias for [with_opacity].

pub fn with_headroom(self, headroom: f32) -> Color

Creates a new color with extended headroom for HDR content.

Arguments

• headroom - Additional headroom value for extended range

pub fn lighten(self, amount: f32) -> Color

Lightens the color by increasing its OKLCH lightness component.

pub fn darken(self, amount: f32) -> Color

Darkens the color by decreasing its OKLCH lightness component.

pub fn saturate(self, amount: f32) -> Color

Adjusts the color saturation by scaling the OKLCH chroma component.

pub fn desaturate(self, amount: f32) -> Color

Decreases the color saturation by scaling the OKLCH chroma component down.

pub fn hue_rotate(self, degrees: f32) -> Color

Rotates the color’s hue by the provided number of degrees.

pub fn mix(self, other: impl Into<Color>, factor: f32) -> Color

Mixes this color with another color using linear interpolation.

pub fn resolve(&self, env: &Environment) -> Computed<ResolvedColor>

Resolves this color to a concrete color value in the given environment.

Arguments

• env - The environment to resolve the color in

impl Color

pub fn red() -> Color

Red color.

impl Color

pub fn pink() -> Color

Pink color.

impl Color

pub fn purple() -> Color

Purple color.

impl Color

pub fn deep_purple() -> Color

Deep purple color.

impl Color

pub fn indigo() -> Color

Indigo color.

impl Color

pub fn blue() -> Color

Blue color.

impl Color

pub fn light_blue() -> Color

Light blue color.

impl Color

pub fn cyan() -> Color

Cyan color.

impl Color

pub fn teal() -> Color

Teal color.

impl Color

pub fn green() -> Color

Green color.

impl Color

pub fn light_green() -> Color

Light green color.

impl Color

pub fn lime() -> Color

Lime color.

impl Color

pub fn yellow() -> Color

Yellow color.

impl Color

pub fn amber() -> Color

Amber color.

impl Color

pub fn orange() -> Color

Orange color.

impl Color

pub fn deep_orange() -> Color

Deep orange color.

impl Color

pub fn brown() -> Color

Brown color.

impl Color

pub fn grey() -> Color

Grey color.

impl Color

pub fn blue_grey() -> Color

Blue grey color.

Trait Implementations

impl Clone for Color

fn clone(&self) -> Color

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Color

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for Color

fn default() -> Color

Returns the “default value” for a type.

impl FormBuilder for Color

type View = ColorPicker

The view type that represents this form field.

fn view( binding: &Binding<Color>, label: AnyView, placeholder: Str, ) -> <Color as FormBuilder>::View

Creates a view representation of this form field bound to the given binding.

fn binding() -> Binding<Self>

where Self: Default + Clone,

Creates a new binding with the default value for this form.

impl From<Color> for Background

fn from(color: Color) -> Self

Converts to this type from the input type.

impl<T> From<T> for Color

where T: Resolvable<Resolved = ResolvedColor> + 'static,

fn from(value: T) -> Color

Converts to this type from the input type.

impl NativeView for Color

fn stretch_axis(&self) -> StretchAxis

Which axis (or axes) this view stretches to fill available space.

impl Signal for Color

type Output = Color

The type of value produced by this computation.

type Guard = ()

The guard type returned by the watch method that manages watcher lifecycle.

fn get(&self) -> <Color as Signal>::Output

Execute the computation and return the current value.

fn watch(&self, _watcher: impl Fn(Context<<Color as Signal>::Output>) + 'static)

Register a watcher to be notified when the computed value changes.

impl View for Color

fn body(self, _env: &Environment) -> impl View

Build this view and return the content.