Charts

The official repository for all publication ready ONS charts. See our chart menu and service manual for more guidance on the use of these charts, and of charts more generally. NOTE: This repository is still a work in progress.

Related repositories

• Maps: github.com/ONSdigital/Maps provides templates for maps.
• maptemplates: github.com/ONSdigital/maptemplates contains our older map templates that have not yet been replaced in Maps.
• Tables: github.com/ONSdigital/Tables provides templates for simple and grouped tables.
• otherCharts: github.com/ONSdigital/otherCharts contains some of our retired chart templates and work-in-progress charts.
• charts-lib: github.com/ONSdigital/charts-lib provides a copy of the lib folder. The Charts repository is currently the main source for lib files, and the contents are copied to Maps, otherCharts, and charts-lib.

Accessibility

See the (work-in-progress) accessibility report on each chart template.

Making changes to templates

If there’s a problem with a template

Please raise an issue and the team will have a look.

If you want to make a change

Make a branch and name it something descriptive e.g. feature/new-autocomplete. Once you are happy, do a pull request and someone else will review it before it gets merged into main.

Guide to updating and placing an initial commit for a chart

• All missing charts can be found in the issues section of the repository. They will have the following format, “[descriptive chart name]: Initial Commit”.

• If this issue does not have an active branch and you would like to update and upload the chart please create a branch and you will be responsible for updating and making a pull request for the chart.

Initial chart commit checklist

• All initial commits of charts must must follow JavaScript ES6 standards and use D3 v6 or higher.

Links to templates

Chart.Name	Preview	Code	README
Area stacked	View	</>	README
Area stacked sm	View	</>	README
Bar chart	View	</>	README
Bar chart clustered	View	</>	README
Bar chart clustered sm	View	</>	README
Bar chart grouped	View	</>	README
Bar chart grouped clustered	View	</>	README
Bar chart sm	View	</>	README
Bar chart stacked	View	</>	README
Bar chart stacked grouped	View	</>	README
Bar chart stacked sm	View	</>	README
Bar chart with dropdown	View	</>	README
Beeswarm	View	</>	README
Column chart	View	</>	README
Column chart CI bands	View	</>	README
Column chart stacked optional line	View	</>	README
Column chart stacked optional line sm	View	</>	README
Doughnut	View	</>	README
Heatmap	View	</>	README
Line chart	View	</>	README
Line chart dropdown options	View	</>	README
Line chart sm focus	View	</>	README
Line chart sm multiseries	View	</>	README
Line chart with CI area	View	</>	README
Line chart with CI area sm	View	</>	README
Population pyramid	View	</>	README
Range arrow dot bar reference	View	</>	README
Range arrow dot bar reference sm	View	</>	README
Range CI area grouped	View	</>	README
Scatter bubble plot	View	</>	README
Slope chart	View	</>	README
Waterfall	View	</>	README
Z annotation bar example	View	</>	README
Z annotation column example	View	</>	README
Z annotation load from file	View	</>	README
Z annotation toolbar	View	</>	README