View local web content within RStudio. Content can be served from static files in the R session temporary directory or can be a Shiny, Rook, OpenCPU, or any other type of localhost web application.
Application URL. This can be either a localhost URL or a path to a file within the R session temporary directory (i.e. a path returned by
Desired height. Specifies a desired height for the Viewer pane (the default is
RStudio also sets the global
viewer option to the
rstudioapi::viewer function so that it can be invoked in a front-end independent manner.
Applications are displayed within the Viewer pane. The application URL must either be served from localhost or be a path to a file within the R session temporary directory. If the URL doesn't conform to these requirements it is displayed within a standard browser window.
height parameter specifies a desired height, however it's possible the Viewer pane will end up smaller if the request can't be fulfilled (RStudio ensures that the pane paired with the Viewer maintains a minimum height). A height of 400 pixels or lower is likely to succeed in a large proportion of configurations.
A very large height (e.g. 2000 pixels) will allocate the maximum allowable space for the Viewer (while still preserving some view of the pane above or below it). The value
"maximize" will force the Viewer to full height. Note that this value should only be specified in cases where maximum vertical space is essential, as it will result in one of the user's other panes being hidden.
When a page is displayed within the Viewer it's possible that the user will choose to pop it out into a standalone browser window. When rendering inside a standard browser you may want to make different choices about how content is laid out or scaled. Web pages can detect that they are running inside the Viewer pane by looking for the
viewer_pane query parameter, which is automatically injected into URLs when they are shown in the Viewer. For example, the following URL:
When rendered in the Viewer pane is transformed to:
viewer function was added in version 0.98.423 of RStudio. The ability to specify
maximize for the
height parameter was introduced in version 0.99.1001 of RStudio.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
## Not run: # run an application inside the IDE rstudioapi::viewer("http://localhost:8100") # run an application and request a height of 500 pixels rstudioapi::viewer("http://localhost:8100", height = 500) # probe for viewer option then fall back to browseURL viewer <- getOption("viewer") if (!is.null(viewer)) viewer("http://localhost:8100") else utils::browseURL("http://localhost:8100") # generate a temporary html file and display it dir <- tempfile() dir.create(dir) htmlFile <- file.path(dir, "index.html") # (code to write some content to the file) rstudioapi::viewer(htmlFile) ## End(Not run)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.