yonder (version 0.1.0)

popover: Display a popover

Description

Popovers are small windows of content associated with a tag element. Use popover() to construct the element and showPopover() to add it to any tag element with an HTML id. Popovers are great for explaining inputs and giving hints to the users. Popovers are hidden with closePopover().

Usage

popover(..., title = NULL)
showPopover(target, popover, placement = "top", duration = NULL,
  session = getDefaultReactiveDomain())
closePopover(id, session = getDefaultReactiveDomain())

Arguments

...

Character strings or tag elements specifying the content of the popover or additional named arguments passed as HTML attributes to the parent element.

title

A character string specifying a title for the popover, defaults to NULL, in which case a title is not added.

target

A character string specifying the id of the element where the popover is shown.

popover

The popover element to show, typically a call to popover().

placement

One of "top", "left", "bottom", or "right" specifying where the popover is positioned relative to the target tag element indicated by id.

duration

A positive integer specifying the duration of the popover in seconds or NULL, in which case the popover is not automatically removed. When NULL is specified the popover can be removed with closePopover().

session

A reactive context, defaults to getDefaultReactiveDomain().

id

A character string specifying the HTML id of a popover's target tag element.

Example application

ui <- container(
  buttonInput("showHelp", "Help!"),
  div(
    id = "textBlock1",
    "Sociis natoque penatibus et magnis"
  ) %>%
    padding(3)
) %>%
  display("flex") %>%
  flex(justify = "around")
server <- function(input, output) {
  observeEvent(input$showHelp, ignoreInit = TRUE, {
    showPopover(
      target = "textBlock1",
      popover(title = "Hint", "I am a <div> element!"),
      placement = "bottom",
      duration = 4
    )
  })
}
shinyApp(ui, server)

See Also

Other content: alert, badge, blockquote, card, collapsiblePane, d1, dropdown, img, jumbotron, modal, navContent, pre, progressOutlet, toast, tooltip

Examples

# NOT RUN {
### Examples

# Please see example application above.

# }