ec.clmn {echarty}R Documentation

Data column


Helper function to display/format data column(s) by index or name


ec.clmn(col = NULL, ..., scale = 1)



A single column index(number) or column name(quoted string),
or a sprintf format string.


A comma separated column indexes or names, only when col is sprintf. This allows formatting of multiple columns, as for a tooltip.


A positive number, multiplier for numeric columns. When scale is 0, all numeric values are rounded.


Column indexes are counted in R and start at 1.
Set column index to -1 for single values, like tree chart, axisLabel.formatter or valueFormatter.
Column indexes are decimals for combo charts with multiple series, see example. The whole number part is the serie index, the decimal part is the column index inside. col as sprintf has the same placeholder %@ for both column indexes or column names.
col as sprintf can contain double quotes, but not single or backquotes.
Placeholder %L@ will display a number in locale format, like '12,345.09'.
Placeholder %LR@ will display a rounded number in locale format, like '12,345'.
Placeholder %R@ will display a rounded number, like '12345'.
Placeholder %M@ will display a marker in serie's color.
Useful for attributes like formatter, color, symbolSize.


A JavaScript code string (usually a function) marked as executable, see JS.


tmp <- data.frame(Species = as.vector(unique(iris$Species)),
                  emoji = c('\U0001F33B','\U0001F335','\U0001F33A'))
df <- iris |> dplyr::inner_join(tmp)         # add 6th column emoji
p <- df |> dplyr::group_by(Species) |> ec.init()
p$x$opts$series <- lapply(p$x$opts$series,   # show 6th column as label
   function(s) append(s, list(label= list(show= TRUE, formatter= ec.clmn(6)))) )
p$x$opts$tooltip <- list(formatter=     # sprintf + multiple column indexes
   ec.clmn('%M@ species <b>%@</b><br>s.len <b>%@</b><br>s.wid <b>%@</b>', 5,1,2))

[Package echarty version 1.4.5 Index]