Switch: Switch

In muiMaterial: 'Material UI' for 'shiny' Apps and 'Quarto'

Switch

Description

https://mui.com/material-ui/api/switch/

Usage

Switch(...)

Switch.shinyInput(inputId, ..., value = defaultValue)

updateSwitch.shinyInput(
  session = shiny::getDefaultReactiveDomain(),
  inputId,
  ...
)

Arguments

...	Props to pass to the component.
inputId	ID of the component.
value	Starting value.
session	Object passed as the 'session' argument to Shiny server.

Details

• checked bool
  Default is - If true, the component is checked.

• checkedIcon node
  Default is - The icon to display when the component is checked.

• classes object
  Default is - Override or extend the styles applied to the component.See CSS classes API below for more details.

• color 'default'| 'primary'| 'secondary'| 'error'| 'info'| 'success'| 'warning'| string
  Default is 'primary' The color of the component. It supports both default and custom theme colors, which can be added as shown in the palette customization guide.

• defaultChecked bool
  Default is - The default checked state. Use when the component is not controlled.

• disabled bool
  Default is - If true, the component is disabled.

• disableRipple bool
  Default is FALSE If true, the ripple effect is disabled.

• edge 'end'| 'start'| false
  Default is FALSE If given, uses a negative margin to counteract the padding on one side (this is often helpful for aligning the left or right side of the icon with content above or below, without ruining the border size and shape).

• icon node
  Default is - The icon to display when the component is unchecked.

• id string
  Default is - The id of the input element.

• inputProps object
  Default is - Attributes applied to the input element.Deprecated Use slotProps.input instead. This prop will be removed in a future major release. See Migrating from deprecated APIs for more details.

• inputRef ref
  Default is - Pass a ref to the input element.Deprecated Use slotProps.input.ref instead. This prop will be removed in a future major release. See Migrating from deprecated APIs for more details.

• onChange func
  Default is - Callback fired when the state is changed.Signature:function(event: React.ChangeEvent) = voidevent The event source of the callback. You can pull out the new value by accessing event.target.value (string). You can pull out the new checked state by accessing event.target.checked (boolean).

• required bool
  Default is FALSE If true, the input element is required.

• size 'medium'| 'small'| string
  Default is 'medium' The size of the component. small is equivalent to the dense switch styling.

• slotProps ⁠{ input?: func| object, root?: func| object, switchBase?: func| object, thumb?: func| object, track?: func| object }⁠
  Default is The props used for each slot inside.

• slots ⁠{ input?: elementType, root?: elementType, switchBase?: elementType, thumb?: elementType, track?: elementType }⁠
  Default is The components used for each slot inside.

• sx ⁠Array func| object| bool | func| object⁠
  Default is - The system prop that allows defining system overrides as well as additional CSS styles.See the sx page for more details.

• value any
  Default is - The value of the component. The DOM API casts this to a string. The browser uses "on" as the default value.

Value

Object with shiny.tag class suitable for use in the UI of a Shiny app.

muiMaterial documentation built on Jan. 26, 2026, 5:07 p.m.