wa_dropdown: Create a 'wa-dropdown' component

In shiny.webawesome: 'shiny' Bindings for 'Web Awesome' Components

Create a wa-dropdown component

Description

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.

shiny.webawesome documentation built on April 22, 2026, 1:09 a.m.