Simple Donut Chart

Category: Widgets
Subcategory: Display widgets

Overview

Display a simple donut chart with smooth hover effect. The input data is based on listview-style input. The item type is configurable.

The size of the donut chart is relative to it's parent container. Place the donut chart inside a layoutgrid, for example, to set it's width. Relative widths work better in combination with responsive screens.

Documentation

SimpleDonutChart

Display a simple donut chart with smooth hover effect. The input data is based on listview-style input. The item type is configurable.

The size of the donut chart is relative to it's parent container. Place the donut chart inside a layoutgrid, for example, to set it's width. Relative widths work better in combination with responsive screens.

Features

General

Set listview context within the app and configure chart value (Integer) and value names (string).

Both the chart legend and the donut chart segments can be hovered to see some additional information inside a tooltip.

Sorting

Sorting options: The results can be sorted by name, value or even via custom attribute (Integer).

Colors

Configure the colors that will be used for each item in the list. The widget uses an array of 6 default colors.

Visual details

Display unit type (String).

Unit type position: before or after the value.

Display the total (Boolean).

Display values inside the legend and tooltip (Boolean).

Display percentages inside the donut chart (Boolean).

legendTitle (Expression): Title for the legend, can be used as prefix for the totals.

Events

Set an onClick action.

Usage

  1. Install NPM package dependencies by using: npm install. If you use NPM v7.x.x, which can be checked by executing npm -v, execute: npm install --legacy-peer-deps.
  2. Run npm start to watch for code changes. On every change:
    • the widget will be bundled;
    • the bundle will be included in a dist folder in the root directory of the project;
    • the bundle will be included in the deployment and widgets folder of the Mendix test project.

Releases

Version: 1.0.2
Framework Version: 9.10.1
Release Notes: Bugfixes: - Fix error when no rotate values - Fix error with tooltip after click
Version: 1.0.1
Framework Version: 9.7.0
Release Notes: Improve chart legend for print
Version: 1.0.0
Framework Version: 9.7.0
Release Notes: Initial release