{"id":13702188,"url":"https://github.com/pepstock-org/Charba","last_synced_at":"2025-05-05T04:30:57.973Z","repository":{"id":44499958,"uuid":"106569586","full_name":"pepstock-org/Charba","owner":"pepstock-org","description":"J2CL and GWT Charts library based on CHART.JS","archived":false,"fork":false,"pushed_at":"2024-06-10T11:47:47.000Z","size":694280,"stargazers_count":62,"open_issues_count":3,"forks_count":6,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-11-13T09:40:44.399Z","etag":null,"topics":["chart-library","chartjs","elemental2","elemento","gwt","gwt-charts-library","gwt-library","gwt-widget","j2cl","java","javascript","jsinterop"],"latest_commit_sha":null,"homepage":"https://pepstock-org.github.io/Charba-Wiki/docs","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pepstock-org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-11T15:03:37.000Z","updated_at":"2024-10-18T10:30:45.000Z","dependencies_parsed_at":"2024-01-14T19:14:30.204Z","dependency_job_id":"6d208297-af16-4308-985c-d6eff39ba21f","html_url":"https://github.com/pepstock-org/Charba","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepstock-org%2FCharba","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepstock-org%2FCharba/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepstock-org%2FCharba/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepstock-org%2FCharba/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pepstock-org","download_url":"https://codeload.github.com/pepstock-org/Charba/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252439454,"owners_count":21748007,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chart-library","chartjs","elemental2","elemento","gwt","gwt-charts-library","gwt-library","gwt-widget","j2cl","java","javascript","jsinterop"],"created_at":"2024-08-02T21:00:32.184Z","updated_at":"2025-05-05T04:30:53.821Z","avatar_url":"https://github.com/pepstock-org.png","language":"Java","funding_links":[],"categories":["Diagrams","Integrations"],"sub_categories":["Others"],"readme":"Charba - J2CL and GWT Charts library based on CHART.JS\n======================================================\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/pepstock-org/Charba/releases/latest\"\u003e\u003cimg alt=\"Last release\" src=\"https://img.shields.io/github/release/pepstock-org/Charba.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://mvnrepository.com/artifact/org.pepstock/charba\"\u003e\u003cimg alt=\"Mvn repo release\" src=\"https://img.shields.io/maven-central/v/org.pepstock/charba\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/pepstock-org/Charba/blob/master/LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/pepstock-org/Charba.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/pepstock-org/Charba/actions/workflows/build.yaml\"\u003e\u003cimg alt=\"Build\" src=\"https://github.com/pepstock-org/Charba/workflows/Build/badge.svg?branch=master\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://sonarcloud.io/dashboard?id=pepstock-org_Charba\"\u003e\u003cimg alt=\"Sonar cloud status\" src=\"https://sonarcloud.io/api/project_badges/measure?project=pepstock-org_Charba\u0026metric=alert_status\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://sonarcloud.io/component_measures?id=pepstock-org_Charba\u0026metric=ncloc\"\u003e\u003cimg alt=\"Lines of Code\" src=\"https://sonarcloud.io/api/project_badges/measure?project=pepstock-org_Charba\u0026metric=ncloc\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/chartjs/awesome\"\u003e\u003cimg alt=\"Chart.js awesome\" src=\"https://awesome.re/badge-flat2.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pepstock-org.github.io/Charba/current/\"\u003e\u003cimg alt=\"Last javadoc version\" src=\"https://img.shields.io/badge/Javadoc-Last%20version-F27173.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pepstock-org.github.io/Charba/next/\"\u003e\u003cimg alt=\"Next javadoc version\" src=\"https://img.shields.io/badge/Javadoc-Next%20version-F27173.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pepstock-org.github.io/Charba-Wiki\"\u003e\u003cimg alt=\"Documentation\" src=\"https://img.shields.io/badge/static-Documentation-F27173.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nWhat's Charba\n--------\n\n[GWT Web toolkit](http://www.gwtproject.org/) doesn't have charting library available out of the box.\n\nThere are some open source charting libraries for GWT available to be used but with some constraints or unclear items:\n\n * internet connection needed\n * open source license not completely clear, sometimes with some obligations like to add specific labels\n * old packages not longer maintained\n\nFor all these reasons, **Charba** has been developed, leveraging on [Chart.JS](http://www.chartjs.org/) capabilities which are now available to GWT developers.\n\nNot only GWT\n------------\n\nEven if **Charba** was born only as GWT chart library, as of version 3, **Charba** has been changed in order to be used not only in GWT but also with other DOM frameworks, based on [J2CL - JavaToClosure](https://github.com/google/j2cl), like [Google Elemental2](https://github.com/google/elemental2) or [Elemento](https://github.com/hal/elemento).\n\n**Charba** has got an own DOM manager which allows to it to be independent from any other DOM frameworks (i.e. GWT, Elemental2 or Elemento) but it is providing a set of hooks in order to use it also over those frameworks.\n\n[![CharbaDiagram](https://github.com/pepstock-org/Charba-Wiki/blob/master/static/img/charbaDiagram.png)](https://pepstock-org.github.io/Charba-Wiki/docs/getting-started/Integration)\n    \nBuilding\n--------\n\nTo build **Charba**, you can check out the project and to run [Ant build.xml](https://github.com/pepstock-org/Charba/blob/6.5/build.xml).\n\nThe [Ant build.xml](https://github.com/pepstock-org/Charba/blob/6.5/build.xml) is able to build the 2 artifacts, related to the 2 distributions available.\n\nThe first distribution is a **Charba** file without any GWT dependency (but working on GWT anyway), consumable also in other [J2CL - JavaToClosure](https://github.com/google/j2cl) frameworks, like [Google Elemental2](https://github.com/google/elemental2) and [Elemento](https://github.com/hal/elemento).\n\nTo build the project, execute `buildBinary` target.\n\nIt creates a `charba-[version.release].jar` file in `dist` folder, ready to be included in your project.\n\nThe second distribution is a **Charba** file with a hard GWT dependency which contains charts widgets and code splitting capabilities.\n\nTo build the project, execute `buildBinaryGwt` target.\n\nIt creates a `charba-[version.release]-gwt.jar` file in `dist` folder, ready to be included in your project.\n\n[![Charba](https://github.com/pepstock-org/Charba-Wiki/blob/master/static/img/charba_jar_trend_65.png)](https://github.com/pepstock-org/Charba-Showcase/blob/6.5/src/org/pepstock/charba/showcase/client/views/HomeView.java)\n\nInstallation\n------------\n\nCurrently **Charba** is available on [MVN repository](https://mvnrepository.com/artifact/org.pepstock/charba).\n\nIt is available also on [GitHub releases](https://github.com/pepstock-org/Charba/releases).\n\nIf you are using [Apache Maven](https://maven.apache.org/):\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.pepstock\u003c/groupId\u003e\n    \u003cartifactId\u003echarba\u003c/artifactId\u003e\n    \u003cversion\u003e6.5\u003c/version\u003e\n    \u003c!-- for GWT --\u003e\n    \u003cversion\u003e6.5-gwt\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nIf you are using [Apache Ivy](http://ant.apache.org/ivy/):\n\n```xml\n\u003cdependency org=\"org.pepstock\" name=\"charba\" rev=\"6.5\"/\u003e\n\u003c!-- for GWT --\u003e\n\u003cdependency org=\"org.pepstock\" name=\"charba\" rev=\"6.5-gwt\"/\u003e\n```\n\nTo install in your GWT project, both for GWT and for J2CL artifacts, you must the following configuration in your GWT project module configuration:\n\n```xml\n...\n    \u003cinherits name=\"org.pepstock.charba.Charba\"/\u003e\n...\n```\n\n**Charba** is based on [JSINTEROP](http://www.gwtproject.org/doc/latest/DevGuideCodingBasicsJsInterop.html) method to integrate java script objects.\n\nAs the name suggests, JsInterop is a way of interoperating Java with JavaScript. It offers a better way of communication between the two using annotations instead of having to write java script in your classes (using JSNI).\n\nGallery\n--------\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd style=\"background-color: 'white' !important\"\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=bar\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryBar.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd style=\"background-color: white\"\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=horizontalbar\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryHorizontalBar.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd style=\"background-color: white\"\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=line\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryLine.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd style=\"background-color: white\"\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=verticalline\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryVerticalLine.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003eBar\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eHorizontal bar\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eLine\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eVertical line\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=scatter\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryScatter.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e  \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=doughnut\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryDoughnut.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e  \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=pie\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryPie.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e  \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=polararea\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryPolarArea.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e  \n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003eScatter\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eDoughnut\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003ePie\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003ePolar area\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=radar\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryRadar.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e  \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=bubble\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryBubble.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=timeseries\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryTimeseries.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=stacked\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryStacked.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n  \u003c/tr\u003e  \n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003eRadar\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eBubble\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eTime series\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eStacked\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=meter\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryMeter.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=gauge\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryGauge.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=choropleth\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryChoropleth.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=bubblemap\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryBubbleMap.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n  \u003c/tr\u003e  \n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003eMeter\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eGauge\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eChoropleth\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eBubble map\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=area\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryArea.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=treemap\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryTreemap.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=matrix\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/galleryMatrix.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n    \u003ctd\u003e\n      \u003ca href=\"https://pepstock-org.github.io/Charba-Showcase/index.html?gallery=sankey\"\u003e\n        \u003cimg width=\"200px\" src=\"https://raw.githubusercontent.com/pepstock-org/Charba-Wiki/master/static/img/gallerySankey.png\"/\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e      \n  \u003c/tr\u003e  \n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003eArea\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eTreemap\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eMatrix\u003c/td\u003e\n\t\u003ctd align=\"center\"\u003eSankey\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\nDocumentation\n-------------\n\n**Charba** documentation is published [here](https://pepstock-org.github.io/Charba-Wiki).\n\nAll **Charba** documentation will be maintained in [Charba-Wiki](https://github.com/pepstock-org/Charba-Wiki) project.\n\nAPI JavaDoc for version **6.5** is published [here](https://pepstock-org.github.io/Charba/6.5/index.html).\n\nYou can also access the previous API JavaDoc, because every version is published to `https://pepstock-org.github.io/Charba/[version.release]`.\n\nThe API JavaDoc of the `master` branch is published [here](https://pepstock-org.github.io/Charba/next/).\n\nShowcase\n--------\n\nSee [Charba showcase on GWT](https://pepstock-org.github.io/Charba-Showcase) to have a look what you can do with it.\n\nSee also [Charba showcase GWT source code](https://github.com/pepstock-org/Charba-Showcase) on GitHub as starting point, if you are going to use on GWT.\n\nSee [Charba showcase built by J2CL](https://pepstock-org.github.io/Charba-Showcase-J2CL) and based on [Google Elemental2](https://github.com/google/elemental2), to have a look what you can do with it.\n\nSee also [Charba showcase J2CL source code](https://github.com/pepstock-org/Charba-Showcase-J2CL) on GitHub as starting point, if you are going to use on J2CL.\n\nThe samples are going to reflect what CHART.JS samples are showing [here](http://www.chartjs.org/samples/latest/).\n\nContinuous integration and quality gate\n---------------------------------------\n\n**Charba** is continuously built at every commit and merge in `master` by [GitHub Action](https://github.com/pepstock-org/Charba/actions?query=workflow%3ABuild).\nAt every build, **Charba** is also checked by [Sonar.io](https://sonarcloud.io/dashboard?id=pepstock-org_Charba) in order to have the pulse of its quality.\n\nLicense\n-------\n\n**Charba** is available under the [Apache 2.0 license](https://www.apache.org/licenses/LICENSE-2.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpepstock-org%2FCharba","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpepstock-org%2FCharba","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpepstock-org%2FCharba/lists"}