View local web content within RStudio. Content can be served from static files in the R session temporary directory, or via a web application running on localhost.
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
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
## 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) # use 'viewer' option if set, or `utils::browseURL()` if unset viewer <- getOption("viewer", default = utils::browseURL) viewer("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.