vd_chooser

Static HTML app to choose a voting district

Usage no npm install needed!

<script type="module">
  import vdChooser from 'https://cdn.skypack.dev/vd_chooser';
</script>

README

How it Works

Anyone (any app) can use the VD chooser: One has to redirect the browser to the VD chooser with a parameter specifying where to redirect back to, after a VD has been chosen.

How to Use

Encode the place in your app you want to be redirected to in a parameter redirect_uri, then redirect to the VD chooser. In redirect_uri parameters can be used, which will be replaced by the VD chooser with information about the chosen VD:

  • vd_name: The name of the voting district.
  • vd_code: The identifier of the voting district, which can be used to look up more details of the voting district via the Structures API.

Examples:

https://choose-vd.da.org.za/choose?redirect_uri=http%3A%2F%2Fgoogle.com%2Fsearch%3Fq%3Dvd_name
http://localhost:8080/choose?redirect_uri=http%3A%2F%2Fgoogle.com%2Fsearch%3Fq%3Dvd_name