U ARdM@sddlmZddlmZddlmZmZmZddlm Z ddl m Z m Z m Z ddlmZddlmZddlmZmZdd lmZmZmZmZdd lmZmZmZmZerdd l m!Z!eGd d d Z"GdddZ#dS)) dataclass)dedent) TYPE_CHECKINGOptionalcast)current_form_id)check_callback_rulescheck_session_state_rules get_label_visibility_proto_value)Checkbox)gather_metrics)ScriptRunContextget_script_run_ctx) WidgetArgsWidgetCallback WidgetKwargsregister_widget)KeyLabelVisibilitymaybe_raise_label_warningsto_key)DeltaGeneratorc@s>eZdZUeed<eedddZd eeeedddZd S) CheckboxSerdevalue)vreturncCst|SN)bool)selfrr?/tmp/pip-unpacked-wheel-b9et7o5g/streamlit/elements/checkbox.py serialize,szCheckboxSerde.serialize)ui_value widget_idrcCst|dk r|n|jSr)rr)rr#r$rrr deserialize/szCheckboxSerde.deserializeN)r") __name__ __module__ __qualname__r__annotations__r!rstrr%rrrr r(s rc@seZdZedddddeeeeeeeeee ee ee ed ddZ ddddd eeeeeeeeee ee ee ee ed d d Zed dddZdS) CheckboxMixincheckboxFNZvisible)disabledlabel_visibility) labelrkeyhelp on_changeargskwargsr-r.rc Cs$t} |j||||||||| | d S)a Display a checkbox widget. Parameters ---------- label : str A short label explaining to the user what this checkbox 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. 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``. value : bool Preselect the checkbox when it first renders. This will be cast to bool internally. 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 checkbox. on_change : callable An optional callback invoked when this checkbox'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. disabled : bool An optional boolean, which disables the checkbox if set to True. The default is False. This argument can only be supplied by keyword. label_visibility : "visible" or "hidden" or "collapsed" The visibility of the label. If "hidden", the label doesn't show but there is still empty space for it (equivalent to label=""). If "collapsed", both the label and the space are removed. Default is "visible". This argument can only be supplied by keyword. Returns ------- bool Whether or not the checkbox is checked. Example ------- >>> import streamlit as st >>> >>> agree = st.checkbox('I agree') >>> >>> if agree: ... st.write('Great!') .. output:: https://doc-checkbox.streamlitapp.com/ height: 220px ) r/rr0r1r2r3r4r-r.ctx)r _checkbox) rr/rr0r1r2r3r4r-r.r5rrr r,4sTzCheckboxMixin.checkbox)r-r.r5) r/rr0r1r2r3r4r-r.r5rc Cst|}t|j|t|dkr"dn||dt|| t} || _t|| _t |j| _ |dk rjt || _ t |} td| ||||| j| j| d } || _t| | j_| jr| j| _d| _|jd| | jS)NF) default_valuer0r,)Zuser_keyZon_change_handlerr3r4Z deserializer serializerr5T)rrdgr r CheckboxProtor/rdefaultrZform_idrr1rrr%r!r-r r.r value_changed set_valueZ_enqueue)rr/rr0r1r2r3r4r-r.r5Zcheckbox_protoZserdeZcheckbox_staterrr r6sD     zCheckboxMixin._checkboxr)rcCs td|S)zGet our DeltaGenerator.r)r)rrrr r9szCheckboxMixin.dg)FNNNNN)FNNNNN)r&r'r(r r*rrrrrrrr,r r6propertyr9rrrr r+3s^ d  9r+N)$Z dataclassesrtextwraprtypingrrrZstreamlit.elements.formrZstreamlit.elements.utilsrr r Zstreamlit.proto.Checkbox_pb2r r:Zstreamlit.runtime.metrics_utilr Zstreamlit.runtime.scriptrunnerr rZstreamlit.runtime.staterrrrZstreamlit.type_utilrrrrZstreamlit.delta_generatorrrr+rrrr s