ui-percentage-circle
A lightweight, simple-to-use circular percentage graph web component. Pass in the percentage number, with color of your choice, then ui-percentage-circle will handle the rest.
Since this is a web component, you can just use directly in your HTML like
this
To use it with other framework e.g Angular, React, Vue etc. see Framework Integrations
from Stencil site.
Note
Feature custom color of your choice is still under development
Using this component
There are three strategies to use web components built with Stencil.
Script tag
- Put a script tag similar to this
<script type='module' src='https://unpkg.com/ui-percentage-circle@<latest-version>/dist/ui-percentage-circle.esm.js'></script>
in the head of your index.html - Then you can use the element anywhere in your template, JSX, html etc
Node Modules
- Run
npm install ui-percentage-circle --save
- Put a script tag similar to this
<script type='module' src='node_modules/ui-percentage-circle/dist/ui-percentage-circle.esm.js'></script>
in the head of your index.html - Then you can use the element anywhere in your template, JSX, html etc
In a stencil-starter app
- Run
npm install ui-percentage-circle --save
- Add an import to the npm packages
import ui-percentage-circle;
- Then you can use the element anywhere in your template, JSX, html etc
Feedback
If you have found a bug or have another issue with the library — please create an issue.
If you have a question regarding the library or it's integration with your project — consider asking a question at StackOverflow.
Have any ideas or propositions? Feel free to develop it further. See Developer guide below.
Cheers!
Developer guide
You're welcome to make this component even more flexible, scalable and robust! Fork, clone, create a feature branch, implement your feature, cover it with tests, commit, create a PR.
npm install
npm start // run development server serving src/index.html
To build the component for production, run:
npm run build
To run the unit tests for the components, run:
npm test
Support
If you like this library consider to add star on GitHub repository.
Thank you!