@nebula.js/sn-combo-chart:properties

v1.7.0

Combo chart generic object definition

properties

namespace

Properties

barGrouping

Bar grouping.

color

Color settings. Most color options for visualizations are set in the color object in the options. You activate custom coloring by setting "auto": false which turns off auto-coloring. If "auto": true, no other properties need to be defined in the color object. Note: Some of the color properties are depending on which theme is currently being used.

components
Array<Line | Bar>

Styling of chart components.

dataPoint

Data point settings.

dimensionAxis

Dimension axis settings.

footnote
optional
string | StringExpression

Visualization footnote.

legend

Legend settings.

measureAxes

Measure axes settings. Must be an array with 2 measureAxis objects.

nullMode
optional, default='gap'
'gap' | 'connect' | 'zero'

Null value presentation

orientation
default='vertical'
'vertical' | 'horizontal'

Chart orientation setting. If vertical, the dimension axis can only be docked on bottom or top and measure axis on left or right. If horizontal, the dimension axis can only be docked on left or right and measure axis on bottom or top.

preferContinuousAxis
default=true
boolean

Chart axis setting to control preference of scale on a dimensional axis. If true, the scale along the dimensional axis will be continuous if the data supports it, discrete otherwise.

qHyperCubeDef

Extends HyperCubeDef, see Engine API: HyperCubeDef.

refLine

Reference lines settings

scrollStartPos
number

Scroll Alignment. Decides if the scroll starts at the beginning or end of the data. Where 0 means at the beginning and 1 at the end.

showMiniChartForContinuousAxis
default=true
boolean

Chart axis setting to turn on/off the mini chart for continuous axis.

showTitles
optional, default=true
boolean

Show title for the visualization.

subtitle
optional
string | StringExpression

Visualization subtitle.

title
optional
string | StringExpression

Visualization title.

tooltip

Custom tooltip properties

version
string

Current version of this generic object definition.

Accumulation

object

It allows you to accumulate values of your measure over one dimension.

Properties

type
string

This should be set to "accumulation".

fullAccumulation
boolean

Select whether the accumulation will happen on the Full range or Custom range.

steps
optional
number

Only applicable when fullAccumulation is set to false. The number of steps in the dimensions which form an accumulation range. Only zero and positive integers are accepted. Note: Sorting order of dimension values (or step order) is important and affects results.

showExcludedValues
boolean

Shows the excluded values (values not in the current selection) in the accumulation.

disabled
optional
boolean

No description

AttributeDimensionProperties

object
extendsNxAttrDimDef

Extends NxAttrDimDef, see Engine API: NxAttrDimDef.

Properties

id
string

One of: colorByAlternative: colors the chart using different dimensions (can be used together with color.mode="byDimension") or colorByExpression together with color.mode="byExpression".

AttributeExpressionProperties

Bar

object

Properties

key
string

This should be set to "bar" (Determines which component the settings apply to).

style

No description

BarStyling

object

Properties

strokeColor

Color information structure. Holds the actual color and index in palette.

strokeWidth
default='none'
'none' | 'small' | 'medium' | 'large'

Set to specify stroke width.

width
number

A number greater than 0 and less than or equal to 1.

ColorAttributes

object
extendsNxAttrExprDef

Extends NxAttrExprDef, see Engine API: NxAttrExprDef.

Properties

id
string

One of: colorByAlternative: colors the chart using different dimensions (can be used together with color.mode="byDimension"), colorByExpression together with color.mode="byExpression" or colorByMeasureExpression togehter with color.mode="byExpression" on the current measure.

Component

CustomTooltipAttributes

object
extendsNxAttrExprDef

Extends NxAttrExprDef, see Engine API: NxAttrExprDef.

Properties

id
'customTooltipTitle' | 'customTooltipDescription' | 'customTooltipExpression'

Indicates how the attribute expression will be interpreted by the chart. customTooltipTitle: additional title displayed on the custom tooltip customTooltipDescription: description displayed on the custom tooltip customTooltipExpression: measures displayed on the custom tooltip

