Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/open-data-plan/g2plot-vue

g2plot for vue, both 2 and 3
https://github.com/open-data-plan/g2plot-vue

antv g2 g2plot g2plot-vue vue vue2 vue3

Last synced: about 5 hours ago
JSON representation

g2plot for vue, both 2 and 3

Host: GitHub
URL: https://github.com/open-data-plan/g2plot-vue
Owner: open-data-plan
License: mit
Created: 2020-08-06T06:46:36.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2024-04-12T11:04:37.000Z (7 months ago)
Last Synced: 2024-04-12T22:30:29.482Z (7 months ago)
Topics: antv, g2, g2plot, g2plot-vue, vue, vue2, vue3
Language: TypeScript
Homepage: https://g2plot-vue.opd.cool/
Size: 26 MB
Stars: 128
Watchers: 4
Forks: 13
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        






# @opd/g2plot-vue

> [G2Plot](https://g2plot.antv.vision/) for `Vue`, both `v2` and `v3`, see [documentation](https://g2plot-vue.opd.cool) for more

[![build](https://github.com/open-data-plan/g2plot-vue/workflows/build/badge.svg)](https://github.com/open-data-plan/g2plot-vue/actions?query=workflow%3Abuild)

[![npm](https://img.shields.io/npm/v/@opd/g2plot-vue.svg)](https://www.npmjs.com/package/@opd/g2plot-vue)

[![npm](https://img.shields.io/npm/dm/@opd/g2plot-vue.svg)](https://www.npmjs.com/package/@opd/g2plot-vue)

[![npm](https://img.shields.io/npm/l/@opd/g2plot-vue.svg)](https://www.npmjs.com/package/@opd/g2plot-vue)

[![codecov](https://codecov.io/gh/open-data-plan/g2plot-vue/branch/master/graph/badge.svg)](https://codecov.io/gh/open-data-plan/g2plot-vue)

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fopen-data-plan%2Fg2plot-vue.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fopen-data-plan%2Fg2plot-vue?ref=badge_shield)

## Install

```

npm install @opd/g2plot-vue

```

`g2plot-vue` will auto switch export version based on your installed `vue` version, if not work, you can switch by follow:

```bash

node ./node_modules/@opd/g2plot-vue/scripts/postinstall.js

```

## Usage

[![Edit g2plot-vue-basic-example](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/g2plot-vue-basic-example-uxde9?fontsize=14&hidenavigation=1&theme=dark)

### jsx

```tsx

import { defineComponent, ref } from 'vue'

import { LineChart, LineChartProps } from '@opd/g2plot-vue'

const config: LineChartProps = {

  height: 350,

  autoFit: true,

  xField: 'year',

  yField: 'value',

  smooth: true,

  meta: {

    value: {

      max: 15,

    },

  },

  data: [

    { year: '1991', value: 3 },

    { year: '1992', value: 4 },

    { year: '1993', value: 3.5 },

    { year: '1994', value: 5 },

    { year: '1995', value: 4.9 },

    { year: '1996', value: 6 },

    { year: '1997', value: 7 },

    { year: '1998', value: 9 },

    { year: '1999', value: 11 },

  ],

}

export default defineComponent(() => {

  const chartRef = ref(null)

  return () => 

})

```

### template

```vue

  

import Vue from 'vue'

import { LineChart } from '@opd/g2plot-vue'

Vue.use(LineChart)

export default {

  data() {

    return {

      config: {

        height: 350,

        autoFit: true,

        xField: 'year',

        yField: 'value',

        smooth: true,

        meta: {

          value: {

            max: 15,

          },

        },

        data: [

          { year: '1991', value: 3 },

          { year: '1992', value: 4 },

          { year: '1993', value: 3.5 },

          { year: '1994', value: 5 },

          { year: '1995', value: 4.9 },

          { year: '1996', value: 6 },

          { year: '1997', value: 7 },

          { year: '1998', value: 9 },

          { year: '1999', value: 11 },

        ],

      },

    }

  },

}

```

## DEMO

- Vue 3

  - [github](https://github.com/open-data-plan/g2plot-vue-demo)

  - [online](http://g2plot-vue-demo-opd.vercel.app/)

- Vue 2

  - [github](https://github.com/open-data-plan/g2plot-vue2-demo)

  - [online](http://g2plot-vue2-demo-opd.vercel.app/)

## API

All config defined in `G2Plot` [document](https://g2plot.antv.vision/zh/docs/manual/introduction) can be used as `props` or `attrs`

Notable API in `g2plot-vue`

- `chartRef`: `ref` of rendered `plot`, available after `plot` mounted, **NOT** component mounted

- `onReady`: `callback` after `plot` mounted, **NOT** component mounted

## FYI

- [Throw error: `Failed to mount component: template or render function not defined.` in `vue@2`](https://github.com/open-data-plan/g2plot-vue/issues/483)

  please ensure `composition-api` has been enabled.

- [Build failed with `vite`](https://github.com/open-data-plan/g2plot-vue/issues/505)

  `g2plot-vue` use `babel` to build output files, and transform `@babel/runtime` with dependencies, so `@babel/runtime` is required.

## Develop

```

npm install

npm run build

```

## License

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fopen-data-plan%2Fg2plot-vue.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fopen-data-plan%2Fg2plot-vue?ref=badge_large)