ui.input_radio_buttons

ui.input_radio_buttons(
    id,
    label,
    choices,
    *,
    selected=None,
    inline=False,
    width=None,
)

Create a set of radio buttons used to select an item from a list.

Parameters

id : str

An input id.

label : TagChild

An input label.

choices : ChoicesArg

Either a list of choices or a dictionary mapping choice values to labels. Note that if a dictionary is provided, the keys are used as the (input) values so that the dictionary values can hold HTML labels.

selected : Optional[str] = None

The values that should be initially selected, if any.

inline : bool = False

If True, the result is displayed inline.

width : Optional[str] = None

The CSS width, e.g. ‘400px’, or ‘100%’.

Returns

: Tag

A UI element

Notes

Server value

A string with the selected value.

See Also

• update_radio_buttons
• input_checkbox_group
• input_checkbox

Examples

#| standalone: true
#| components: [editor, viewer]
#| layout: vertical
#| viewerHeight: 400

## file: app.py
from shiny import App, Inputs, Outputs, Session, render, ui

app_ui = ui.page_fluid(
    ui.input_radio_buttons(
        "rb",
        "Choose one:",
        {
            "html": ui.HTML("<span style='color:red;'>Red Text</span>"),
            "text": "Normal text",
        },
    ),
    ui.output_ui("val"),
)


def server(input: Inputs, output: Outputs, session: Session):
    @render.ui
    def val():
        return "You chose " + input.rb()


app = App(app_ui, server)