```json
"qAttributeExpressions": [{
  "qExpression": "",
  "qLibraryId": "",
  "qAttribute": true,
  "qNumFormat": {
     "qType": "U",
     "qnDec": 10,
     "qUseThou": 0,
     "qFmt": "",
     "qDec": "",
     "qThou": "",
   }
  "qLabel": "custom title",
  "qLabelExpression": "",
  "id": "customTooltipTitle"
},
{
  "qExpression": "avg(population)",
  "qLibraryId": "",
  "qAttribute": true,
  "qNumFormat": {
     "qType": "U",
     "qnDec": 10,
     "qUseThou": 0,
     "qFmt": "",
     "qDec": "",
     "qThou": "",
   }
  "qLabel": "",
  "qLabelExpression": "",
  "id": "customTooltipDescription"
},
{
  "qExpression": "",
  "qLibraryId": "zpDNMcg",
  "qAttribute": true,
  "qNumFormat": {
     "qType": "U",
     "qnDec": 10,
     "qUseThou": 0,
     "qFmt": "",
     "qDec": "",
     "qThou": "",
   }
  "qLabel": "",
  "qLabelExpression": "",
  "id": "customTooltipExpression"
},
{
  "qExpression": "sum(population)",
  "qLibraryId": "",
  "qAttribute": true,
  "qNumFormat": {
     "qType": "M",
     "qnDec": 2,
     "qUseThou": 0,
     "qFmt": "$#,##0.00;-$#,##0.00",
     "qDec": ".",
     "qThou": ",",
   }
  "qLabel": "",
  "qLabelExpression": "=avg(population)",
  "id": "customTooltipExpression"
},
{
  "qExpression": "'https://my_url/'+sum(population)",
  "qLibraryId": "",
  "qAttribute": true,
  "qNumFormat": null,
  "qLabel": "",
  "qLabelExpression": "",
  "cId": "generatedUniqueId",
  "id": "customTooltipImages"
}]
```

DimensionProperties

object
extendsNxDimension

Extends NxDimension, see Engine API: NxDimension.

Properties

qAttributeDimensions

No description

qDef

Extends NxInlineDimensionDef, see Engine API: NxInlineDimensionDef.

dimRefLine

object

Properties

show
default=true
boolean | ValueExpression

Set to true to display this reference line.

label
string

Reference line label.

showLabel
optional, default=true
boolean

Set to true to show the label of this reference line.

showValue
optional, default=true
boolean

Set to true to show the value of this reference line.

paletteColor

Color information structure. Holds the actual color and index in palette.

style
optional

Styling settings for reference line

coloredBackground
optional
boolean

Set to true to fill the label and/or value of this reference line with this color

align
optional, default='center'
'start' | 'center' | 'end'

Set alignment for this reference line

refLineExpr

No description

ImageComponent

object

Image component information structure.

Properties

type
string

Input type as 'url' or 'media library'

size
string

Size as 'small','medium','large' or 'original'

cId
string

Identifier of the image component - used as a link with an attribute expression

ref
string | StringExpression | MediaLibraryRef

The reference value of the image

InlineDimensionDef

object
extendsNxInlineDimensionDef

Extends NxInlineDimensionDef, see Engine API: NxInlineDimensionDef.

Properties

autoSort
optional
boolean

Set to automatically sort the dimension.

cId
optional
string

ID used by the Qlik Sense. Must be unique within the current chart.

othersLabel
string | StringExpression

No description

InlineMeasureDef

object
extendsNxInlineMeasureDef

Extends NxInlineMeasureDef, see Engine API: NxInlineMeasureDef.

Properties

autoSort
optional
boolean

Set to automatically sort the measure.

cId
optional
string

ID used by the Qlik Sense. Must be unique within the current chart.

modifiers
optional

Set to apply a modifier to a measure.

isCustomFormatted
boolean

Set to true to toggle off the default client formatting.

numFormatFromTemplate
default=true
boolean

When enabled, the number format to use can be selected from multiple predefined formats based on the desired type (number, date).

othersLabel
string | StringExpression

No description

series
optional

Series information that defines the type of series and how it is represented.

color
optional

Series information that defines the type of series and how it is represented.

Line

object

Properties

key
string

This should be set to "line" (Determines which component the settings apply to).

style

No description

LineStyling

object

Properties

dataPointSize
default=6
number

Set to specify the size of the data point.

lineCurve
default='"linear"'
'linear' | 'monotone'

No description

lineThickness
default=1
number

Set to specify line thickness. Can be set from 1 to 5.

lineType
default='"solid"'
'solid' | 'dashed'

No description

MasterVisualizationChart

object

Chart component information structure.

Properties

style

