FlatColorPicker Overview

The FlatColorPicker for Blazor is an interactive component that allows color selection from a color palette or a HSVA canvas. Users can also type a specific RGB/HEX color value manually. The FlatColorPicker is practically identical to the ColorPicker component with the only difference that the ColorPicker takes up less space and displays the color selection UI in a popup.

Telerik UI for Blazor Ninja image

The FlatColorPicker component is part of Telerik UI for Blazor, a professional grade UI library with 90 native components for building modern and feature-rich applications. To try it out sign up for a free 30-day trial.

In this article:

Basics

To use a Telerik FlatColorPicker for Blazor:

  1. Add the TelerikFlatColorPicker tag.
  2. Set its Value attribute to any of the supported HEX/RGB formats. Use a string property with one-way or two-way binding.
  3. (optional) Set the ValueFormat to ColorFormat.Hex or ColorFormat.Rgb if the app expects a specific color format.

Example

Here is a simple FlatColorPicker declaration and the resulting UI.

@* Blazor FlatColorPicker *@

<TelerikFlatColorPicker @bind-Value="@Color" />

@code {
    string Color { get; set; } = "rgb(40, 47, 137)";
}

Interface

The image below reveals all FlatColorPicker interface elements:

  • View selectors (top left)
  • Color preview box (top right)
  • Current color box (below the color preview)
  • Clear button (top)
  • Palette tiles or HSV canvas with hue and opacity sliders (middle)
  • RGBA or HEX value textboxes with a toggle button (bottom)
  • Apply and Cancel buttons (bottom)

FlatColorPicker component

Features

The FlatColorPicker tag exposes the following features via its attributes:

  • Value - string - sets the FlatColorPicker value in a few different color formats. Supports two-way binding.
  • ValueFormat - ColorFormat - sets the color format, which the component will return in the application code. By default, the property is not set and the value format will change depending on the used view: Rgb when selecting a color from the GradientView, and Hex when selecting a color from the PaletteView.
  • FlatColorPickerViews - RenderFragment - a nested container to list the FlatColorPicker views. All views are enabled by default and the user can switch between them with buttons. Each view tag has its own configuration attributes.
  • View - ColorPickerView - sets the default selected view (ColorPickerView.Gradient by default). Supports two-way binding.
  • ShowPreview - bool - toggles the current color box and the color preview box in the popup (true by default).

  • Class - string - renders a custom CSS class to the div.k-flatcolorpicker element.

  • Enabled - bool - determines if the user can open the popup and change the value (true by default).

Buttons

  • ShowButtons - bool - sets the visibility of the Apply and Cancel buttons (true by default).
  • ShowClearButton - bool - sets the visibility of the Clear button.

Supported Value Formats

The FlatColorPicker accepts values by the application code in the following formats:

  • Hexadecimal
    • 3 digits - #f00
    • 6 digits - #ff0000
    • 8 digits, including alpha opacity - #ff000080
  • RGB or RGBA
    • integer color values - rgb(255, 0, 0)
    • percentage color values - rgb(100%, 0%, 0%)
    • the alpha opacity must always be a decimal number between 0 and 1 - rgba(100%, 0%, 0%, 0.5). Note the rgba() notation, compared to rgb() above.

Users can type values in the following formats:

  • All hexadecimal
  • RGB and RGBA with integer color values

Color keywords are not supported.

See Also

In this article
Not finding the help you need? Improve this article