highcharts-accessible-configuration-kit
v2.1.0
Published
Highcharts Accessible Configuration Kit (HACK) is an intuitive, user-friendly [highcharts](https://api.highcharts.com/highcharts/) editor tool developed in Vue 3. HACK empowers users to transform their data source (.csv, .xlsx) into fully configured Highc
Readme
Highcharts Accessible Configuration Kit
Highcharts Accessible Configuration Kit (HACK) is an intuitive, user-friendly highcharts editor tool developed in Vue 3. HACK empowers users to transform their data source (.csv, .xlsx) into fully configured Highcharts configuration files. All basic chart types are supported in the editor alongside hybrid chart types, while allowing for chart customization options. The application is fully compliant with accessibility standards and allows for users to export ready-to-use Highcharts configuration files with no previous knowledge of the API. HACK is developed and maintained by the Web Mapping Team at Environment and Climate Change Canada.
Plugin Usage
To use HACK as a plugin in your Vue 3 project, follow these steps:
1. Install package from npm:
npm install highcharts-accessible-configuration-kitNote - other packages should also be installed in host application, listed below:
vue-i18npiniahighcharts-vuevue-final-modalvue-papa-parse
2. Install the plugin in your Vue app:
import { createApp } from 'vue';
import App from './app.vue';
const app = createApp(App);
import HighchartsAccessibleConfigurationKit from 'highcharts-accessible-configuration-kit';
import 'highcharts-accessible-configuration-kit/dist/highcharts-accessible-configuration-kit.css';
app.use(HighchartsAccessibleConfigurationKit);3. Merge i18n messages exported from the plugin:
import { highchartsMessages } from 'highcharts-accessible-configuration-kit';
createI18n({
...,
messages: {
en: { ...appMessages.en, ...highchartsMessages.en },
fr: { ...appMessages.fr, ...highchartsMessages.fr }
}
});4. Use HACK component in your Vue templates, here is a demo snippet for usage:
<highcharts-accessible-configuration-kit
:key="`new-editor-${chartIdx}`"
:plugin="true"
:lang="'en'"
:title="$t('editor.chart.label.newTitle')"
@cancel="() => $vfm.close('highcharts-create-modal')"
@saved="(chartConfig) => console.log('New chart config saved: ', chartConfig)"
/>
Project setup
npm installCompiles and hot-reloads for development
npm run devCompiles and minifies for production
npm run buildLints and fixes files
npm run lint