<kendo:colorPicker>

A JSP wrapper for Kendo UI ColorPicker.

Configuration Attributes

buttons boolean

Specifies whether the widget should display the Apply / Cancel buttons.Applicable only for the HSV selector, when a pallete is not specified.

Example

<kendo:colorPicker buttons="buttons">
</kendo:colorPicker>

clearButton boolean

Specifies whether the widget should display the 'Clear color' button.Applicable only for the HSV selector, when a pallete is not specified.

Example

<kendo:colorPicker clearButton="clearButton">
</kendo:colorPicker>

columns float

The number of columns to show in the color dropdown when a pallete is specified. This is automatically initialized for the "basic" and "websafe" palettes. If you use a custom palette then you can set this to some value that makes sense for your colors.

Example

<kendo:colorPicker columns="columns">
</kendo:colorPicker>

opacity boolean

Only for the HSV selector. If true, the widget will display the opacity slider. Note that currently in HTML5 the does not support opacity.

Example

<kendo:colorPicker opacity="opacity">
</kendo:colorPicker>

palette java.lang.Object

When a non-null palette argument is supplied, the drop-down will be a simple color picker that lists the colors. The following are supported: "basic" -- displays 20 basic colors; "websafe" -- display the "web-safe" color palette or otherwise, pass a string with colors in HEX representation separated with commas, or an array of colors, and it will display that palette instead. If you pass an array it can contain strings supported by parseColor orColor objects.. If palette is missing or null, the widget will display the HSV selector.

Example

<kendo:colorPicker palette="palette">
</kendo:colorPicker>

preview boolean

Only applicable for the HSV selector.Displays the color preview element, along with an input field where the end user can paste a color in a CSS-supported notation.

Example

<kendo:colorPicker preview="preview">
</kendo:colorPicker>

tileSize float

The size of a color cell. Further configuration is available via kendo:colorPicker-tileSize.

Example

<kendo:colorPicker tileSize="tileSize">
</kendo:colorPicker>

toolIcon java.lang.String

A CSS class name to display an icon in the color picker button. If specified, the HTML for the element will look like this:

Example

<kendo:colorPicker toolIcon="toolIcon">
</kendo:colorPicker>

value java.lang.String

The initially selected color. Note that when initializing the widget from an element, the initial color will be decided by the field instead.

Example

<kendo:colorPicker value="value">
</kendo:colorPicker>

Configuration JSP Tags

kendo:colorPicker-messages

Allows localization of the strings that are used in the widget.

More documentation is available at kendo:colorPicker-messages.

Example

<kendo:colorPicker>
    <kendo:colorPicker-messages></kendo:colorPicker-messages>
</kendo:colorPicker>

kendo:colorPicker-tileSize

The size of a color cell.

More documentation is available at kendo:colorPicker-tileSize.

Example

<kendo:colorPicker>
    <kendo:colorPicker-tileSize></kendo:colorPicker-tileSize>
</kendo:colorPicker>

Event Attributes

change String

Fires when a color was selected, either by clicking on it (in the simple picker), by clicking ENTER or by pressing "Apply" in the HSV picker.

For additional information check the change event documentation.

Example

<kendo:colorPicker change="handle_change">
</kendo:colorPicker>
<script>
    function handle_change(e) {
        // Code to handle the change event.
    }
</script>

select String

Fires as a new color is displayed in the drop-down picker. This is not necessarily the "final" value; for example this event triggers when the sliders in the HSV selector are dragged, but then pressing ESC would cancel the selection and the color will revert to the original value.

For additional information check the select event documentation.

Example

<kendo:colorPicker select="handle_select">
</kendo:colorPicker>
<script>
    function handle_select(e) {
        // Code to handle the select event.
    }
</script>

open String

Fires when the picker popup is opening.

For additional information check the open event documentation.

Example

<kendo:colorPicker open="handle_open">
</kendo:colorPicker>
<script>
    function handle_open(e) {
        // Code to handle the open event.
    }
</script>

close String

Fires when the picker popup is closing.

For additional information check the close event documentation.

Example

<kendo:colorPicker close="handle_close">
</kendo:colorPicker>
<script>
    function handle_close(e) {
        // Code to handle the close event.
    }
</script>

Event Tags

kendo:colorPicker-change

Fires when a color was selected, either by clicking on it (in the simple picker), by clicking ENTER or by pressing "Apply" in the HSV picker.

For additional information check the change event documentation.

Example

<kendo:colorPicker>
    <kendo:colorPicker-change>
        <script>
            function(e) {
                // Code to handle the change event.
            }
        </script>
    </kendo:colorPicker-change>
</kendo:colorPicker>

kendo:colorPicker-select

Fires as a new color is displayed in the drop-down picker. This is not necessarily the "final" value; for example this event triggers when the sliders in the HSV selector are dragged, but then pressing ESC would cancel the selection and the color will revert to the original value.

For additional information check the select event documentation.

Example

<kendo:colorPicker>
    <kendo:colorPicker-select>
        <script>
            function(e) {
                // Code to handle the select event.
            }
        </script>
    </kendo:colorPicker-select>
</kendo:colorPicker>

kendo:colorPicker-open

Fires when the picker popup is opening.

For additional information check the open event documentation.

Example

<kendo:colorPicker>
    <kendo:colorPicker-open>
        <script>
            function(e) {
                // Code to handle the open event.
            }
        </script>
    </kendo:colorPicker-open>
</kendo:colorPicker>

kendo:colorPicker-close

Fires when the picker popup is closing.

For additional information check the close event documentation.

Example

<kendo:colorPicker>
    <kendo:colorPicker-close>
        <script>
            function(e) {
                // Code to handle the close event.
            }
        </script>
    </kendo:colorPicker-close>
</kendo:colorPicker>