Create interactive histogram visualizations with 'data-ui'. The histogram will
perform the calculations in 'JavaScript' if the data is raw. If you would like
more control over the calculation, then you can pass pre-binned values
with help from hist_to_binned_data. dui_histogram works well
as a full-featured visualization or can also be used as a 'sparkline` in smaller
contexts.
dui_histogram(
rawData = NULL,
binCount = NULL,
binType = NULL,
binValues = NULL,
cumulative = NULL,
horizontal = NULL,
limits = NULL,
margin = NULL,
normalized = NULL,
renderTooltip = NULL,
valueAccessor = NULL,
onMouseMove = NULL,
onMouseLeave = NULL,
tooltipData = NULL,
ariaLabel = NULL,
components = NULL,
width = 600,
height = 400,
elementId = NULL
)
Arguments
| binCount |
numeric specifying the approximate number of bins to calculate.
|
| binType |
character one of 'numeric'(default) or 'categorical'.
|
| binValues |
numeric vector of the bin or break values to override the
automatic calculations.
|
| cumulative |
logical to specify whether or not the histogram will display
cumulative sums of the counts.
|
| horizontal |
logical with TRUE meaning the chart will be in
horizontal layout.
|
| limits |
numeric vector of length two to give a range for which values
will be ignored if they are outside of the range.
|
| margin |
list of the form list(top =, right =, bottom =, left=)
that will specify the margins for the 'sparkline' chart.
|
| normalized |
logical specifying whether or not to the values will be
calculated as a percent of total.
|
| renderTooltip |
htmlwidget::JS function that will provide the 'React' element
to render when a user moves their mouse over the visualization. The function
should follow the signature ({ event, data, datum, color }) =>. If the
function returns a falsy value then nothing will be rendered.
|
| valueAccessor |
htmlwidgets::JS function to let the chart know where to
look for the y value in the data. An example would look like
(d) => d.yval where yval is the property containing the value.
|
| onMouseMove, onMouseLeave |
htmlwidgets::JS function to run on mouse events.
|
| tooltipData |
currently not supported. |
| ariaLabel |
character accessibility label for the chart
|
| components |
list of children (series or reference lines) to include
in the histogram. Multiple components should be wrapped in list such as
components = list(dui_densityseries, dui_barseries()).
|
| width, height |
numeric valid 'css' size unit. For height, this should
always be numeric, but width might be something like '100%'
or '50vw'.
|
| elementId |
character valid 'css' identifier for the htmlwidget
container.
|
Value
react htmlwidget