VisualizerBase

Empties the toolbar, header, footer, and content containers.

If you want to empty and delete the visualizer and all its elements from the DOM, call the destroy() method instead.

Type:

() => void

Implemented in:

VisualizerBase

Obsolete. Use surveyData instead.

Type:

any readonly

Implemented in:

VisualizerBase

Deletes the visualizer and all its elements from the DOM.

Type:

() => void

Implemented in:

VisualizerBase

See also:

clear

Allows you to access the footer visualizer. Returns undefined if the footer is absent.

Type:

VisualizerBase readonly

Implemented in:

VisualizerBase

See also:

hasFooter

Returns an array of calculated and visualized values. If a user applies a filter, the array is also filtered.

To get an array of source survey results, use the surveyData property.

Type:

() => any

Implemented in:

VisualizerBase

Obsolete. Use getCalculatedValues() instead.

Type:

() => any

Implemented in:

VisualizerBase

Returns an object with properties that describe a current visualizer state. The properties are different for each individual visualizer.

This method is overriden in descendant classes.

Type:

() => any

Implemented in:

VisualizerBase

See also:

setState

Indicates whether the visualizer displays a footer. This property is true when a visualized question has a comment.

Type:

boolean readonly

Implemented in:

VisualizerBase

See also:

hasHeader

Indicates whether the visualizer displays a header. This property is true when a visualized question has a correct answer.

Type:

boolean readonly

Implemented in:

VisualizerBase

See also:

hasFooter

Gets or sets the current locale.

If you want to inherit the locale from a visualized survey, assign a SurveyModel instance to the survey property of the options object in the constructor.

If the survey is translated into more than one language, the toolbar displays a language selection drop-down menu.

Type:

string writable

Implemented in:

VisualizerBase

See also:

onLocaleChanged

Returns the identifier of a visualized question.

Type:

any readonly

Implemented in:

VisualizerBase

An event that is raised after the visualizer's content is rendered.

Parameters:

• sender: VisualizerBase
  A VisualizerBase instance that raised the event.

• options.htmlElement: HTMLElement
  A page element with the visualizer's content.

Type:

Event<(sender: VisualizerBase, options: any) => any, VisualizerBase, any>

Implemented in:

VisualizerBase

See also:

render * , refresh **

An event that is raised after a new locale is set.

Parameters:

• sender: VisualizerBase
  A VisualizerBase instance that raised the event.

• options.locale: String
  The indentifier of a new locale (for example, "en").

Type:

Event<(sender: VisualizerBase, options: { locale: string; }) => any, VisualizerBase, any>

Implemented in:

VisualizerBase

See also:

locale

Re-renders the visualizer and its content.

Type:

() => void

Implemented in:

VisualizerBase

Registers a function used to create a toolbar item for this visualizer.

The following code shows how to add a custom button and drop-down menu to the toolbar:

import { VisualizationPanel, DocumentHelper } from "survey-analytics";

const vizPanel = new VisualizationPanel( ... );

// Add a custom button to the toolbar
vizPanel.visualizers[0].registerToolbarItem("my-toolbar-button", () => {
  return DocumentHelper.createButton(
    // A button click event handler
    () => {
      alert("Custom toolbar button is clicked");
    },
    // Button caption
    "Button"
  );
});

// Add a custom drop-down menu to the toolbar
vizPanel.visualizers[0].registerToolbarItem("my-toolbar-dropdown", () => {
  return DocumentHelper.createSelector(
    // Menu items
    [
      { value: 1, text: "One" },
      { value: 2, text: "Two" },
      { value: 3, text: "Three" }
    ],
    // A function that specifies initial selection
    (option) => false,
    // An event handler that is executed when selection is changed
    (e) => {
      alert(e.target.value);
    }
  );
});

Type:

(name: string, creator: (toolbar?: any) => any) => void

Parameters:

name, type: string ,

A custom name for the toolbar item.

creator, type: (toolbar?: any) => any ,

A function that accepts the toolbar and should return an HTMLElement with the toolbar item.

Implemented in:

VisualizerBase

See also:

unregisterToolbarItem

Renders the visualizer in a specified container.

Type:

(targetElement: any) => void

Parameters:

targetElement, type: any ,

An HTMLElement or an id of a page element in which you want to render the visualizer.

Implemented in:

VisualizerBase

Sets the visualizer's state.

This method is overriden in descendant classes.

Type:

(state: any) => void

Parameters:

state, type: any

Implemented in:

VisualizerBase

See also:

getState

Gets or sets the visibility of the visualizer's toolbar.

Default value: true

Type:

boolean writable

Implemented in:

VisualizerBase

Indicates whether users can select series points to cross-filter charts. To allow or disallow selection, set the allowSelection property of the options object in the constructor.

Type:

boolean readonly

Implemented in:

VisualizerBase

Returns an array of survey results used to calculate values for visualization. If a user applies a filter, the array is also filtered.

To get an array of calculated and visualized values, call the getCalculatedValues() method.

Type:

any readonly

Implemented in:

VisualizerBase

Returns the visualizer's type.

Type:

string readonly

Implemented in:

VisualizerBase

Unregisters a function used to create a toolbar item. Allows you to remove a toolbar item.

Type:

(name: string) => (toolbar?: any) => any

Parameters:

name, type: string ,

A toolbar item name.

Return Value:

A function previously used to [register](#registerToolbarItem) the removed toolbar item.

Implemented in:

VisualizerBase

See also:

registerToolbarItem

Updates visualized data.

Type:

(data: any) => void

Parameters:

data, type: any ,

A data array with survey results to be visualized.

Implemented in:

VisualizerBase