renderWordcloud {ECharts2Shiny} | R Documentation |
Render the Word Cloud Plotted by ECharts into Shiny Application
Description
renderWordcloud() function helps render the word cloud charts into Shiny applications.
Usage
renderWordcloud(div_id, data,
shape = 'circle',
grid_size = 5, sizeRange = c(15, 50),
rotationRange = c(-45, 45),
hyperlinks = NULL,
running_in_shiny = TRUE)
Arguments
div_id |
The division id users specified for this chart. The division will be specified in ui.R. |
data |
The data used for the plotting. It should be either a vector or a data.frame. If it's a vector, it should be made up of all the elements you want to count and plot, like c("a", "a", "b", "a", "b", "c"). If it's a data.frame, the data must be made up of only two columns, "name" and "value". The "value" column must be numeric or integer. |
shape |
The shape of the word cloud. The valid values include "circle" (default value), "cardioid", "diamond", "triangle-forward", "triangle", "pentagon" and "star". |
grid_size |
The size of the grid in word cloud. |
sizeRange |
The font size range in the word cloud. It should be a vector of length two. The default value is c(15, 50). |
rotationRange |
The rotation angle range in the word cloud. It should be a vector of length two. The default value is c(-45, 45). |
hyperlinks |
Vector. Users can link each element in the chart to a hyperlink (URL like http://***.com). Please note this is only supported when the data is in data.frame format, and the length of the "hyperlinks" vector should be the same to the number of rows in the data given. Note that if hyperlinks are available, the fonts in the pop-up window will be in skyblue color and italic style. |
running_in_shiny |
If we're actually running this in a Shiny library, or we're simply doing testing. Default valus is "TRUE". If "FALSE", the function will print what it's supposed to evaluate. |
Note
Users need to state the division for the chart first, with tags$div() function of Shiny packages. Please note that the division id must keep unique (duplicated division id will cause error).
Author(s)
Xiaodong DENG
(ECharts library is authored by Baidu team)
References
https://github.com/ecomfe/echarts-wordcloud
Examples
if (interactive()) {
library(shiny)
library(ECharts2Shiny)
sample_data_for_wordcloud <- c(rep("R", 100),
rep("Python", 100),
rep("SAS", 90),
rep("VBA", 50))
# Server function -------------------------------------------
server <- function(input, output) {
renderWordcloud("test", data =sample_data_for_wordcloud,
grid_size = 10, sizeRange = c(20, 50))
}
# UI layout -------------------------------------------------
ui <- fluidPage(
# We MUST load the ECharts javascript library in advance
loadEChartsLibrary(),
tags$div(id="test", style="width:100%;height:500px;"),
deliverChart(div_id = "test")
)
# Run the application --------------------------------------
shinyApp(ui = ui, server = server)
}