&e\+\ddlmZddlmZddlmZddlmZmZm Z m Z m Z m Z ddl mZddlmZmZmZmZddlmZddlmZdd lmZdd lmZmZdd lmZm Z m!Z!m"Z"dd l#m$Z$dd l%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-ddl.m/Z/erddl0m1Z1eGdde e)Z2GddZ3dS)) annotations) dataclass)dedent) TYPE_CHECKINGAnyCallableGenericSequencecast)current_form_id)check_callback_rulescheck_session_state_rules get_label_visibility_proto_valuemaybe_coerce_enum)StreamlitAPIException) Selectbox)gather_metrics)ScriptRunContextget_script_run_ctx) WidgetArgsWidgetCallback WidgetKwargsregister_widget)compute_widget_id)KeyLabelVisibilityOptionSequenceTcheck_python_comparableensure_indexablemaybe_raise_label_warningsto_key)index_)DeltaGeneratorc8eZdZUded<ded<ddZ dddZdS)SelectboxSerdez Sequence[T]options int | Noneindexvobjectreturnch|dSt|jdkrdSt|j|SNr)lenr'r#)selfr*s Dlib/python3.11/site-packages/streamlit/elements/widgets/selectbox.py serializezSelectboxSerde.serialize;s8 94 t|   ! !1dlA&&&ui_value widget_idstrT | Nonecj||n|j}|%t|jdkr |j|ndSr.)r)r/r')r0r5r6idxs r1 deserializezSelectboxSerde.deserializeBs? #.hhDJ$'ODL8I8IA8M8Mt|C  SWWr3N)r*r+r,r()r4)r5r(r6r7r,r8)__name__ __module__ __qualname____annotations__r2r;r3r1r&r&6sg''''XXXXXXXr3r&ceZdZeddedddddfddddd(d!Zdedddddfddddd"d)d%Zed*d'ZdS)+SelectboxMixin selectboxrNzChoose an optionFvisible) placeholderdisabledlabel_visibilitylabelr7r'OptionSequence[T]r)r( format_funcCallable[[Any], Any]key Key | Nonehelp str | None on_changeWidgetCallback | NoneargsWidgetArgs | NonekwargsWidgetKwargs | NonerErFboolrGrr,r8c bt} |||||||||| | | | |  S)aDisplay a select widget. Parameters ---------- label : str A short label explaining to the user what this select widget is for. The label can optionally contain Markdown and supports the following elements: Bold, Italics, Strikethroughs, Inline Code, Emojis, and Links. This also supports: * Emoji shortcodes, such as ``:+1:`` and ``:sunglasses:``. For a list of all supported codes, see https://share.streamlit.io/streamlit/emoji-shortcodes. * LaTeX expressions, by wrapping them in "$" or "$$" (the "$$" must be on their own lines). Supported LaTeX functions are listed at https://katex.org/docs/supported.html. * Colored text, using the syntax ``:color[text to be colored]``, where ``color`` needs to be replaced with any of the following supported colors: blue, green, orange, red, violet, gray/grey, rainbow. Unsupported elements are unwrapped so only their children (text contents) render. Display unsupported elements as literal characters by backslash-escaping them. E.g. ``1\. Not an ordered list``. For accessibility reasons, you should never set an empty label (label="") but hide it with label_visibility if needed. In the future, we may disallow empty labels by raising an exception. options : Iterable Labels for the select options in an Iterable. For example, this can be a list, numpy.ndarray, pandas.Series, pandas.DataFrame, or pandas.Index. For pandas.DataFrame, the first column is used. Each label will be cast to str internally by default. index : int The index of the preselected option on first render. If ``None``, will initialize empty and return ``None`` until the user selects an option. Defaults to 0 (the first option). format_func : function Function to modify the display of the labels. It receives the option as an argument and its output will be cast to str. key : str or int An optional string or integer to use as the unique key for the widget. If this is omitted, a key will be generated for the widget based on its content. Multiple widgets of the same type may not share the same key. help : str An optional tooltip that gets displayed next to the selectbox. on_change : callable An optional callback invoked when this selectbox's value changes. args : tuple An optional tuple of args to pass to the callback. kwargs : dict An optional dict of kwargs to pass to the callback. placeholder : str A string to display when no options are selected. Defaults to 'Choose an option'. disabled : bool An optional boolean, which disables the selectbox if set to True. The default is False. label_visibility : "visible", "hidden", or "collapsed" The visibility of the label. If "hidden", the label doesn't show but there is still empty space for it above the widget (equivalent to label=""). If "collapsed", both the label and the space are removed. Default is "visible". Returns ------- any The selected option or ``None`` if no option is selected. Example ------- >>> import streamlit as st >>> >>> option = st.selectbox( ... 'How would you like to be contacted?', ... ('Email', 'Home phone', 'Mobile phone')) >>> >>> st.write('You selected:', option) .. output:: https://doc-selectbox.streamlit.app/ height: 320px To initialize an empty selectbox, use ``None`` as the index value: >>> import streamlit as st >>> >>> option = st.selectbox( ... "How would you like to be contacted?", ... ("Email", "Home phone", "Mobile phone"), ... index=None, ... placeholder="Select contact method...", ... ) >>> >>> st.write('You selected:', option) .. output:: https://doc-selectbox-empty.streamlit.app/ height: 320px ) rHr'r)rJrLrNrPrRrTrErFrGctx)r _selectbox)r0rHr'r)rJrLrNrPrRrTrErFrGrXs r1rCzSelectboxMixin.selectboxLsRr!""##-   r3)rErFrGrXrXScriptRunContext | Nonec  t|}t|j|t|dkrdn||t || t |}t |td||fd|D|||| t|j| r| j nd }t|ts&|$tdt|jz|>t|dkr+d|cxkrt|ksntdt!}||_||_|||_fd|D|jdd<t|j|_| |_| |_t1| |j_|t7||_t;||}t=d||||| |j|j | }tC|||}|j"r*| |j}|||_d |_#|j$d||jS) Nr) default_valuerLrCc@g|]}t|Sr@r7.0optionrJs r1 z-SelectboxMixin._selectbox..s+@@@&SV,,--@@@r3) user_keyrHr'r)rLrNrEform_idpagez$Selectbox Value has invalid type: %sz7Selectbox index must be between 0 and length of optionsc@g|]}t|Sr@r^r_s r1rbz-SelectboxMixin._selectbox.. s+%Q%Q%Q6c++f*=*=&>&>%Q%Q%Qr3)rcon_change_handlerrRrT deserializer serializerrXT)%r"r dgrr!r rrr page_script_hash isinstanceintrtyper<r/SelectboxProtoidrHdefaultr'rdrErFrrGvaluerrNr&rr;r2r value_changed set_value_enqueue)r0rHr'r)rJrLrNrPrRrTrErFrGrXoptrpselectbox_protoserde widget_stateserialized_values ` r1rYzSelectboxMixin._selectboxs"SkkTWi000! SVWWWW"5*:;;;w''$$$  @@@@C@@@##DG,,),6%%$    %%% %*;'6e9MM   SAa56K6K6K6K3s886K6K6K6K'I )** %  &+O #%Q%Q%Q%QS%Q%Q%Q""1$'":":&1##+ 1Q 2 2 (.  #)$<rr7rCrYpropertyrjr@r3r1rBrBKs^K  ,/+/"&&*G .,5G G G G G ! G Z,/+/"&&*W".,5'+W"W"W"W"W"W"r,,,X,,,r3rBN)4 __future__r dataclassesrtextwraprtypingrrrr r r streamlit.elements.formr streamlit.elements.utilsr rrrstreamlit.errorsrstreamlit.proto.Selectbox_pb2rrostreamlit.runtime.metrics_utilrstreamlit.runtime.scriptrunnerrrstreamlit.runtime.staterrrrstreamlit.runtime.state.commonrstreamlit.type_utilrrrrrr r!r"streamlit.utilr#streamlit.delta_generatorr$r&rBr@r3r1rsk#"""""!!!!!!HHHHHHHHHHHHHHHH333333 322222EEEEEE999999OOOOOOOO =<<<<<                    "!!!!!9888888 XXXXXWQZXX X(g,g,g,g,g,g,g,g,g,g,r3