ChartDirector Ver 3.1 (PHP Edition Edition)

PolarChart.addExtraField


Usage

addExtraField(texts)

Description

Associate an extra text to each data item or layer.

An extra field is an array of texts that can be associated with data item (the first element with the first data item, the second element with the second data item, and so on), or with layers (the first element with the first layer, the second element with the second layer, and so on). These texts can be used in methods that supports parameter substitution and formatting.

One common usage of extra field is to associate a hidden ID to each data item, so that when the user clicks on the data item, the hidden ID is passed to the handler as query parameters.

To do this, the hidden IDs can be provided to ChartDirector as an array of text using addExtraField. The extra field can then be included in HTML image maps using BaseChart.getHTMLImageMap.

Another common usage is to include additional information in data labels. The additional information can be provided to ChartDirector as an array of text using addExtraField, and be included in data labels using PolarLayer.setDataLabelFormat.

Arguments

ArgumentDefaultDescription
texts(Mandatory)An array of text containing the extra fields.

Return Value

None