ColorPalette HtmlHelper Overview

The ColorPalette HtmlHelper extension is a server-side wrapper for the Kendo UI ColorPalette widget.

Configuration

Below are listed the steps for you to follow when configuring the Kendo UI ColorPalette.

1. Make sure you followed all the steps from the introductory article on Telerik UI for ASP.NET MVC.

2. Create a new action method which renders the view.

   Example

   public ActionResult Index()
   {
       return View();
   }
   

3. Add a ColorPalette.

       <%: Html.Kendo().ColorPalette()
               .Name("colorpalette") //The name of the ColorPalette is mandatory. It specifies the "id" attribute of the widget.
               .Value("#ff0000") //Set the value of the ColorPalette.
       %>
   

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

Event Handling

You can subscribe to all ColorPalette events.

By Handler Name

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

Example

    <%: Html.Kendo().ColorPalette()
            .Name("colorpalette")
            .Events(e => e
                .Change("colorpalette_change")
            )
    %>
    <script>
        function colorpalette_change() {
            //Handle the change event.
        }
    </script>

    @(Html.Kendo().ColorPalette()
            .Name("colorpalette")
            .Events(e => e
                .Change("colorpalette_change")
            )
    )
    <script>
        function colorpalette_change() {
            //Handle the change event.
        }
    </script>

By Template Delegate

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

Example

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

Reference

Existing Instances

To reference an existing Kendo UI ColorPalette instance, use the jQuery.data() configuration option. Once a reference is established, use the ColorPalette API to control its behavior.

Example

//Put this after your Kendo UI ColorPalette for ASP.NET MVC declaration.
<script>
    $(function() {
        //Notice that the Name() of the ColorPalette is used to get its client-side instance.
        var colorpalette = $("#colorpalette").data("kendoColorPalette");
    });
</script>

See Also

• Telerik UI for ASP.NET MVC API Reference: ColorPaletteBuilder
• Overview of Telerik UI for ASP.NET MVC
• Fundamentals of Telerik UI for ASP.NET MVC
• Scaffolding in Telerik UI for ASP.NET MVC
• Overview of the Kendo UI ColorPicker Widget
• Telerik UI for ASP.NET MVC API Reference Folder
• Telerik UI for ASP.NET MVC HtmlHelpers Folder
• Tutorials on Telerik UI for ASP.NET MVC
• Telerik UI for ASP.NET MVC Troubleshooting