# Getting Started with the FlatColorPicker

This tutorial explains how to set up a basic Telerik UI for ASP.NET MVC FlatColorPicker and highlights the major steps in the configuration of the component.

You will initialize a FlatColorPicker component with predefined `gradient` and `palette` view types, and then change its appearance. Finally, you will learn how to handle the Change event of the FlatColorPicker in order to color an arbitrary container.

![Sample Telerik UI for ASP.NET MVC FlatColorPicker](https://www.telerik.com/aspnet-mvc/documentation/assets/9e456d4b17e95f470b68683f15519401/flatcolorpicker-getting-started.png)

## Prerequisites

To successfully complete the tutorial, you need a project that is already configured to use the Telerik UI for ASP.NET MVC components:

* To create a new pre-configured project for the Telerik UI for ASP.NET MVC components, you can [use a project template](https://www.telerik.com/aspnet-mvc/documentation/getting-started-mvc/first-steps).

* To manually configure an existing project by using NuGet, see the [Adding Telerik UI through NuGet](https://www.telerik.com/aspnet-mvc/documentation/getting-started/setup-with-nuget).

## 1. Prepare the CSHTML File

The first step is to add the required directives at the top of the `.cshtml` document:

* To use the Telerik UI for ASP.NET MVC HtmlHelpers:

  ```cshtml
  @using Kendo.Mvc.UI
  ```

Optionally, you can structure the document by adding the desired HTML elements like headings, divs, and paragraphs.

```Razor HtmlHelper
    @using Kendo.Mvc.UI
    <h4>FlatColorPicker with a placeholder</h4>
    <div>
    
    </div>
```

## 2. Initialize the FlatColorPicker

Use the FlatColorPicker HtmlHelper  to add the component to a page.

The `Name()` configuration method is mandatory as its value is used for the `id` and the `name` attributes of the  FlatColorPicker element.

```Razor HtmlHelper
    @(Html.Kendo().FlatColorPicker()
        .Name("flatColorPicker")
    )
```

## 3. Configure the Views

The next step is to explicitly declare the Views configuration. The following example will configure the `gradient` and `palette` view types whilst providing a default view as the primary source of coloring.

```Razor HtmlHelper
    @(Html.Kendo().FlatColorPicker()
        .Name("flatColorPicker")
        .View("gradient")
        .Views(new string[] { "palette", "gradient"})
    )
```

## 4. Handle the FlatColorPicker Events

The FlatColorPicker component exposes the Change [event](https://docs.telerik.com/aspnet-mvc/api/kendo.mvc.ui.fluent/colorpickerbuilder#eventssystemaction) that you can handle and further customize the functionality of the component or other proprietary HTML elements. In this tutorial, you will change the color of another container.

```Razor HtmlHelper
    @(Html.Kendo().FlatColorPicker()
        .Name("flatColorPicker")
        .View("gradient")
        .Views(new string[] { "palette", "gradient"})
        .Events(events => events.Change("onChange"))
    )

    <script>
        function onChange(e) {
            $("#background").css("background-color", e.value);
        }
    </script>
```

## 5. (Optional) Reference Existing FlatColorPicker Instances

You can reference the FlatColorPicker instances that you have created and build on top of their existing configuration:

1. Use the `.Name()` (`id` attribute) of the component instance to get a reference.

   ```JS script
        <script>
            $(document).ready(function() {
                var flatColorPickerReference = $("#flatColorPicker").data("kendoFlatColorPicker"); // flatColorPickerReference is a reference to the existing FlatColorPicker instance of the helper.
            })
        </script>
   ```
2. Toggle the state of the component by using the [`enable()`](https://docs.telerik.com/kendo-ui/api/ui/flatcolorpicker/methods/enable) client-side method.

   ```JS script
       <script>
           $(document).ready(function() {
              var flatColorPickerReference = $("#flatColorPicker").data("kendoColorPicker"); // flatColorPickerReference is a reference to the existing FlatColorPicker instance of the helper.
              flatColorPickerReference.enable(false); // Toggle the state of the component.
           })
       </script>
   ```

## Next Steps

## See Also

* [Using the API of the FlatColorPicker for ASP.NET MVC (Demo)](https://demos.telerik.com/aspnet-mvc/flatcolorpicker/api)
* [Client-Side API of the FlatColorPicker](https://docs.telerik.com/kendo-ui/api/ui/flatcolorpicker)
* [Server-Side API of the FlatColorPicker for ASP.NET MVC](https://www.telerik.com/aspnet-mvc/documentation/api/flatcolorpicker)
* [Knowledge Base Section](https://www.telerik.com/aspnet-mvc/documentation/knowledge-base)
