ASP.NET Core FlatColorPicker Overview

The FlatColorPicker is part of Telerik UI for ASP.NET Core, a professional grade UI library with 110+ components for building modern and feature-rich applications. To try it out sign up for a free 30-day trial.

Download Free Trial

The Telerik UI FlatColorPicker TagHelper and HtmlHelper for ASP.NET Core are server-side wrappers for the Kendo UI FlatColorPicker widget.

The FlatColorPicker is the HSV color selector which is used by default in the kendo.ui.FlatColorPicker popup when no palette is set.

• Demo page for the FlatColorPicker

Initializing the FlatColorPicker

The following example demonstrates how to define the FlatColorPicker.

    @(Html.Kendo().FlatColorPicker()
          .Name("flatcolorpicker") // The name of the FlatColorPicker is mandatory. It specifies the "id" attribute of the widget.
          .Value("#ff0000") // Set the value of the FlatColorPicker.
    )

Starting with the 2024 Q3 release, the HtmlHelper version of the component supports declarative initialization.

Events

You can subscribe to all FlatColorPicker events.

Handling by Handler Name

The following example demonstrates how to subscribe to events by a handler name.

      @(Html.Kendo().FlatColorPicker()
            .Name("flatcolorpicker")
            .Events(e => e
                  .Change("flatcolorpicker_change")
            )
      )
      <script>
          function flatcolorpicker_change(e) {
              //Handle the change event.
          }
      </script>

@addTagHelper *, Kendo.Mvc
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers

<script>
        function change(e) {
             console.log("Change in picker #" + this.element.attr("id") + " :: " + e.value);
        }
</script>

<kendo-flatcolorpicker name="flatColorPicker" value="#00f" on-change="change">
</kendo-flatcolorpicker>

Handling by Template Delegate

The following example demonstrates how to subscribe to events by a template delegate.

      @(Html.Kendo().FlatColorPicker()
            .Name("flatcolorpicker")
            .Events(e => e
                .Change(@<text>
                  function(e) {
                      // Handle the change event inline.
                  }
                  </text>)
            )
      )

Referencing Existing Instances

To reference an existing Telerik UI FlatColorPicker instance, use the jQuery.data() configuration option. Once a reference is established, use the FlatColorPicker client-side API to control its behavior.

  // Place the following after your Telerik UI FlatColorPicker for ASP.NET Core declaration.
  <script>
  $(function() {
      // The Name() of the FlatColorPicker is used to get its client-side instance.
      var flatcolorpicker = $("#flatcolorpicker").data("kendoFlatColorPicker");
  });
  </script>

Functionality and Features

• Views—The FlatColorPicker enables you to choose between gradient or palette view types.
• Contrast Tool—The FlatColorPicker enables you to configure the contrast tool.
• Formats—The FlatColorPicker provides support for both HEX and RGB coloring formats.

Next Steps

• Getting Started with the FlatColorPicker

• Basic Usage of the FlatColorPicker HtmlHelper for ASP.NET Core (Demo)

• Basic Usage of the FlatColorPicker TagHelper for ASP.NET Core (Demo)

See Also

• Using the API of the FlatColorPicker for ASP.NET Core (Demo)
• Knowledge Base Section