Skip to content

RecordEvolution/widget-doughnut

Repository files navigation

<widget-doughnut>

This webcomponent follows the open-wc recommendation.

Installation

npm i widget-doughnut

Usage

<script type="module">
  import 'widget-doughnut/widget-doughnut.js';
</script>

<widget-doughnut></widget-doughnut>

Expected data format

The following format represents the available data :

data: {
  settings: {
    title: string,
    subTitle: string,
    minDoughnut: number,
    maxDoughnut: number,
    style: {
      needleColor: string,
      sections: number,
      backgroundColor: string[]
    }
  }
  doughnutValue: Number
}

Interfaces

  interface InputData {
    settings: Settings
    doughnutValue: number
  }
  interface Settings {
    title: string,
    subTitle: string,
    minDoughnut: number,
    maxDoughnut: number,
    style: Style
  }
  interface Style {
    needleColor: string,
    sections: number,
    backgroundColor: string[]
  }

Style options

The following options are available for styling the doughnut graph. The sections option splits the doughnut area into by default three same sized sections. Therefore three different colors can be provided to the backgroundColor by default.

  interface Style {
    needleColor: string,
    sections: number,
    backgroundColor: string[]
  }

Linting and formatting

To scan the project for linting and formatting errors, run

npm run lint

To automatically fix linting and formatting errors, run

npm run format

Tooling configs

For most of the tools, the configuration is in the package.json to reduce the amount of files in your project.

If you customize the configuration a lot, you can consider moving them to individual files.

Local Demo with web-dev-server

npm start

To run a local development server that serves the basic demo located in demo/index.html