Skip to main content



Download the DHTMLX Colorpicker package as a part of the DHTMLX Suite library

There are two ways of initializing DHTMLX Colorpicker: inside a container or inside a popup. Both ways are described below in detail.

In general, to create DHTMLX Colorpicker on a page, you need to take the following simple steps:

<!DOCTYPE html>
<title>How to start with DHTMLX ColorPicker</title>
<script type="text/javascript" src="../../codebase/suite.js"></script>
<link rel="stylesheet" href="../../codebase/suite.css">
<div id="colorpicker_container"></div>
// creating Colorpicker
const colorpicker = new dhx.Colorpicker("colorpicker_container", {
// config options

Include source files

Unpack the downloaded package into a folder of your project.

After that, create an HTML file and place full paths to JS and CSS files of the DHTMLX Suite library into the header of the file. The files are:

  • suite.js
  • suite.css
<script type="text/javascript" src="../../codebase/suite.js"></script>
<link rel="stylesheet" href="../../codebase/suite.css">

Initialize Colorpicker

You can initialize Colorpicker in a container or in a popup.

Initialization in a container

In this case you need to add a container for Colorpicker and give it an id, for example "colorpicker_container":

<div id="colorpicker_container"></div>

and initialize Colorpicker with the dhx.Colorpicker object constructor like this:

// creating ColorPicker
const colorpicker = new dhx.Colorpicker("colorpicker_container", {
css: "dhx_widget--bordered",
// more config options

Related sample: Colorpicker. Initialization

The constructor takes two parameters:

  • the HTML container for ColorPicker
  • an object with configuration properties (see the full list below). If this argument is not passed to the constructor, the settings will be default.

Initialization in a popup

This variant presupposes that you create a popup first and then attach a colorpicker into it.

  • use corresponding object constructors to create a colorpicker and a popup objects. Note that in this case null is used instead of container for Colorpicker:
const colorpicker = new dhx.Colorpicker(null, { customColors: ["#f2f2f2"] });
const popup = new dhx.Popup();
  • attach the colorpicker to the popup using the attach() method of Popup:
  • use the show() and hide() methods of Popup to control when a popup with color picker should be shown/hidden. For example:"showButton");

const colorExample = document.querySelector(".dhx_color-sample");"colorChange", function (color) { = color;

Related sample: Colorpicker. Colorpicker inside Popup

Configuration properties

The detailed information on Colorpicker configuration options can be found in the Colorpicker API overview article.

Select initial color (optional)

You can specify the color that should be selected in the palette after Colorpicker initialization with the help of the setValue() method:

const colorpicker = new dhx.Colorpicker("colorpicker_container", {
// config options

Related sample: Colorpicker. Set value