class

Opal::UI::Palette

Inherits Opal::UI::Control < Opal::UI::InputHookable < Opal::UI::Element < Opal::UI::Themable < Reference < Object

Interactive Palette UI control supporting Named and Indexed modes, color reordering via [ and ], min/max constraints, inline renaming, and seamless embedded ColorPicker integration.

Constructors

indexed(colors : Array(Color), min_colors : Int32 | Nil = nil, max_colors : Int32 | Nil = nil, allow_add : Bool = true, allow_remove : Bool = true, allow_reorder : Bool = true, picker_mode : ColorMode = ColorMode::RGB, picker_layout : ColorPickerLayout = ColorPickerLayout::Sliders, show_picker_alpha : Bool = false, show_picker_harmonies : Bool = true, title : String = "Indexed Palette", width : Int32 | Nil = 54, height : Int32 | Nil = 16) : Palette

Convenience constructor for indexed mode from Array(Color)

named(entries : Hash(String, Color), allow_add : Bool = true, allow_rename : Bool = true, allow_remove : Bool = true, picker_mode : ColorMode = ColorMode::RGB, picker_layout : ColorPickerLayout = ColorPickerLayout::Sliders, show_picker_alpha : Bool = false, show_picker_harmonies : Bool = true, title : String = "Named Palette", width : Int32 | Nil = 54, height : Int32 | Nil = 16) : Palette

Convenience constructor for named mode from Hash(String, Color)

new(model : PaletteModel = PaletteModel.new, picker_mode : ColorMode = ColorMode::RGB, picker_layout : ColorPickerLayout = ColorPickerLayout::Sliders, show_picker_alpha : Bool = false, show_picker_harmonies : Bool = true, title : String = "Color Palette", width : Int32 | Nil = 54, height : Int32 | Nil = 16)

Instance methods

active_border_color

active_border_color=(active_border_color : Color)

add_entry

Adds a new color or entry

border_color

border_color=(border_color : Color)

cancel_color_edit

Cancels color editing without saving

cancel_rename

color_picker

Embedded ColorPicker state

confirm_color_edit(color : Color) : Nil

Confirms the edited color from ColorPicker back to the Palette

confirm_rename

confirmed=(confirmed : Bool)

confirmed?

cursor

cursor=(cursor : Int32)

delete_selected

Removes selected entry

editing_color=(editing_color : Bool)

editing_color?

handle_key(key : Terminal::KeyEvent) : Bool

Default key event handler. Override in subclasses if not using @default_input_proc.

handle_mouse(event : Terminal::MouseEvent) : Bool

Default mouse event handler. Override in subclasses if not using @default_input_proc.

height

height=(height : Int32)

last_h

last_h=(last_h : Int32)

last_w

last_w=(last_w : Int32)

last_x

last_x=(last_x : Int32)

last_y

last_y=(last_y : Int32)

model

model=(model : PaletteModel)

move_cursor(delta : Int32) : Nil

Moves cursor with bounds checking and triggers selection callback

on_change

Callbacks

on_change=(on_change : Proc(PaletteModel, Nil) | Nil)

Callbacks

on_confirm

on_confirm=(on_confirm : Proc(PaletteModel, Nil) | Nil)

on_select

on_select=(on_select : Proc(Int32, Color, String | Nil, Nil) | Nil)

open_color_picker

Begins editing the currently selected color with the ColorPicker

picker_layout

picker_layout=(picker_layout : ColorPickerLayout)

picker_mode

picker_mode=(picker_mode : ColorMode)

preferred_size(available_w : Int32, available_h : Int32) : Tuple(Int32, Int32)

rename_buffer

rename_buffer=(rename_buffer : String)

renaming=(renaming : Bool)

Inline renaming state (Named mode)

renaming?

Inline renaming state (Named mode)

render(buffer : Buffer, x : Int32, y : Int32, width : Int32, height : Int32) : Nil

render(buffer : Buffer) : Nil

set_cursor(idx : Int32) : Nil

show_border=(show_border : Bool)

show_border?

show_picker_alpha=(show_picker_alpha : Bool)

show_picker_alpha?

show_picker_harmonies=(show_picker_harmonies : Bool)

show_picker_harmonies?

start_rename

Starts inline renaming

swap_left

Swap selected color left/earlier (via [ key)

swap_right

Swap selected color right/later (via ] key)

title

Visual styling

title=(title : String)

Visual styling

width

Geometry cache

width=(width : Int32)

Geometry cache