Update Queries with Axis Labels or Pickers

This applies to: Visual Data Discovery

Axis Labels or Axis Pickers are Symphony native controls that can be added to charts to provide a way for users to change query parameters dynamically. Chart developers can these controls by calling the method controller.createaAxisLabel. The createAxislabel method takes an object as its only argument with the following properties:

Option Description

Option	Description
`picks`	Name of the query variable. Use the data accessor’s `getName` method to avoid hardcoding variable names.
`position`	Location of the axis label in the chart widget. Valid options: `bottom`, `left`, `right`, `top`
`orientation`	Orientation of the axis label text. Valid options: `vertical`, `horizontal`

picks

Name of the query variable.

Use the data accessor’s getName method to avoid hardcoding variable names.

position

Location of the axis label in the chart widget.

Valid options: bottom, left, right, top

orientation

Orientation of the axis label text.

Valid options: vertical, horizontal

Example:

controller.createAxisLabel({
  picks: 'Group By',
  position: 'bottom',
  orientation: 'horizontal',
});

controller.createAxisLabel({
  picks: 'Size',
  position: 'bottom',
  orientation: 'horizontal',
});

The above example adds two axis pickers to the chart that provide users with the ability to change the fields used for the Group By and Size query variables.