Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/juliuste/parliament-svg
Generate parliament charts as virtual-dom SVG
https://github.com/juliuste/parliament-svg
election hacktoberfest library
Last synced: about 1 month ago
JSON representation
Generate parliament charts as virtual-dom SVG
- Host: GitHub
- URL: https://github.com/juliuste/parliament-svg
- Owner: juliuste
- License: isc
- Created: 2016-11-19T12:29:06.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2021-10-05T09:29:34.000Z (about 3 years ago)
- Last Synced: 2024-05-02T06:16:27.628Z (8 months ago)
- Topics: election, hacktoberfest, library
- Language: JavaScript
- Homepage: https://juliuste.github.io/parliament-svg/
- Size: 228 KB
- Stars: 185
- Watchers: 8
- Forks: 16
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# parliament-svg
Generate parliament charts as **[_hast_](https://github.com/syntax-tree/hast) virtual DOM SVG\***. Design inspired by the [Wikipedia parliament charts](https://github.com/slashme/parliamentdiagram). *Play around with the [__live demo__](https://juliuste.github.io/parliament-svg/)!* For westminster-style parliament charts, see [westminster-svg](https://github.com/juliuste/westminster-svg). If you are using [D3](https://github.com/d3/d3/), you might prefer working with the [d3-parliament](https://github.com/geoffreybr/d3-parliament) module.
\*Also compatible with other virtual DOM implementations, see the [docs below](#Usage).
[](https://www.npmjs.com/package/parliament-svg)
[](license)
[](mailto:[email protected])
## Installation
**This package is [ESM only](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c): Node 12+ is needed to use it and it must be `import`ed instead of `require`d.**
```shell
npm install --save parliament-svg
```
## Usage
```js
import parliamentSVG from 'parliament-svg'
const virtualSvg = parliamentSVG(parties, [opt])
```
- **`opt`** can contain the following options:
- **`seatCount`** is a boolean, if `true` the total seat count will be displayed in the chart. Defaults to `false`.
- **`hFunction`** is a function that will be used to generate the element tree. Defaults to [`hastscript`](https://github.com/syntax-tree/hastscript/)'s `s()` function, custom values need to match that function's signature. You could use [`virtual-hyperscript-svg`](https://github.com/substack/virtual-hyperscript-svg)'s `h()` function here if you prefer working with [`virtual-dom`](https://github.com/Matt-Esch/virtual-dom), for example.
- **`parties`** is an object containing seat count and colour for each party, e.g.:
```json
{
"linke": {
"seats": 64,
"colour": "#a08"
},
"spd": {
"seats": 193,
"colour": "#e02"
},
"gruene": {
"seats": 63,
"colour": "#0b2"
},
"union": {
"seats": 311,
"colour": "#333"
}
}
```
Each seat contains the party name in its `class` attribute.
For the given `parties` object and `seatCount` enabled, the rendered result should look as follows:
If you want to convert the [_hast_](https://github.com/syntax-tree/hast) tree to an SVG string, use `hast-util-to-html` (don't get confused by the name, the library can also stringify SVG):
```js
import parliamentSVG from 'parliament-svg'
import { toHtml as toSvg } from 'hast-util-to-html'
const virtualSvg = parliamentSVG(parties, seatCount)
const svg = toSvg(virtualSvg)
```
Check the [`code example`](example/example.js) as well.
### What if I prefer virtual-dom (or anything else)?
If you prefer [`virtual-dom`](https://github.com/Matt-Esch/virtual-dom) over `hast`, e.g. for diffing or patching, you can either:
- use [`hast-to-hyperscript`](https://github.com/syntax-tree/hast-to-hyperscript) to transform the tree after it was generated _or_
- use the [`hFunction`](#Usage) parameter documented above with a virtual-dom `h()` function of your choice
## See also
- [westminster-svg](https://github.com/juliuste/westminster-svg) - "westminster-style parliament charts"
- [d3-parliament](https://github.com/geoffreybr/d3-parliament) - "parliament charts for [D3](https://github.com/d3/d3/)"
- [wikidata-parliament-svg](https://github.com/k-nut/wikidata-parliament-svg) - "draws parliament graphs based on data from wikidata"
## Contributing
If you found a bug or want to propose a feature, feel free to visit [the issues page](https://github.com/juliuste/parliament-svg/issues).