Labels
The labels
attribute adds labels to the scalebar. The default values for labels
range from 0 to 1, but you will probably want to use specific numbers or string values.
By default, labels are spaced evenly over the entire range of the scalebar. If the classes
or ticks
attributes provide custom positions and their numbers match, those will be used.
No value
The labels
attribute without a value adds 0 and 1 as labels for the minimum and maximum values.
Code
<dv-scalebar colors="gold,teal" labels></dv-scalebar>
Result
Single value
A single value for the labels
attribute sets the label at the maximum of the scalebar.
Code
<dv-scalebar colors="gold,teal" labels="100"></dv-scalebar>
<dv-scalebar colors="gold,teal" labels="max"></dv-scalebar>
Result
Multiple values
Multiple values for the labels
attribute are spaced evenly, as long as no position information is provided by the classes
or ticks
attributes.
Code
<dv-scalebar colors="gold,teal" labels="min,max"></dv-scalebar>
<dv-scalebar colors="gold,teal" labels="0,1,2"></dv-scalebar>
<dv-scalebar colors="gold,teal" labels="zero,1,2,3"></dv-scalebar>
Result
[ nicetix ]
In real-world scenarios, you may encounter odd numbers for your minimum and maximum, making it challenging to find appealing labels in between.
The nicetix function can help you with that task:
$ npm install nicetix
import nicetix from "nicetix";
// nicetix(min, max, <num = 5>)
let ticks = nicetix(-1.23, 12.3, 5);
// -> [-5, 0, 5, 10, 15]