st-segmented-buttons

A customizable segmented button component for Streamlit applications. Create button groups with rich text, icons, and styling options.

Installation

pip install st-segmented-buttons

Quick start

import streamlit as st
from st_segmented_buttons import segmented_buttons

# Simple example
selection = segmented_buttons(
    ["Option A", "Option B", "Option C"],
    default="Option A",
    key="simple_buttons"
)

if selection:
    st.write(f"You selected: {selection}")

Parameters

Button dictionary format

When using dictionaries for buttons:

{
    "label": "Display Text",     # Required: HTML string
    "value": "return_value",     # Required: Return value
    "icon": "🎯",                # Optional: Icon/emoji
    "disabled": False            # Optional: Disable button
}

Return values

• Single select: Returns selected value as str or None
• Multi-select: Returns list of selected values as List[str] or []

License

MIT License - see LICENSE file for details.