Module - Ultra Charts
Module - Ultra Charts
Breadcrumbs

Perspective Components

Common Plot Chart Families

The following palette entries provide configurable, preset-based Plot charts: Bar & Rectangular Marks, Line & Area, Points & Text, Rules & Ticks, Network & Flow Marks, Density & Contour Plots, and Geometric Marks.

Purpose

Use these components to create browser-rendered charts from data supplied through Perspective properties and bindings.

Typical Usage

  1. Add a preset from the Ultra Charts palette category.

  2. Bind the public data property to a value available in the Perspective view.

  3. Configure the public chart properties, such as marks, scales, layout, and styling.

  4. Preview the result and save the Perspective project.

Data Guidance

For simple charts, use row-oriented data with field names that match the configured marks. A safe example is:

{
  "data": [
    {"category": "A", "value": 12},
    {"category": "B", "value": 19}
  ],
  "marks": [
    {"type": "barY", "options": {"x": "category", "y": "value"}}
  ]
}

Treat presets as starting points. Test any advanced options in the target project before standardizing them across operational views.

Events

The Plot chart families expose onSelect and onBrush events. Configure handlers in the Perspective event editor. Event results depend on the selected chart configuration, data shape, and enabled interaction.

Sankey Chart

Purpose

Use Sankey chart to display named nodes and quantified links between them.

Typical Usage

  1. Add Sankey chart to a Perspective view.

  2. Bind data containing node and link collections.

  3. Ensure node names are unique and each link references valid nodes with a numeric value.

  4. Configure alignment, appearance, and optional click or drag behavior.

Important Properties

The public properties include the data, node alignment, node and link styling, click enablement, and optional node dragging. Clicks can raise onNodeClick and onLinkClick events when enabled.

Behavior

Node dragging changes the current rendered layout only. It is not a confirmed persistence mechanism for the chart data or project configuration.

Expert-mode

Purpose

Use Expert-mode when a trusted project developer needs a custom D3 visualization that is not covered by the included components and presets.

Typical Usage

  1. Add Expert-mode to a Perspective view.

  2. Bind the public data property.

  3. Set the public chart-code property to tested project-authored JavaScript that produces the intended browser visual.

  4. Preview the view and correct browser-reported errors before deployment.

Important Properties

The public configuration consists primarily of the chart data, chart code, and standard Perspective styling.

Behavior

Expert-mode code runs in the Perspective browser context. It is intended only for trusted, controlled project content and is not an operator-facing chart authoring tool.


Last updated: