Skip to content
A lightweight, vanilla JavaScript visualization API built using D3 that integrates well with any consumer’s tech stack. https://engineering.cerner.com/carbon-graphs/
JavaScript Other
Branch: master
Clone or download
semantic-release-bot Chore: 1.9.4 [skip ci]
## [1.9.4](v1.9.3...v1.9.4) (2019-09-19)

### Docs

* Restructured examples, added getting started page (#85) ([2f798d4](2f798d4)), closes [#85](#85)
Latest commit de82888 Sep 19, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
build
dev Fix: Timeline to honour padding right property (fixes #45) (#77) Sep 12, 2019
docs Docs: Restructured examples, added getting started page (#85) Sep 19, 2019
src Fix: x-axis ticks from overlapping (fixes #32) (#80) Sep 18, 2019
.editorconfig
.eslintrc.json Chore: Doc lint preventing deploying the code to gh-pages (#52) Jul 23, 2019
.gitignore
.npmignore Import carbon-graphs to public Jul 7, 2019
.releaserc Build: Added travis.yml, .releaserc semantic-release (#1) Jul 10, 2019
.stylelintrc Import carbon-graphs to public Jul 7, 2019
.travis.yml Build: Added travis.yml, .releaserc semantic-release (#1) Jul 10, 2019
CONTRIBUTORS.md Fix: Timeline to honour padding right property (fixes #45) (#77) Sep 12, 2019
LICENSE Import carbon-graphs to public Jul 7, 2019
NOTICE Import carbon-graphs to public Jul 7, 2019
README.md
jsdoc.json Import carbon-graphs to public Jul 7, 2019
package-lock.json Chore: 1.9.4 [skip ci] Sep 19, 2019
package.json Chore: 1.9.4 [skip ci] Sep 19, 2019

README.md

Carbon (carbon-graphs)

Build Status npm latest version Cerner OSS License semantic-release dependencies Status devDependencies Status Bugs

Carbon is a graphing library built using D3 visualization library. It provides an API for generating native graphs such as Line and Paired Result graphs based on design standards.

Install

You can install Carbon via npm or download the latest release from GitHub.

npm i @cerner/carbon-graphs --save-dev

Getting Started

Please follow this getting started guide.

Dependencies

  • D3 [v3.5.17]
  • Polyfills:
    • Object.assign
    • Object.values

Features

  • Adheres to Cerner standard design template
  • Responsive
  • Native-built graphs
  • Default theme for data points

Graph types

Graph Settings/Toggles

  • Legend
  • Labels
  • Grid vertical & horizontal
  • Axes x and y or y2
  • Regions horizontal

Other highlights

  • Supports different shapes for each data-set
  • Supports custom SVG shapes for data-sets
  • Non-contiguous data point line graph
  • Sparkline graph (with Shapes as hidden)
  • Criticality indicators for data point
  • Locale support for axes ticks
  • Y and Y2 Axes label along with respective shapes

Resources

Browser support

  • Android >= 4.4
  • Chrome >= 35
  • Firefox >= 31
  • Internet Explorer >= 10
  • iOS >= 7
  • Opera >= 12
  • Safari >= 7.1

Potential features

  • Upgrade to latest D3 version
  • Separate graph types to plugin based
  • a11y
  • Support additional themes
  • Scatter-plot graph
  • Area graphs
  • Area spline graphs
  • DST
  • Tick counts
  • Show/hide ticks
  • Pan

LICENSE

Copyright 2017 - 2019 Cerner Innovation, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

You can’t perform that action at this time.