embed_video: Embed video in R Markdown documents

In adamleejohnson/R-ajtools: AJ's R Tools

Embed video in R Markdown documents

Description

embed_video() provides a standard way to embed video in R Markdown documents when the output format is HTML, and to print placeholder text when the output format is not HTML.

Usage

embed_video(
  src,
  type = c("mp4", "webm", "ogg"),
  width = "320",
  height = "240",
  attribute = c("controls", "autoplay", "loop", "muted", "preload", "none"),
  thumbnail = NULL,
  id = "",
  placeholder = ""
)

Arguments

src	A path to the media file.
type	The type of media file specified in src.
width	The width of the video, in pixels.
height	The height of the video, in pixels.
attribute	A character vector specifying which attributes to use. "none" can be used if no attributes are desired.
thumbnail	A path to an image.
id	A character string specifying a unique ID for the element. Can be used by CSS or JavaScript to perform certain tasks for the element with the specific ID.
placeholder	The placeholder text to use when the output format is not HTML.

Details

embed_video() is a wrapper for the HTML5 <video> element that prints HTML <video> code in HTML documents built by R Markdown and placeholder text in non-HTML documents built by R Markdown. This function may be useful for conditional output that depends on the output format. For example, you may embed video in an R Markdown document when the output format is HTML, and print placeholder text when the output format is LaTeX.

The function determines output format using knitr::is_html_output(). By default, these formats are considered as HTML formats: c('markdown', 'epub', 'html', 'html5', 'revealjs', 's5', 'slideous', 'slidy').

Value

If knitr::is_html_output() is TRUE, returns HTML <video> code. If knitr::is_html_output() is FALSE, returns placeholder text.

Note

This function is supposed to be used in R code chunks or inline R code expressions. You are recommended to use forward slashes (/) as path separators instead of backslashes in the file paths.

adamleejohnson/R-ajtools documentation built on April 4, 2022, 7:24 a.m.