Skip to contents

Generated wrapper for the Web Awesome wa-dropdown component. When used as a Shiny input, action semantics are exposed through input$<input_id> and the latest selected dropdown item value is exposed through input$<input_id>_value. The action input increments on every selection, including repeated selection of the same item. The companion value input reflects the selected item's value, returns NULL when the selected item has no value, and preserves an explicit empty string "" when that is the selected item's value. Each committed action publishes a numeric action value. Generated from Web Awesome metadata.

Usage

wa_dropdown(
  input_id,
  ...,
  class = NULL,
  style = NULL,
  dir = NULL,
  distance = NULL,
  lang = NULL,
  open = NULL,
  placement = NULL,
  size = NULL,
  skidding = NULL,
  trigger = NULL
)

Arguments

input_id

Shiny input id for the component. This is also used as the rendered DOM id attribute.

...

Child content for the component's default slot.

class

Optional CSS class string.

style

Optional inline CSS style string.

dir

String. Optional Web Awesome attribute.

distance

Number. Default: 0. The distance of the dropdown menu from its trigger.

lang

String. Optional Web Awesome attribute.

open

Boolean. Default: FALSE. Opens or closes the dropdown.

placement

Enumerated string. Allowed values: bottom, bottom-end, bottom-start, left, left-end, left-start, right, right-end, right-start, top, top-end, top-start. Default: bottom-start. The placement of the dropdown menu in reference to the trigger. The menu will shift to a more optimal location if the preferred placement doesn't have enough room.

size

Enumerated string. Allowed values: large, medium, small. Default: medium. The dropdown's size.

skidding

Number. Default: 0. The offset of the dropdown menu along its trigger.

trigger

The element that triggers the dropdown, such as a <wa-button> or <button>.

Value

An HTML tag for the component.

Shiny Bindings

input$<input_id> uses action semantics and invalidates on each committed action, including repeated selection of the same item. The Shiny action value is returned as a numeric action value.

input$<input_id>_value reflects the latest selected item's value value, returns NULL when the selected item has no value , and preserves an explicit empty string "" when that is the selected item's value. The payload value is returned as a character string or NULL.