Mastering Qlik Sense

Using custom array items

Array items are particularly useful when you want to give the user the ability to dynamically define several items of the same kind in their visualizations. A good example use case for this is reference lines in a line chart. The user may not need reference lines at all or may want to add one, two, or multiple lines to their chart.

The custom array component helps you define the collection of reference lines into a JavaScript array, which can then be read by the extension code. The general structure, based on a reference line example, looks as follows:

settings: {     uses: "settings",     items: {         horizontalReference: {             type: "array",             ref: "listItems",             label: "Horizontal Reference Line",             itemTitleRef: "reflabel"