-egAdZddlmZddlZejeZddlmZddl m Z ddl m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z dd l!m"Z"dd l#m$Z$d d l%m&Z&d Z'e Gdde&Z(Gdde(Z)Gdde(Z*Gdde*Z+e Gdde&Z,Gdde,Z-Gdde,Z.Gdde(Z/Gdde/Z0Gd d!e/Z1Gd"d#e0Z2Gd$d%e0Z3Gd&d'e(Z4Gd(d)e(Z5Gd*d+e(Z6Gd,d-e(Z7Gd.d/e(Z8dS)0z4 Various kinds of input widgets and form controls. ) annotationsN)inf)abstract)BoolColorColorHexDictEitherEnumFloatInstanceIntIntervalList NonNegativeNullNullableOverridePositiveReadonlyRequiredSeqStringTuple) TickFormatter)Tooltip)Widget)AutocompleteInputCheckboxColorMap ColorPicker FileInput InputWidget MultiChoice MultiSelect NumericInput PasswordInputSelectSpinnerSwitch TextAreaInput TextInputceZdZdZd fd ZeddZeeee e dd Z e d Z xZS) r&z- Abstract base class for input widgets. returnNonec:tj|i|dSNsuper__init__selfargskwargs __class__s ;lib/python3.11/site-packages/bokeh/models/widgets/inputs.pyr7zInputWidget.__init__Y%$)&)))))z Widget's label. defaulthelpNzg Either a plain text or a tooltip with a rich HTML description of the function of this widget. c|d}t|trt|St|trt |St|t rt|S|S)Nvalue)lookup isinstancer floatrintrstr)clsvalprop_objs r= coerce_valuezInputWidget.coerce_valuedsp::g&& h & & ::  # & & s88O & ) ) s88OJr?r1r2)__name__ __module__ __qualname____doc__r7rtitlerr rr description classmethodrN __classcell__r<s@r=r&r&Rs ****** F2%   E(66&((7*;*;<r?a The base64-enconded contents of the file or files that were loaded. If `multiple` is set to False (default), this value is a single string with the contents of the single file that was chosen. If `multiple` is True, this value is a list of strings, each containing the contents of one of the multiple files that were chosen. The sequence of files is given by the list of filenames (see below) rCa The mime-type of the file or files that were loaded. If `multiple` is set to False (default), this value is a single string with the mime-type of the single file that was chosen. If `multiple` is True, this value is a list of strings, each containing the mime-type of one of the multiple files that were chosen. The sequence of files is given by the list of filename (see below) a8 The name(s) of the file or files that were loaded. If `multiple` is set to False (default), this value is a single string with the name of the single file that was chosen. If `multiple` is True, this value is a list of strings, each containing the name of one of the multiple files that were chosen. This list provides the sequence of files for the respective lists in value and mime-type .. note:: The full file path is not included since browsers will not provide access to that information for security reasons. r@a Comma-separated list of standard HTML file input filters that restrict what files the user can pick from. Values can be: ``: Specific file extension(s) (e.g: .gif, .jpg, .png, .doc) are pickable `audio/*`: all sound files are pickable `video/*`: all video files are pickable `image/*`: all image files are pickable ``: A valid `IANA Media Type`_, with no parameters. .. _IANA Media Type: https://www.iana.org/assignments/media-types/media-types.xhtml .. note:: A bug in some versions of Chrome on macOS Big Sur may limit how you can set a file input filter for those users. In those cases, it is impossible to limit the user's selection to specific file extensions - instead, the browser will limit users to predefined sets of file types, such as ``Text/*`` or ``Image/*``. See :bokeh-issue:`10888` for more information. rAFz set multiple=False (default) for single file selection, set multiple=True if selection of more than one file at a time should be possible. rO)rPrQrRrSr7rr rrrE mime_typefilenameacceptrmultiplerWrXs@r=r%r%ts ****** HVVFDDLL11 9 EV 55 =    IxvttF||44<   H VFDDLL"<   F<tE)   HHHHHr?r%ceZdZdZdfd ZeeeedZ eeeedZ eeeedZ e d d Z ed d dZeee eedZxZS)r)z Numeric input widget. r1r2c:tj|i|dSr4r5r8s r=r7zNumericInput.__init__r>r?za Initial or entered value. Change events are triggered whenever is pressed. r[z* Optional lowest allowable value. z+ Optional highest allowable value. r@, Placeholder for empty input field. rArIrHz Define the type of number which can be enter in the input example mode int: 1, -1, 156 mode float: 1, -1.2, 1.1e-25  rO)rPrQrRrSr7r rr rrElowhighr placeholderr moderrformatrWrXs@r=r)r)s ****** F4+   E &uc)   C 6$s*   D&+   K 4w&   DVD&((="9"9A   FFFFFr?r)ceZdZdZdfd Zeeeee dZ e dZ e ed ed d Ze ed edd Zee eddZxZS)r,z$ Numeric Spinner input widget. r1r2c:tj|i|dSr4r5r8s r=r7zSpinner.__init__r>r?z4 Value reported at the end of interactions. r[rHrBgؗҜeZdZdZdfd ZeddZxZS) ToggleInputz4 Base class for toggleable (boolean) input widgets. r1r2c:tj|i|dSr4r5r8s r=r7zToggleInput.__init__r>r?Fz" The state of the widget. rArO)rPrQrRrSr7ractiverWrXs@r=ruru sV>>******T%'   FFFFFr?ruc>eZdZdZdfd ZeddZxZS) r"z A checkbox widget. r1r2c:tj|i|dSr4r5r8s r=r7zCheckbox.__init__r>r?r@z) The label next to the checkbox. rArO)rPrQrRrSr7rlabelrWrXs@r=r"r"sV****** F2%   EEEEEr?r"c<eZdZdZdfd ZedZxZS)r-z A checkbox-like widget. r1r2c:tj|i|dSr4r5r8s r=r7zSwitch.__init__(r>r? rkrO)rPrQrRrSr7rwidthrWrXs@r=r-r-$sK##****** HR EEEEEr?r-ceZdZdZd fd ZeddZeddZedd Ze e d Z xZ S) TextLikeInputz. Base class for text-like input widgets. r1r2c:tj|i|dSr4r5r8s r=r7zTextLikeInput.__init__3r>r?r@zf Initial or entered text value. Change events are triggered whenever is pressed. rAz} Initial or current value. Change events are triggered whenever any update happens, i.e. on every keypress. rbz* Max count of characters in field r[rO) rPrQrRrSr7rrE value_inputrfrr max_lengthrWrXs@r=rr-s ****** F2%   E &+   K&+   K#%   JJJJJr?rcXeZdZdZdfd ZeedZeedZxZ S) r/z Single-line input widget. r1r2c:tj|i|dSr4r5r8s r=r7zTextInput.__init__Qr>r?z An optional string prefix to display before the input. This is useful to indicate e.g. a variable the entered value will be assigned to. r[z An optional string suffix to display after the input. This is useful to indicate e.g. the units of measurement of the entered value. rO) rPrQrRrSr7rrprefixsuffixrWrXs@r=r/r/Ksy ******Xf$   F Xf$   FFFFFr?r/cpeZdZdZd fd ZeddZedd Zed Z xZ S) r.z Multi-line input widget. r1r2c:tj|i|dSr4r5r8s r=r7zTextAreaInput.__init__dr>r?zX Specifies the width of the text area (in average character width). Default: 20 rArzF Specifies the height of the text area (in lines). Default: 2 irkrO) rPrQrRrSr7rcolsrowsrrrWrXs@r=r.r.^s ****** 3r!   D 3q    D#&&&JJJJJr?r.c$eZdZdZdfd ZxZS)r*a# Single-line password input widget. This widget hides the input value so that it is not visible in the browser. .. warning:: Secure transmission of the password to Bokeh server application code requires configuring the server for SSL (i.e. HTTPS) termination. r1r2c:tj|i|dSr4r5r8s r=r7zPasswordInput.__init__~r>r?rO)rPrQrRrSr7rWrXs@r=r*r*rsG**********r?r*ceZdZdZdfd ZeedZee e dZ e e dd Z ed d Zed d ZedddZxZS)r!z5 Single-line input widget with auto-completion. r1r2c:tj|i|dSr4r5r8s r=r7zAutocompleteInput.__init__r>r?z} A list of completion strings. This will be used to guide the user upon typing the beginning of a desired value. r[z; Optional maximum number of completions displayed. rzU The number of characters a user must type before completions are presented. rATz- Enable or disable case sensitivity. zs Set to False in order to allow users to enter text that is not present in the list of completion strings. starts_withincludesa Define how to search the list of completion strings. The default option ``"starts_with"`` means that the user's text must match the start of a completion string. Using ``"includes"`` means that the user's text can match any substring of a completion string. rO)rPrQrRrSr7rr completionsrrrmax_completionsrmin_charactersrcase_sensitiverestrictr search_strategyrWrXs@r=r!r!s ******$v%   K hxx}}4   O![a7   NT$.   NtD(   Hd=*<   OOOOOr?r!c\eZdZdZd fd Zeeeeeeee eeeeeeed eee edZ edd  e d Z xZS) r+z Single-select widget. r1r2c:tj|i|dSr4r5r8s r=r7zSelect.__init__r>r?a Available selection options. Options may be provided either as a list of possible string values, or as a list of tuples, each of the form ``(value, label)``. In the latter case, the visible widget text for each value will be corresponding given label. Option groupings can be provided by supplying a dictionary object whose values are in the aforementioned list format r[cd|DS)Ncg|]}|dn| SNr@).0items r= z#Select...s"7e7e7eZ^t|QU7e7e7er?r)vs r=zSelect.s7e7ebc7e7e7er?r@z$ Initial or selected value. rAcdSrr)_s r=rzSelect.sr?rO)rPrQrRrSr7r rrrr acceptsroptionsrErWrXs@r=r+r+s ******fTT&&vv)>)>??@@ VTT&&vv)>)>??@@AAI    ffT6**++-e-e f f  F2%   || $ $ EEEEr?r+c eZdZdZd fd ZeeeeeedZ eedZ e dd Z xZ S) r(z Multi-select widget. r1r2c:tj|i|dSr4r5r8s r=r7zMultiSelect.__init__r>r? Available selection options. Options may be provided either as a list of possible string values, or as a list of tuples, each of the form ``(value, label)``. In the latter case, the visible widget text for each value will be corresponding given label. r[% Initial or selected values. z The number of visible options in the dropdown list. (This uses the ``select`` HTML element's ``size`` attribute. Some browsers might not show less than 3 options.) rArO)rPrQrRrSr7rr rrrrErsizerWrXs@r=r(r(s ******d66&%%"7"788@   G D   E 3q    DDDDDr?r(c eZdZdZdfd ZeeeeeedZ eedZ e dd Z e ed Ze ed Ze ed Ze edZe dd ZxZS)r'z MultiChoice widget. r1r2c:tj|i|dSr4r5r8s r=r7zMultiChoice.__init__r>r?rr[rTz> Whether to add a button to remove a selected option. rAz; The maximum number of items that can be selected. zF The number of choices that will be rendered in the dropdown. zh The number of choices that will be rendered in the dropdown when search string is entered. z: A string that is displayed if not item is added. z: Specify whether the choices should be solidly filled.rO)rPrQrRrSr7rr rrrrEr delete_buttonrr max_items option_limitsearch_option_limitrfsolidrWrXs@r=r'r'sM ******d66&%%"7"788@   G D   ED-   M$   I8C'   L#(3.    (6)   K D%= > > >EEEEEr?r'c>eZdZdZdfd ZeddZxZS) r$z Color picker widget. r1r2c:tj|i|dSr4r5r8s r=r7zColorPicker.__init__ r>r?z#000000zF The initial color of the picked color (named or hexadecimal) rArO)rPrQrRrSr7r colorrWrXs@r=r$r$sZ ****** HY.   EEEEEr?r$c eZdZdZd fd ZeedZeee eee dZ e e ddZe e d dZee d dZxZS) r#z Color map picker widget. r1r2c:tj|i|dSr4r5r8s r=r7zColorMap.__init__r>r?rcr[rorArrrO)rPrQrRrSr7rrrErrritemsrr swatch_width swatch_heightrncolsrWrXs@r=r#r#s ****** HV#   E HSSvss5zz2233;   E;sC7   L KR7   M HS!+   EEEEEr?r#)9rS __future__rlogging getLoggerrPlogmathrcore.has_propsrcore.propertiesrrr r r r r rrrrrrrrrrrrrr formattersruirwidgetr __all__r&r%r)r,rur"r-rr/r.r*r!r+r(r'r$r#rr?r=rs#"""""g!!'&&&&&.'&&&&&  . & BR R R R R R R R j$ $ $ $ $ ;$ $ $ N     l   :       &            {    !!!!![!!!     K   <        &'''''M'''( * * * * *I * * * # # # # # # # # L%%%%%[%%%.     +   6*>*>*>*>*>+*>*>*>X      +         {     r?