Skip to content

Commit 27d542b

Browse files
steverenjeff-allen-mongo
authored andcommitted
DOCSP-3439: [Charts] Color palette customization (#84)
* DOCSP-3439: [Charts] Color palette customization
1 parent fdf8533 commit 27d542b

File tree

3 files changed

+55
-0
lines changed

3 files changed

+55
-0
lines changed

source/customize-charts/general-customization.txt

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,3 +100,58 @@ To set this option:
100100
#. In the :guilabel:`General Customization` section, set the
101101
:guilabel:`Data Category Labels` toggle switch to the desired
102102
setting.
103+
104+
Color Palette Customization
105+
---------------------------
106+
107+
Palette customization allows you to select custom colors for your
108+
chart. To enable color customization, select the
109+
:guilabel:`Customization` tab of the :guilabel:`Chart Type` column.
110+
A toggle switch labeled :guilabel:`Custom Color Palette` appears in
111+
the :guilabel:`General Customization` section.
112+
113+
Most chart types allow you to customize individual colors in their
114+
palette. The :ref:`heatmap <heatmap-chart-ref>` and :ref:`colored bar
115+
and column <column-bar-chart-ref>` types use a gradient color scale,
116+
while other types use a custom color picker. The gradient color
117+
scale allows you to choose from a set of pre-defined gradients.
118+
119+
.. figure:: /images/charts/custom-gradient.png
120+
:figwidth: 251px
121+
:alt: Custom color palette selection
122+
123+
Other chart types use a color picker for selecting a customized
124+
set of colors.
125+
126+
.. figure:: /images/charts/custom-color-palette.png
127+
:figwidth: 251px
128+
:alt: Custom color palette selection
129+
130+
For chart types which use a color picker for customization,
131+
each numbered color swatch corresponds to a data series on the chart.
132+
Select a color swatch to modify the color of its corresponding
133+
data series. You can select a new color with a color slider, by
134+
entering a hex value, by entering RGB values, or by choosing a
135+
predefined color. You can also drag and drop the existing color
136+
selections if you want to use the current color choices but change
137+
which color goes with which data series.
138+
139+
.. note::
140+
141+
By default, the custom color picker shows color swatches for 10
142+
data series, but you can only modify as many of the swatches as
143+
you have data series. The palette can expand to show 20 data series.
144+
Charts will use as many colors as needed to show your chart,
145+
starting from the first color. For example, if you have only two
146+
data series in your chart, only the colors numbered ``1`` and
147+
``2`` have any effect on your chart.
148+
149+
To close the color customization tool, click somewhere outside it.
150+
To revert the entire chart to its default colors, set the
151+
:guilabel:`Custom Color Palette` toggle switch back to :guilabel:`Off`.
152+
153+
Applicable Chart Types
154+
~~~~~~~~~~~~~~~~~~~~~~
155+
156+
This customization option is available for all chart types except
157+
:ref:`Text <chart-type-text-charts>`.
34.5 KB
Loading
29.6 KB
Loading

0 commit comments

Comments
 (0)