HueRingPicker

A hue ring color picker that lets users select a hue on a circular ring, with an optional alpha slider.

Basic HueRingPicker

Inherits: LayoutControl

Properties

• color(ColorValue | None) –

  The currently selected color.

• color_picker_height(Number | None) –

  Height of the color picker in virtual pixels.

• enable_alpha(bool) –

  Whether to enable alpha (opacity) slider.

• hue_ring_stroke_width(Number | None) –

  Stroke width for the hue ring.

• picker_area_border_radius(BorderRadiusValue | None) –

  Border radius for the picker area.

• portrait_only(bool) –

  Whether to force portrait layout.

Events

• on_color_change(ControlEventHandler[HueRingPicker] | None) –

  Called when the picker color is changed.

Example

Properties

color class-attribute instance-attribute

color: ColorValue | None = None

The currently selected color.

color_picker_height class-attribute instance-attribute

color_picker_height: Number | None = None

Height of the color picker in virtual pixels.

enable_alpha class-attribute instance-attribute

enable_alpha: bool = False

Whether to enable alpha (opacity) slider.

hue_ring_stroke_width class-attribute instance-attribute

hue_ring_stroke_width: Number | None = None

Stroke width for the hue ring.

picker_area_border_radius class-attribute instance-attribute

picker_area_border_radius: BorderRadiusValue | None = None

Border radius for the picker area.

portrait_only class-attribute instance-attribute

portrait_only: bool = False

Whether to force portrait layout.

Events

on_color_change class-attribute instance-attribute

on_color_change: (
    ControlEventHandler[HueRingPicker] | None
) = None

Called when the picker color is changed.

The data property of the event handler argument contains the color value as a hex string.