Yahoo! Developer Network Home - Help

YDN Site Search

# YUI Library Examples: Color Picker Control (beta): Inline Color Picker Control from Script

# Color Picker Control (beta): Inline Color Picker Control from Script

The simplest way to implement the Color Picker Control is to do so entirely via script. In this example, a Color Picker Control is placed on the page via script and allowed to create its own DOM structure. In cases where you've provided other form controls on the page for color specification (ie, controls not dependent on JavaScript), this approach allows you to provide a richer visual experience for sighted users with JavaScript enabled.

View example in new window.

## Building a Color Picker Instance via JavaScript

In this example, the Color Picker Control instance is allowed to create its own DOM structure. We begin with a simple style set for the containing element into which that DOM structure will be rendered and we place the containing element on the page:

<style type="text/css"> #container { position: relative; padding: 6px; background-color: #eeeeee; width: 420px; height:220px; } </style> <div id="container"> <!--Color Picker will appear here--> </div> <!--We'll use these to trigger interactions with the Color Picker API --> <button id="reset">Reset Color to White</button> <button id="gethex">Write current hex value to the Logger</button>

With a target element in place, we can instantiate Color Picker and provide our desired configuration options. In this example, we are specifying that HSV and hex controls should be displayed and we're specifying custom locations for the color-picker slider thumb and the hue slider thumb. For the purposes of the example, we're also hooking into the Color Picker's `rgbChange` event and logging the `newValue` to the logger console; you'll see those log messages each time you adjust the color. This example also demonstrates how to use the picker's `get` method to tap into the current `hex` value via script.

(function() { var Event = YAHOO.util.Event, picker; Event.onDOMReady(function() { YAHOO.log("Creating Color Picker.", "info", "example"); picker = new YAHOO.widget.ColorPicker("container", { showhsvcontrols: true, showhexcontrols: true, images: { PICKER_THUMB: "assets/picker_thumb.png", HUE_THUMB: "assets/hue_thumb.png" } }); YAHOO.log("Finished creating Color Picker.", "info", "example"); //a listener for logging RGB color changes; //this will only be visible if logger is enabled: var onRgbChange = function(o) { /*o is an object { newValue: (array of R, G, B values), prevValue: (array of R, G, B values), type: "rgbChange" } */ YAHOO.log("The new color value is " + o.newValue, "info", "example"); } //subscribe to the rgbChange event; picker.on("rgbChange", onRgbChange); //use setValue to reset the value to white: Event.on("reset", "click", function(e) { picker.setValue([255, 255, 255], false); //false here means that rgbChange //will fire; true would silence it }); //use the "get" method to get the current value //of one of the Color Picker's properties; in //this case, we'll get the hex value and write it //to the log: Event.on("gethex", "click", function(e) { YAHOO.log("Current hex value: " + picker.get("hex"), "info", "example"); }); }); })();

It's advisable to provide all necessary configurations at the instantiation of the Color Picker; it renders immediately and automatically upon creation.

### YUI Logger Output:

### Color Picker Control (beta) Examples:

- Inline Color Picker Control from Script
- Example of Color Picker Built in a Dialog via JavaScript
- Example of Color Picker Built in a Dialog from Markup
- Example of Specifying Custom Labels and Element IDs for Color Picker
- Skinning Example

### More Color Picker Control (beta) Resources:

- User's Guide (external)
- API Documentation
- Cheat Sheet PDF (external)

Copyright © 2007 Yahoo! Inc. All rights reserved.

Privacy Policy - Terms of Service - Copyright Policy - Job Openings