B p[2@sdZddlmZddlmZmZmZddlmZddl m Z ddl m Z m Z ddlmZmZmZmZmZmZdd lZeGd d d e eZeGd d d eeZd S)zButton class. Represents a button in the frontend using a widget. Allows user to listen for click events on the button and trigger backend code when the clicks are fired. ) DOMWidget)CallbackDispatcherregisterwidget_serialization) CoreWidget)Style)Color InstanceDict)UnicodeBoolCaselessStrEnumInstancevalidatedefaultNc@sHeZdZdZedjddZeddddjddZedd jddZ dS) ButtonStylezButton style widget.ZButtonStyleModelT)syncNzColor of the button)Z allow_nonehelpzButton text font weight.)r) __name__ __module__ __qualname____doc__r tag _model_namerZ button_colorZ font_weightrr?lib/python3.7/site-packages/ipywidgets/widgets/widget_button.pyrsrcseZdZdZedjddZedjddZeddjddZeddjddZ e d d djddZ ed d djddZ e d ddddd gd ddjddZeejfddieZfddZedddZd ddZddZddZZS)!ButtonaButton widget. This widget has an `on_click` method that allows you to listen for the user clicking on the button. The click event itself is stateless. Parameters ---------- description: str description displayed next to the button tooltip: str tooltip caption of the toggle button icon: str font-awesome icon name disabled: bool whether user interaction is enabled Z ButtonViewT)rZ ButtonModelz Button label.)rzTooltip caption of the button.FzEnable or disable user changes.z1Font-awesome icon name, without the 'fa-' prefix.ZprimaryZsuccessinfoZwarningZdangerz(Use a predefined styling for the button.)valuesZ default_valuerrc s*tt|jf|t|_||jdS)N)superr__init__r_click_handlersZon_msg_handle_button_msg)selfkwargs) __class__rrr!<szButton.__init__iconcCs.|d}|dr*tdt|dd}|S)zStrip 'fa-' if necessary'valuezfa-zsicons names no longer start with 'fa-', just use the class name itself (for example, 'check' instead of 'fa-check')N) startswithwarningswarnDeprecationWarning)r$Zproposalr(rrr_validate_iconAs   zButton._validate_iconcCs|jj||ddS)a9Register a callback to execute when the button is clicked. The callback will be called with one argument, the clicked button widget instance. Parameters ---------- remove: bool (optional) Set to true to remove the callback from the list of callbacks. )removeN)r"Zregister_callback)r$callbackr/rrron_clickKs zButton.on_clickcCs||dS)zProgrammatically trigger a click event. This will call the callbacks registered to the clicked button widget instance. N)r")r$rrrclickXsz Button.clickcCs|dddkr|dS)zHandle a msg from the front-end. Parameters ---------- content: dict Content of the msg. Zeventrr2N)getr2)r$_ZcontentZbuffersrrrr#`szButton._handle_button_msg)F)rrrrr rZ _view_namerZ descriptionZtooltipr Zdisabledr'r Z button_styler rrZstyler!rr.r1r2r# __classcell__rr)r&rrs   r)rZ domwidgetrZwidgetrrrZ widget_corerZ widget_stylerZ trait_typesrr Z traitletsr r r rrrr+rrrrrrs