panel.widgets.icon module#
- class panel.widgets.icon.ButtonIcon(*, clicks, toggle_duration, active_icon, icon, size, description, description_delay, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, value, name)[source]#
Bases:
_ClickableIcon
,_ClickButton
,TooltipMixin
The ButtonIcon widget facilitates event triggering upon button clicks.
This widget displays a default icon initially. Upon being clicked, an active_icon appears for a specified toggle_duration.
For instance, the ButtonIcon can be effectively utilized to implement a feature akin to ChatGPT’s copy-to-clipboard button.
The button incorporates a value attribute, which alternates between False and True as the click event is processed.
Furthermore, it includes an clicks attribute, enabling subscription to click events for further actions or monitoring.
Reference: https://panel.holoviz.org/reference/widgets/ButtonIcon.html
- Example:
>>> button_icon = pn.widgets.ButtonIcon( ... icon='clipboard', ... active_icon='check', ... description='Copy', ... toggle_duration=2000 ... )
Methods
on_click
(callback)Register a callback to be executed when the button is clicked.
Parameter Definitions
Parameters inherited from:
panel.viewable.Layoutable
: align, aspect_ratio, css_classes, design, min_width, min_height, max_width, max_height, styles, stylesheets, tags, width_policy, height_policy, sizing_mode, visiblepanel.viewable.Viewable
: loadingpanel.widgets.base.Widget
: height, margin, width, disabledpanel.widgets._mixin.TooltipMixin
: description, description_delaypanel.widgets.icon._ClickableIcon
: active_icon, icon, sizevalue = Boolean(default=False, label='Value')
Toggles from False to True while the event is being processed.
clicks = Integer(default=0, inclusive_bounds=(True, True), label='Clicks')
The number of times the button has been clicked.
toggle_duration = Integer(default=75, inclusive_bounds=(True, True), label='Toggle duration')
The number of milliseconds the active_icon should be shown for and how long the button should be disabled for.
- on_click(callback: Callable[[Event], None]) Watcher [source]#
Register a callback to be executed when the button is clicked.
The callback is given an Event argument declaring the number of clicks.
- Parameters:
- callback: (Callable[[param.parameterized.Event], None])
The function to run on click events. Must accept a positional Event argument
- Returns:
- watcher: param.Parameterized.Watcher
A Watcher that executes the callback when the MenuButton is clicked.
- class panel.widgets.icon.ToggleIcon(*, active_icon, icon, size, description, description_delay, disabled, loading, align, aspect_ratio, css_classes, design, height, height_policy, margin, max_height, max_width, min_height, min_width, sizing_mode, styles, stylesheets, tags, visible, width, width_policy, value, name)[source]#
Bases:
_ClickableIcon
,TooltipMixin
The ToggleIcon widget allows toggling a single condition between True/False states. This widget is interchangeable with the Checkbox and Toggle widget.
This widget incorporates a value attribute, which alternates between False and True.
Reference: https://panel.holoviz.org/reference/widgets/ToggleIcon.html
- Example:
>>> pn.widgets.ToggleIcon( ... icon="thumb-up", active_icon="thumb-down", size="4em", description="Like" ... )
Parameter Definitions
Parameters inherited from:
panel.viewable.Layoutable
: align, aspect_ratio, css_classes, design, min_width, min_height, max_width, max_height, styles, stylesheets, tags, width_policy, height_policy, sizing_mode, visiblepanel.viewable.Viewable
: loadingpanel.widgets.base.Widget
: height, margin, width, disabledpanel.widgets._mixin.TooltipMixin
: description, description_delaypanel.widgets.icon._ClickableIcon
: value, active_icon, icon, size