The user can change the scale of an axis on a chart by using the zoom function. This function spreads or shrinks the scale of the horizontal or vertical axis. Both the categorical and continuous axes can be zoomed.
Example of zoom on a horizontal categorical axis
Example of zoom on a horizontal continuous axis
This type of zoom is called scale zoom (as opposed to optical zoom) because when the user zooms, only the scale and the encoding objects, such as bars, bubbles, and lines are changed, but all the text, the axis line, the legend, and icons remain identical.
Note that semantic zoom is not yet supported. Semantic zoom is only applicable if one dimension is hierarchical. It changes the level of the hierarchy currently displayed and aggregates data accordingly.
The zooming direction depends on the scrolling direction of the chart. The zooming direction cannot be changed since it is defined individually for each chart type.
For charts that scroll horizontally, the zoom changes the scale of the horizontal axis.
For charts that scroll vertically, the zoom changes the scale of the vertical axis.
How To Zoom
There are four ways of zooming:
- Toolbar: Use the zoom icons in the chart toolbar.
- Mouse wheel: Use CTRL plus the mouse wheel to zoom in and out.
- Gesture: On a touch screen, use the pinch and spread gesture.
- Keyboard: Use the [+] and [-] keys to zoom in and out.
Toolbar Zoom Icons
The charts cannot be zoomed by default. This must be defined explicitly.
If you define the chart as zoomable, you must also declare the two zoom icons in the chart toolbar. These icons are correctly positioned in the toolbar and automatically pilot the zooming feature in the chart.
The user can control the zoom scale by defining the following settings:
- Whether the zoom is enabled (property:interaction.zoom.enablement).
- The initial range to be displayed (property:plotArea.window.start and property:plotArea.window.end).
No Initial Range
This is the default setting of the charts.
The display starts with the first data point of the data set, and the initial scale is calculated to avoid data points that are too small. A scrollbar is used if necessary. The user can zoom in to see more details or zoom out to see an overview of the data set.
The first data point of the data set is displayed. The scale is fixed and cannot be changed. A scrollbar is used if necessary.
Initial Range = Entire Data Set
The chart is initialized to display the entire data set, but the user can zoom in to see more details of the data points.
The chart always displays the entire overview of the data set even when the chart is resized. The user cannot zoom the chart manually.
Initial Range = Subset of Data Set
The chart is initialized to display the defined range. A scroll bar appears.
The user can zoom in to see more details of the data points or zoom out to see an overview of the data set.
The chart is initialized to display the range. A scroll bar appears. As the user cannot zoom, the scale cannot be changed.
You must ensure that the data points are large enough to work on a touch screen. Therefore, this setting is only recommended if you know the size of the chart container in advance.
Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.