hexachart
v0.9.0
Published
Hexagon based data-viz ## Quick Run ```html <html> </head> <script src="https://unpkg.com/vue"></script> <script src="https://cdn.jsdelivr.net/npm/hexachart/dist/HexaChart.umd.min.js"></script> </head> <body> <div id="app" class="container"> <hexa-s
Downloads
4
Readme
hexachart
Hexagon based data-viz
Quick Run
<html>
</head>
<script src="https://unpkg.com/vue"></script>
<script src="https://cdn.jsdelivr.net/npm/hexachart/dist/HexaChart.umd.min.js"></script>
</head>
<body>
<div id="app" class="container">
<hexa-stack-chart :data="hsData" :texts="hsTexts" :colors="hsColors"/>
</div>
<script>
// Comment the following line and uncomment the bellow line to use as plugin
Object.keys(HexaChart).forEach(name => {
Vue.component(name, HexaChart[name])
})
// Uncomment to use as a plugin
// const plugin = {
// install: Vue => {
// Object.keys(HexaChart).forEach(name => {
// Vue.component(name, HexaChart[name])
// })
// }
// }
// Vue.use(plugin)
const hsData = [52.5, 26.3, 21.2]
const hsColors = ['#666666', '#999999', '#cccccc']
const hsTexts = ['Alpha', 'Beta', 'Gamma']
const vm = new Vue({
data() {
return {
hsData,
hscolors,
hsTexts
}
},
}).$mount('#app')
</script>
</body>
</html>In a Vue Project
npm i hexachart...
</template>
<script>
import * as HexaChat from 'HexaChart'
export default {
name: 'Demo',
components: {
HexaChat.HexaStackChart,
...
},
...Components
HexaStack
Minimal Example
<template>
<div>
<hexa-stack-chart
data="data"
:colors="colors"
:texts="texts"
/>
</div>
</template>
<script>
import { HexaStackChart } from 'HexaChart'
export default {
name: 'Demo',
components: {
HexaStackChart
},
data () {
return {
data: [52.5, 26.3, 21.2],
colors: ['#666666', '#999999', '#cccccc'],
texts: ['Alpha', 'Beta', 'Gamma']
}
}
}
</script>
<style>
/** Fluid & Fixed responsive **/
.hc-hexastack {
width: 170px;
height: 530px;
}
</style>Props
| prop | type | default | description |
|------|------|---------|-------------|
| data | Array | [] | The main data, array of floats, e.g. [3.5, 4, 16]. The size precede the data sum in priority, that means if size is greater than the data sum, the remaining cells will be filled by offColor, while if it is lesser it will be truncated |
| colors | Array | ['#f67055'] | Colors to be used (reserve order with data) |
| texts | Array | [] |Array of strings that will be used as legend (reserve order with data) |
| offColor | String | '#757575' | default color for any inactive cell (hexagon) |
| size | Number | 100 | The Total number of cells |
| columns | Number | 5 | The number of columns |
| rows | Number | 20 | The number of rows |
| horizontal | Boolean | false | Either or not the hexastack is horizontal, default is vertical |
| animation | Boolean | true | Either or not use animation, if false no animation will play |
| animationDuration | Number | 3000 | Animation duration time in milliseconds, do not set to 0, use animation false instead |
| animationOptions | Object |{delay: 0, easing: 'Bounce', easingEdge: 'Out'} | Object of tweenjs like animation |
| gradientSpread | Number | .5 | How much the gradient will spread, 0 for sharp separation|
HexaPie
Minimal Example
<template>
<div>
<hexa-pie-chart
:data="data"
:texts="texts"
/>
</div>
</template>
<script>
import HexaPieChart from 'HexaChart'
export default {
name: 'Demo',
components: {
HexaPieChart
},
data () {
return {
data: [32, 18],
texts: ['Alpha', 'Beta']
}
}
}
</script>
<style>
.hc-hexapie {
width: 316px;
height: 234px;
}
.hc-hexapie-text {
fill: #ffffff;
font-size: 20px;
}
.hc-hexapie-legend {
font-size: 20px;
fill: #999999;
}
</style>Props
| prop | type | default | description |
|------|------|---------|-------------|
| data | Array | [] | The main data, array of floats, e.g. [3.5, 4, 16]. This data are represented as percentage on the pie chart |
| colors | Array | ['#666666', '#f56042'] | Colors to be used (reserve order with data) |
| texts | Array | Array of strings that will be used as legend (reserve order with data) |
| radius | Number | 116 | Radius of the pie |
| curve | Number | 0.8 | A float between 0..1 that indicate how rounded are the hexagon conrners, 0 would make it a circle and 1 a hexagon |
| animation | Boolean | true | Either or not use animation, if false no animation will play |
| animationDuration | Number | 3000 | Animation duration time in milliseconds, do not set to 0, use animation false instead |
| animationOptions | Object |{delay: 0, easing: 'Bounce', easingEdge: 'Out'} | Object of tweenjs like animation |
HexaInception
Minimal Example
<template>
<div>
<hexa-inception-chart
:data="data"
:texts="texts"
:unit="unit"
/>
</div>
</template>
<script>
import HexaInceptionChart from 'HexaStack'
export default {
name: 'Demo',
components: {
HexaInceptionChart
},
data () {
return {
data: [107228, 76561],
texts: ['Alpha', 'Beta'],
unit: 'M'
}
}
}
</script>
<style>
.hc-hexainception {
width: 500px;
height: 500px;
}
</style>Props
| prop | type | default | description |
|------|------|---------|-------------|
| data | Array | [] | The main data, Ordered array of floats, e.g. [16, 5, 2] |
| colors | Array | ['#666666', '#f56042'] | Colors to be used (reserve order with data) |
| texts | Array | Array of strings that will be used as legend (reserve order with data) |
| unit | String | '' | Unit used in the legend, if left empty it will be ommited |
| curve | Number | 0.8 | A float between 0..1 that indicate how rounded are the hexagon conrners, 0 would make it a circle and 1 a hexagon |
| animation | Boolean | true | Either or not use animation, if false no animation will play |
| animationDuration | Number | 3000 | Animation duration time in milliseconds, do not set to 0, use animation false instead |
| animationOptions | Object |{delay: 0, easing: 'Bounce', easingEdge: 'Out'} | Object of tweenjs like animation |
HexaBubule
Minimal Example
<template>
<div>
<hexa-buble-chart
:data="data"
/>
</div>
</template>
<script>
import HexaBubleChart from 'HexaStack'
export default {
name: 'Demo',
components: {
HexaBubleChart
},
data () {
return {
data: [
{d: 30222 name: 'GrandPa1', id: 1, children: [
{d: 5600, name: 'Pa1_1', id: 11, children: [
{d: 130932 name: 'Kid1_1_1', id: 111},
{d: 89921 name: 'Kid1_1_2', id: 112},
...
]},
{d: 66554, name: 'Pa1_2', id: 12, children: [
...
]},
...
]},
...
]
}
}
}
</script>
<style>
.hc-hexabuble {
width: 100%;
height: 500px;
}
.hc-hexabuble-chart {
border: #000 solid 1px;
}
.hc-hexabuble-legend {
font-size: 16px;
fill: #999999;
}
</style>Props
| prop | type | default | description |
|------|------|---------|-------------|
| data | Array | [] | The main data, One way bound Tree with leafs being on the format {d: 89921 name: 'name to be displayed', id: 1} and parent having an additional children attribute, which is an array of other nodes|
| colors* | undefined | undefined | not yet implemented |
| unit | String | '' | Unit used in the legend, if left empty it will be ommited |
| curve* | undefined | undefined | not yet implemented |
| animation | Boolean | true | Either or not use animation, if false no animation will play |
| animationDuration | Number | 3000 | Animation duration time in milliseconds, do not set to 0, use animation false instead |
| animationOptions | Object |{delay: 0, easing: 'Bounce', easingEdge: 'Out'} | Object of tweenjs like animation |