Chart component information structure.

object

Chart component information structure.

MasterVisualizationChartObject

object

Chart component information structure.

Properties

refId
string

Input field containing the qExtendsId of the visualization, where qExtendsId is the unique id of the master visualization

MasterVisualizationChartStyle

object

Chart component information structure.

Properties

size
string

Input type as 'small' or 'medium' or 'large'

measureAxis

object

Properties

show
optional, default='"all"'
'all' | 'labels' | 'title' | 'none'

Labels and title

dock
optional, default='"near"'
'near' | 'far'

Axis docking position

spacing
optional, default=1
number

Axis scale

autoMinMax
optional, default=true
boolean

Automatic max/min

minMax
'min' | 'max' | 'minMax'

Set custom max/min

min
number | ValueExpression

Axis min value. "autoMinMax" must be set to false and "minMax" must be set to "min" or "minMax" to use this property

max
number | ValueExpression

Axis max value. "autoMinMax" must be set to false and "minMax" must be set to "max" or "minMax" to use this property

MeasureColor

object

Series information that defines the type of series and how it is represented.

Properties

on
boolean

Set if the color settings should be used

mode
default='"primary"'
'primary' | 'byExpression'

Sets the coloring mode for the measure when coloring has been switched on Can be one of:

  • primary: a single color (by default blue) is used. single color is the default setting.
  • byExpression: coloring is based on an expression. The expression are set in the "colorExpression" property.
paletteColor
default={

Color information structure. Holds the actual color and index in palette.

colorExpression
optional
string

Sets the color expression to be used when "mode": "byExpression" is defined. Expression is a color code. Supported formats are: RGB, ARGB and HSL

MeasureProperties

object
extendsNxMeasure

Extends NxMeasure, see Engine API: NxMeasure.

Properties

qAttributeExpressions

No description

qDef

Extends NxInlineMeasureDef, see Engine API: NxInlineMeasureDef.

MediaLibraryRef

object

Media Library Reference structure.

Properties

qStaticContentUrlDef
object

Media library structure

Modifier

Accumulation

It allows you to accumulate values of your measure over one dimension.

Properties

type
string

This should be set to "accumulation".

fullAccumulation
boolean

Select whether the accumulation will happen on the Full range or Custom range.

steps
optional
number

Only applicable when fullAccumulation is set to false. The number of steps in the dimensions which form an accumulation range. Only zero and positive integers are accepted. Note: Sorting order of dimension values (or step order) is important and affects results.

showExcludedValues
boolean

Shows the excluded values (values not in the current selection) in the accumulation.

disabled
optional
boolean

No description

paletteColor

object

Color information structure. Holds the actual color and index in palette.

Properties

color
string

Color as hex string (mandatory if index: -1)

index
number

Index in palette

qStaticContentUrlDef

object

Media Library structure that will be evaluated by the engine.

Properties

qUrl
string

Value of media library image

refLine

object

Properties

show
default=true
boolean | ValueExpression

Set to true to display this reference line.

label
string

Reference line label.

showLabel
optional, default=true
boolean

Set to true to show the label of this reference line.

showValue
optional, default=true
boolean

Set to true to show the value of this reference line.

paletteColor

Color information structure. Holds the actual color and index in palette.

style
optional

Styling settings for reference line

coloredBackground
optional
boolean

Set to true to fill the label and/or value of this reference line with this color

refLineExpr

No description

refLineStyle

object

Styling settings for reference line

Properties

lineThickness
optional, default=2
number

Set the thickness for this reference line.

lineType
optional, default=''
string

Set the dash type for this reference line.

Series

object

Series information that defines the type of series and how it is represented.

Properties

type
optional, default='"bar"'
'bar' | 'line' | 'marker'

Set the type of series. Defaults to 'bar' with less than 2 measure, otherwise 'line'.

axis
optional
0 | 1

Set which axes the series should be represented on. 0 for primary axis and 1 for secondary axis. Defaults to primary with less than 2 measure, otherwise secondary axis.

options

Series options for the Marker type.

SeriesMarkerOptions

object

Series options for the Marker type.

Properties

type
optional, default='"circle"'
'circle' | 'line' | 'diamond' | 'triangle' | 'rect'

Set the type of marker.

fill
optional, default=true
boolean

Set to true if the marker should be filled with a color. If false, only stroke of the marker is rendered.

Was this page helpful?