New `options.resolve` helper that determines the final value to use from an array of input values (fallback) and a given context and/or index. For now, only the bubble chart support scriptable options, see documentation for details. Add scriptable options documentation and update the bubble chart dataset properties table with their scriptable and indexable capabilities and default values. Also move point style description under the element configuration section.
1.6 KiB
Options
Scriptable Options
Scriptable options also accept a function which is called for each data and that takes the unique argument context
representing contextual information (see option context).
Example:
color: function(context) {
return context.data < 0 ? 'red' : // draw negative values in red
index%2 ? 'blue' : 'green'; // else, alternate values in blue and green
}
Note: scriptable options are only supported by a few bubble chart options.
Indexable Options
Indexable options also accept an array in which each item corresponds to the element at the same index. Note that this method requires to provide as many items as data, so, in most cases, using a function is more appropriated if supported.
Example:
color: [
'red', // color for data at index 0
'blue', // color for data at index 1
'green', // color for data at index 2
'black', // color for data at index 3
//...
]
Option Context
The option context is used to give contextual information when resolving options and currently only applies to scriptable options.
The context object contains the following properties:
chart
: the associated chartdataIndex
: index of the current datadataset
: dataset at indexdatasetIndex
datasetIndex
: index of the current dataset
Important: since the context can represent different types of entities (dataset, data, etc.), some properties may be undefined
so be sure to test any context property before using it.