sp-dev-fx-webparts/samples/react-chartcontrol/README.md

9.4 KiB

Chart Control Samples

Summary

This sample contains several web parts that demonstrate how to use the ChartControl from @pnp/spfx-controls-react.

The list of web parts

The web parts in this sample are not intended to be used in production -- they simply demonstrate how you would use all the capabilities of the ChartControl.

NOTE: If you are looking for a ready-to-use web part, please look into joelfmrodrigues' cool react-modern-charts sample, which was built without the ChartControl.

About the samples

We created the ChartControl by popular request of @pnp/spfx-controls-react users who wanted a way to easily insert Chart.js charts into their solutions.

To keep things as easy as possible, the ChartControl supports (most) of the Chart.js functionality (yes, even the use of plugins!).

The samples in this solution mostly use code found from the Chart.js code samples -- with little or no conversion. Wherever possible, we localized strings, moved colors and styles to the web part's SCSS, and used Office Fabric UI components instead of regular buttons.

Each sample retrieves data and passes it to the ChartControl using one of the 3 methods:

  • Static data passed in the control's properties
  • Dynamic data passed through the web part's state
  • Dynamic data passed directly to the ChartControl, without state.

Feel free to use any method you wish for your own web parts.

Web Part List

Accessible Chart

Accessible Chart

Demonstrates the accessibility features of the Chart Control.

This sample shows the table that is automatically generated by the Chart Control.

Area Chart

Area Chart

This sample shows how you can render an area chart and configure the chart to use the fill option, as well as whether to use straight lines or curves.

It also shows how to render gradient fills.

Bar Chart -- Static data

Bar Chart with Static Data

Uses the most basic features of the ChartControl; It uses static data and does not provide any optional parameters.

The ChartControl automatic generates chart colors that mimic the colors you would find in Office.

The control also automatically picks up the environment's theme and changes the chart's background color, lines, and fonts to match the theme.

For accessibility purposes, the ChartControl also renders a hidden table that contains a summary of the data which will be available for those who use a screen reader.

Bar Chart

Bar Chart

Another bar chart, but this one loads data asynchronously from a (fake) service.

While the sample service simply returns an array of numbers, you could replace it with your own code that reads from SharePoint, or any other service.

Bubble Chart

Bubble Chart

This sample demonstrates the use of data elements with a X, Y, and R value to create a bubble chart.

You can even pop the bubbles, which is a fun way to demonstrate event handlers.

Chartinator

Chartinator

This is a Chart Control version of the SharePoint Quick Charts. It supports every chart type and offers many configuration options.

This sample also demonstrates how to create conditional property pane groups and custom property pane controls.

Combo Chart

Combo Chart

Demonstrates how to create combination charts with multiple datasets.

Custom Plugin

Chart with Custom Plugin

If you can't find a Chart.js plugin that already exists, and you want to create your own, simply implement the IChartPlugin interface.

This example takes sample plugin code to create a custom plugin.

The concept for the chart's look and feel came from a StackOverflow question from fsenna.

The custom plugin code is inspired from a JSFiddle written by user8296539 in response to fsenna's question.

Doughnut with Patterns

Doughnut with Patterns

This web part demonstrates how to use the ChartControl to render a donut chart with patterns instead of colors.

It is inspired by the patternomaly sample referred by the Chart.js documentation.

Dynamic Data Callable

Dynamic Data Callable

I wanted to use real data, but didn't want to deal with creating data on SharePoint, so I created a web part that calls the GitHub REST APIs and shows contributors for a given repository.

The sample is also a dynamic data provider. It demonstrates how to respond to mouse events (clicking on a segment of the donut chart will send the data to another web part).

Use in combination with the Dynamic Data Consumer web part.

Dynamics Data Consumer

Dynamic Data Consumer

This demonstrates how to render a chart by receiving events from a dynamic data connection.

It also demonstrates how to render a line chart that looks like the Office 365 Admin dashboards.

Horizontal Bar

Horizontal Bar

This sample shows how to render a horizontal bar chart. It also demonstrates how to create stacked bars.

Line Chart

Line Chart

This sample demonstrates how to render line charts.

Pie Chart

Pie Chart

Demonstrates how to create a pie chart.

Polar Chart

Polar Chart

Creates a polar area chart. Also adds ability to add and remove data.

Radar Chart

Radar Chart

Renders a multi-dataset radar chart.

Real-Time Chart

Real-Time

This sample uses an existing plugin to create a scrolling/real-time chart.

This sample also demonstrates how to use time series for the X axis.

Scatter Chart

Scatter Chart

This sample shows how to use X and Y coordinate data elements in a scatter chart.

Compatibility

SPFx 1.11 Node.js LTS 10.x SharePoint Online Teams Incompatible Workbench Local | Hosted

Applies to

Prerequisites

There are no pre-requisites to use these samples.

Solution

Solution Author(s)
react-chart-control Hugo Bernier (Tahoe Ninjas, @bernierh)

Version history

Version Date Comments
1.0 January, 2019 Initial release
1.1 July 02, 2020 Upgraded to SPFx 1.10.0
1.2 December 04, 2020 Upgraded to SPFx 1.11.0 and Fluent UI 7.x
1.3 December 13, 2020 Upgraded dependencies
1.4 February 25, 2021 Updated to latest version of PnP controls

Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.


Minimal Path to Awesome

  • Clone this repository
  • in the command line run:
    • npm install
    • gulp serve
  • Insert one of the webs part on a page

Features

This Web Part sample pack illustrates the following concepts on top of the SharePoint Framework:

  • Using the @pnp/spfx-controls-react ChartControl
  • Creating static charts
  • Creating dynamic charts using state
  • Creating dynamic charts by calling the ChartControl's update method
  • Responding to chart events
  • Connecting a chart to dynamic data
  • Rendering conditional property pane groups
  • Rendering conditional property pane fields
  • Creating custom property pane controls

Support

We do not support samples, but we do use GitHub to track issues and constantly want to improve these samples.

If you encounter any issues while using this sample, create a new issue.

For questions regarding this sample, create a new question.

Finally, if you have an idea for improvement, make a suggestion.