Skip to content

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

html
<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

html
<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

html
<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:

sh
$ npm install nicetix
JS
import nicetix from "nicetix";
// nicetix(min, max, <num = 5>)

let ticks = nicetix(-1.23, 12.3, 5);
// -> [-5, 0, 5, 10, 15]