wa_select: Create a 'wa-select' component

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

Create a wa-select component

Description

Generated wrapper for the Web Awesome wa-select component. When used as a Shiny input, ⁠input$<input_id>⁠ reflects the component's current value value. The Shiny value is returned as a character string for single-select usage, or a character vector when multiple is TRUE. Generated from Web Awesome metadata.

Generated update helper for the Web Awesome wa-select component.

Usage

wa_select(
  input_id,
  ...,
  class = NULL,
  style = NULL,
  value = NULL,
  disabled = NULL,
  label = NULL,
  hint = NULL,
  name = NULL,
  appearance = NULL,
  custom_error = NULL,
  dir = NULL,
  lang = NULL,
  max_options_visible = NULL,
  multiple = NULL,
  open = NULL,
  pill = NULL,
  placeholder = NULL,
  placement = NULL,
  required = NULL,
  size = NULL,
  with_clear = NULL,
  with_hint = NULL,
  with_label = NULL,
  clear_icon = NULL,
  end = NULL,
  expand_icon = NULL,
  hint_slot = NULL,
  label_slot = NULL,
  start = NULL
)

update_wa_select(
  session,
  input_id,
  value = NULL,
  label = NULL,
  hint = NULL,
  disabled = NULL
)

Arguments

input_id	Input id of the component to update.
...	Child content for the component's default slot.
class	Optional CSS class string.
style	Optional inline CSS style string.
value	Optional value to send to the component.
disabled	Optional logical disabled state to send to the component.
label	Optional label text to send to the component.
hint	Optional hint text to send to the component.
name	String. Default: "". The name of the select, submitted as a name/value pair with form data.
appearance	Enumerated string. Allowed values: filled, filled-outlined, outlined. Default: outlined. The select's visual appearance.
custom_error	String. Default: null. Optional Web Awesome attribute.
dir	String. Optional Web Awesome attribute.
lang	String. Optional Web Awesome attribute.
max_options_visible	Number. Default: 3. The maximum number of selected options to show when multiple is TRUE. After the maximum, "+n" will be shown to indicate the number of additional items that are selected. Set to 0 to remove the limit.
multiple	Boolean. Default: FALSE. Allows more than one option to be selected.
open	Boolean. Default: FALSE. Indicates whether or not the select is open. You can toggle this attribute to show and hide the menu, or you can use the show() and hide() methods and this attribute will reflect the select's open state.
pill	Boolean. Default: FALSE. Draws a pill-style select with rounded edges.
placeholder	String. Default: "". Placeholder text to show as a hint when the select is empty.
placement	Enumerated string. Allowed values: bottom, top. Default: bottom. The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox inside of the viewport.
required	Boolean. Default: FALSE. The select's required attribute.
size	Enumerated string. Allowed values: large, medium, small. Default: medium. The select's size.
with_clear	Boolean. Default: FALSE. Adds a clear button when the select is not empty.
with_hint	Boolean. Default: FALSE. Only required for SSR. Set to TRUE if you're slotting in a hint element so the server-rendered markup includes the hint before the component hydrates on the client.
with_label	Boolean. Default: FALSE. Only required for SSR. Set to TRUE if you're slotting in a label element so the server-rendered markup includes the label before the component hydrates on the client.
clear_icon	An icon to use in lieu of the default clear icon.
end	An element, such as ⁠<wa-icon>⁠, placed at the end of the combobox.
expand_icon	The icon to show when the control is expanded and collapsed. Rotates on open and close.
hint_slot	Text that describes how to use the input. Alternatively, you can use the hint attribute.
label_slot	The input's label. Alternatively, you can use the label attribute.
start	An element, such as ⁠<wa-icon>⁠, placed at the start of the combobox.
session	Shiny session object.

Value

An HTML tag for the component.

Invisibly returns NULL.

Shiny Bindings

⁠input$<input_id>⁠ reflects the component's current value value. The Shiny value is returned as a character string for single-select usage, or a character vector when multiple is TRUE.

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