e2UdZddlmZddlmZmZmZmZmZm Z m Z m Z m Z m Z ddlZddlmZmZddlmZmZddlmZmZdd lmZdd lmZdd lmZ d d l!m"Z"d dl#m$Z$erddl%m&Z&ddl'm(Z(ddl)m*Z*ddlm+Z+m,Z,gdZ-de.d<ddgZ/de.d<Gdde$Z0Gdde$Z1Gdde0e1Z2Gdd e2e"ZGd!d"e0e1ZGd#d$e2Z3dS)%zt Defines the Button and button-like widgets which allow triggering events or merely toggling between on-off states. ) annotations) TYPE_CHECKINGAny AwaitableCallableClassVarDictListMappingOptionalTypeN) ButtonClick MenuItemClick)DropdownToggle)SVGIcon TablerIcon)CDN_DISTCallback)Button) TooltipMixin)Widget)Document)Model)Comm) JSLinkTargetLink)defaultprimarysuccesswarningdangerlight List[str] BUTTON_TYPESsolidoutline BUTTON_STYLESceZdZUejdedZejdedZdddZ d e d <d diZ d e d <e d gZ de d<dZfdZxZS) _ButtonBaser!z A button theme; should be one of 'default' (white), 'primary' (blue), 'success' (green), 'info' (yellow), 'light' (light), or 'danger' (red).)r!objectsdocr)z= A button style to switch between 'solid', 'outline'.labelN)name button_style"ClassVar[Mapping[str, str | None]]_renamer2_source_transformszcss/button.csszClassVar[List[str]] _stylesheetsTcd|vsd|vr;|d|jg|d|jz|d<t |S)Nr2 css_classes)popr2getr8super_process_param_changeselfparams __class__s 4lib/python3.11/site-packages/panel/widgets/button.pyr<z!_ButtonBase._process_param_change5sk V # #}'>'> >4+<==% =$*:;;%Ld=SSSSS,4)D)D)D(ELEEEEJ555555555rBr-ceZdZUejddZejddZddddZded <d Z dfd Z fdZ xZ S) IconMixinNz An icon to render to the left of the button label. Either an SVG or an icon name which is loaded from https://tabler-icons.io.r!r/1emz8 Size of the icon as a string, e.g. 12px or 1em.icon) icon_size_iconrQr3r4TreturnNonec |t|jfitj|_tjdi|dS)N)dictr4rNr;__init__r=s rArYzIconMixin.__init__LsBDL>>I,=>> ""6"""""rBcT|d|j}|dW|d}|drt ||}nt ||}||d<t|S)NrRrQzr?rRrQ icon_modelr@s rAr<zIconMixin._process_param_changePsJJ{DN;; ::f   )&>D{{}}''// H$I>>> '$YGGG (F7Oww,,V444rB)rTrU) rCrDrErFStringrQrRr4rI_IconMixin__abstractrYr<rKrLs@rArNrN=s 5<+C D D DD U1;<<r/rhrjrkror@s rArpz_ClickButton._get_modelfsF""3fd;; dkCdKKK rBargsDict[str, Any]codestrrc>ddlm}||d|jz|i|S)a Allows defining a JS callback to be triggered when the button is clicked. Arguments ---------- args: dict A mapping of objects to make available to the JS callback code: str The Javascript code to execute when the button is clicked. Returns ------- callback: Callback The Callback which can be used to disable the callback. rrevent:rvrt)linksrrg)r>rtrvrs rA js_on_clickz_ClickButton.js_on_clickns9" %$$$$$xHT[$8$#?dKKKKrB callbacksc t|D]7\}}|dkr d|jz}|j||}||||<8t |||S)a Allows defining a Javascript (JS) callback to be triggered when a property changes on the source object. The keyword arguments define the properties that trigger a callback and the JS code that gets executed. Arguments ---------- args: dict A mapping of objects to make available to the JS callback **callbacks: dict A mapping between properties on the source model and the code to execute when that property changes Returns ------- callback: Callback The Callback which can be used to disable the callback. clicksryNrz)listitemsrgr4r:r)r>rtr}kvvals rA jscallbackz_ClickButton.jscallbacksy(**++ # #DAqH}}T[(,""1a((C" ! 948888rBNNN r/rrhrirjrirkrlrTr)rtrurvrwrTr)rtrur}rwrTr) rCrDrE_ClickButton__abstractrgrIr5rpr|rrKrLs@rArdrd\sJ*F**** > 6:?C24LLLLL(13999999999rBrdceZdZUdZejddZejdZie j dddd Z d e d <ddd Z d e d <dddZ d e d<eZde d<fdZed+fd Z d,d-fd" Zd.d&Zd/d*ZxZS)0ra  The `Button` widget allows triggering events when the button is clicked. The Button provides a `value` parameter, which will toggle from `False` to `True` while the click event is being processed It also provides an additional `clicks` parameter, that can be watched to subscribe to click events. Reference: https://panel.holoviz.org/reference/widgets/Button.html#widgets-gallery-button :Example: >>> pn.widgets.Button(name='Click me', icon='caret-right', button_type='primary') rz. Number of clicks (can be listened to)rOzG Toggles from False to True while the event is being processed.)r/Nr0)rr1valuer3r4)r2 descriptionr5)zevent:button_clickr_target_transformsClassVar[Type[Model]] _widget_typec |dd}tjdi||r||dSdSNon_clickrWr9r;rYrr>r? click_handlerr@s rArYzButton.__init__] :t44 ""6"""  ) MM- ( ( ( ( ( ) )rBrTr'c2tjdgzS)Nr)r;_linkable_params)r>r@s rArzButton._linkable_paramssww'7)33rBFtargetrrvOptional[Dict[str, str]]rtOptional[Dict[str, Any]] bidirectionalboolr{rwr c fd|D}tj||||fi|S)a Links properties on the this Button to those on the `target` object in Javascript (JS) code. Supports two modes, either specify a mapping between the source and target model properties as keywords or provide a dictionary of JS code snippets which maps from the source parameter to a JS code snippet which is executed when the property changes. Arguments ---------- target: panel.viewable.Viewable | bokeh.model.Model | holoviews.core.dimension.Dimensioned The target to link the value(s) to. code: dict Custom code which will be executed when the widget value changes. args: dict A mapping of objects to make available to the JS callback bidirectional: boolean Whether to link source and target bi-directionally. Default is `False`. **links: dict[str,str] A mapping between properties on the source model and the target model property to link it to. Returns ------- Link The Link can be used unlink the widget and the target model. c<i|]\}}|dkr djzn||S)rry)rg).0prr>s rA z!Button.jslink..s3ZZZDAqg$+%%1aZZZrB)rr;jslink)r>rrvrtrr{r@s` rArz Button.jslinksMF[ZZZEKKMMZZZuww~fdD-II5IIIrBeventparam.parameterized.EventrUcZ|jd|xjdz c_dS)Nrr)rFtriggerr)r>rs rA_process_eventzButton._process_events, 7### q rBcallback=Callable[[param.parameterized.Event], None | Awaitable[None]]param.parameterized.Watcherc<|j|ddS)a Register a callback to be executed when the `Button` is clicked. The callback is given an `Event` argument declaring the number of clicks Example ------- >>> button = pn.widgets.Button(name='Click me') >>> def handle_click(event): ... print("I was clicked!") >>> button.on_click(handle_click) Arguments --------- callback: The function to run on click events. Must accept a positional `Event` argument. Can be a sync or async function Returns ------- watcher: param.Parameterized.Watcher A `Watcher` that executes the callback when the button is clicked. rF onlychangedrFwatchr>rs rArzButton.on_clicks!6z(FFFrB)rTr')NNF) rrrvrrtrrrr{rwrTr )rrrTrU)rrrTr)rCrDrE__doc__rFIntegerrEventrrr4rIr5r _BkButtonrrYpropertyrrrrrKrLs@rArrs"U]1+1222F EKJ K K KE3  3*.$333G T>> #T>>+4L3333))))) 44444X4FJEJ$J$J$J$J$J$J$JLGGGGGGGGrBrcpeZdZUdZejddZdddZded <d Z d ed <e Z d ed<ddZ dS)ra'The `Toggle` widget allows toggling a single condition between `True`/`False` states. This widget is interchangeable with the `Checkbox` widget. Reference: https://panel.holoviz.org/reference/widgets/Toggle.html :Example: >>> Toggle(name='Toggle', button_type='success') Fz1 Whether the button is currently toggled.rOactiver0)rr1r3r4TzClassVar[bool]_supports_embedrrNcP||j|jddddgdddfS)NidrFTc|jSN)r)xs rAz)Toggle._get_embed_state..0s!(rBrz cb_obj.active)_modelsref)r>rhvaluesmax_optss rA_get_embed_statezToggle._get_embed_state.s3dl48D>215t}""Ho? ?rB)Nr) rCrDrErrFBooleanrr4rIr _BkTogglerrrWrBrArrs   EM%.4 5 5 5E733G'+O*****3L3333??????rBrceZdZUdZejddZejgdZej ddZ dZ d e d <d d dd Z de d<eZde d<fdZ d"d#fd ZdZd$d!ZxZS)% MenuButtonaM The `MenuButton` widget allows specifying a list of menu items to select from triggering events when the button is clicked. Unlike other widgets, it does not have a `value` parameter. Instead it has a `clicked` parameter that can be watched to trigger events and which reports the last clicked menu item. Reference: https://panel.holoviz.org/reference/widgets/MenuButton.html :Example: >>> menu_items = [('Option A', 'a'), ('Option B', 'b'), None, ('Option C', 'c')] >>> MenuButton(name='Dropdown', items=menu_items, button_type='primary') Nz' Last menu item that was clicked.rOz Menu items in the dropdown. Allows strings, tuples of the form (title, value) or Nones to separate groups of items.Fz7 Whether to add separate dropdown area to button.menu_item_clickrfrgr0menu)r1rclickedr3r4rrc |dd}tjdi||r||dSdSrrrs rArYzMenuButton.__init__UrrBr/rrhrirjrkrlrTrct||||}|d||||S)Nrern)r;rprqrrs rArpzMenuButton._get_model[sD""3fd;; nEsNNN rBct|tr|j}nt|tr|j}||_dSr) isinstanceritemrr1r)r>rrs rArzMenuButton._process_eventcsA e] + + :DD { + + 9D rBr+Callable[[param.parameterized.Event], None]rc<|j|ddS)a Register a callback to be executed when the button is clicked. The callback is given an `Event` argument declaring the number of clicks Arguments --------- 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. rFrrrs rArzMenuButton.on_clickjs!$z)GGGrBrr)rrrTr)rCrDrErrFrarr rrsplitrgrIr4 _BkDropdownrrYrprrrKrLs@rArr3s="el4.*+++G EJr(> ? ? ?E EM%.: ; ; ;E.F----;BV`d2e2eGeeee*5L5555)))))6:?CHHHHHHHHrBr)4r __future__rtypingrrrrrr r r r r rF bokeh.eventsrr bokeh.modelsrrrrbokeh.models.uirr io.resourcesrr{rmodels.widgetsrr_mixinrbaserbokeh.documentr bokeh.modelr pyviz_commsrrr r(rIr+r-rNrdrrWrBrArs #"""""  33333333EEEEEEEE////////######000000 +''''''!!!!!!      ********ZYY YYYY#Y/ ////55555&555455555555>@9@9@9@9@9; @9@9@9FuGuGuGuGuG\<uGuGuGp?????[)???8IHIHIHIHIHIHIHIHIHIHrB