The logo for Shiny for Python Shiny for Python
  • Get Started
  • Concepts
  • Components
    • Components
    • Layouts
    • Templates
  • Gallery
  • Playground
  • Reference
    • Shiny Express
    • Shiny Core
    • Testing
  1. Input components
  2. express.ui.input_action_link
  • Shiny Express API
  • Input components
    • express.ui.input_select
    • express.ui.input_selectize
    • express.ui.input_slider
    • express.ui.input_dark_mode
    • express.ui.input_date
    • express.ui.input_date_range
    • express.ui.input_checkbox
    • express.ui.input_checkbox_group
    • express.ui.input_switch
    • express.ui.input_radio_buttons
    • express.ui.input_numeric
    • express.ui.input_text
    • express.ui.input_text_area
    • express.ui.input_password
    • express.ui.input_action_button
    • express.ui.input_action_link
    • express.ui.input_task_button
  • Output components
    • express.render.plot
    • express.render.table
    • express.render.DataTable
    • express.render.data_frame
    • express.render.DataGrid
    • express.render.text
    • express.render.ui
    • express.render.download
    • express.render.image
    • express.render.express
  • Layouts and other UI tools
    • express.ui.page_opts
    • express.ui.sidebar
    • express.ui.layout_columns
    • express.ui.layout_column_wrap
    • express.ui.card
    • express.ui.card_header
    • express.ui.card_footer
    • express.ui.value_box
    • express.ui.value_box_theme
    • express.ui.popover
    • express.ui.tooltip
    • express.ui.accordion
    • express.ui.accordion_panel
    • express.ui.layout_sidebar
  • Navigate multiple panels
    • express.ui.nav_panel
    • express.ui.navset_card_underline
    • express.ui.navset_card_tab
    • express.ui.navset_card_pill
    • express.ui.nav_spacer
    • express.ui.nav_menu
    • express.ui.nav_control
    • express.ui.navset_bar
    • express.ui.navset_tab
    • express.ui.navset_pill
    • express.ui.navset_underline
    • express.ui.navset_pill_list
    • express.ui.navset_hidden
    • express.ui.navbar_options
  • Chat interface
    • express.ui.Chat
  • Streaming markdown
    • express.ui.MarkdownStream
  • Reactive programming
    • reactive.calc
    • reactive.effect
    • reactive.value
    • reactive.event
    • reactive.isolate
    • reactive.invalidate_later
    • reactive.extended_task
    • reactive.flush
    • reactive.poll
    • reactive.file_reader
    • reactive.lock
    • req
  • Reusable Express code
    • express.ui.hold
    • express.expressify
  • Update inputs
    • express.ui.update_select
    • express.ui.update_selectize
    • express.ui.update_slider
    • express.ui.update_dark_mode
    • express.ui.update_date
    • express.ui.update_date_range
    • express.ui.update_checkbox
    • express.ui.update_checkbox_group
    • express.ui.update_switch
    • express.ui.update_radio_buttons
    • express.ui.update_numeric
    • express.ui.update_text
    • express.ui.update_text_area
    • express.ui.update_navs
    • express.ui.update_action_button
    • express.ui.update_action_link
    • express.ui.update_task_button
  • Update UI Layouts
    • express.ui.update_sidebar
    • express.ui.update_tooltip
    • express.ui.update_popover
    • express.ui.update_accordion
    • express.ui.update_accordion_panel
    • express.ui.insert_accordion_panel
    • express.ui.remove_accordion_panel
  • Display messages
    • express.ui.help_text
    • express.ui.notification_show
    • express.ui.notification_remove
    • express.ui.modal
    • express.ui.modal_show
    • express.ui.modal_remove
    • express.ui.modal_button
    • express.ui.Progress
  • Modules
    • express.module
  • UI panels
    • express.ui.panel_absolute
    • express.ui.panel_fixed
    • express.ui.panel_title
    • express.ui.panel_well
  • Uploads & downloads
    • express.ui.input_file
    • express.render.download
  • Dynamic UI
    • express.ui.panel_conditional
    • express.ui.insert_ui
    • express.ui.remove_ui
  • User Session
    • session.Session
  • Client Data
    • session.ClientData
  • UI as HTML
    • express.ui.Theme
    • express.ui.markdown
    • express.ui.include_css
    • express.ui.include_js
    • express.ui.HTML
    • express.ui.tags
    • express.ui.TagList
    • express.ui.busy_indicators.use
    • express.ui.busy_indicators.options
  • Application-level settings
    • express.app_opts
  • Express developer tooling
    • express.is_express_app
    • express.wrap_express_app

On this page

  • express.ui.input_action_link
    • Parameters
    • Returns
    • Notes
    • See Also
    • Examples
  • Report an issue
  • Edit this page
  1. Input components
  2. express.ui.input_action_link

express.ui.input_action_link

express.ui.input_action_link(id, label, *, icon=None, **kwargs)

Creates a link whose value is initially zero, and increments by one each time it is pressed.

Parameters

id : str

An input id.

label : TagChild

An input label.

icon : TagChild = None

An icon to appear inline with the button/link.

****kwargs** : TagAttrValue = {}

Attributes to be applied to the link.

Returns

: Tag

A UI element

Notes

Server value

An integer representing the number of clicks.

See Also

  • update_action_link
  • input_action_button
  • event

Examples

#| '!! shinylive warning !!': |
#|   shinylive does not work in self-contained HTML documents.
#|   Please set `embed-resources: false` in your metadata.
#| standalone: true
#| components: [editor, viewer]
#| layout: vertical
#| viewerHeight: 400

## file: app.py
import matplotlib.pyplot as plt
import numpy as np

from shiny import reactive
from shiny.express import input, render, ui

ui.input_slider("n", "Number of observations", min=0, max=1000, value=500)
ui.input_action_link("go", "Go!")


@render.plot(alt="A histogram")
# reactive.event() to invalidate the plot when the button is pressed but not when
# the slider is changed
@reactive.event(input.go, ignore_none=False)
def plot():
    np.random.seed(19680801)
    x = 100 + 15 * np.random.randn(input.n())
    fig, ax = plt.subplots()
    ax.hist(x, bins=30, density=True)
    return fig

express.ui.input_action_button
express.ui.input_task_button

Proudly supported by Posit

 
  • Report an issue
  • Edit this page