U ARd=@sddlmZmZmZmZmZmZddlmZddl m Z ddl m Z ddlmZer`ddlmZeeeeeeffZGdddZd S) ) TYPE_CHECKINGListOptionalSequenceUnioncast)deprecate_func_name)StreamlitAPIException)Block)gather_metrics)DeltaGeneratorc@seZdZedddddZedddeeeedd d d Z ed e ee dd ddZ eddee ddddZ eddddZeeddZee ddZee ddZdS) LayoutsMixin containerr )returncCs |jS)aInsert a multi-element container. Inserts an invisible container into your app that can be used to hold multiple elements. This allows you to, for example, insert multiple elements into your app out of order. To add elements to the returned container, you can use "with" notation (preferred) or just call methods directly on the returned object. See examples below. Examples -------- Inserting elements using "with" notation: >>> import streamlit as st >>> >>> with st.container(): ... st.write("This is inside the container") ... ... # You can call any Streamlit command, including custom components: ... st.bar_chart(np.random.randn(50, 3)) ... >>> st.write("This is outside the container") .. output :: https://doc-container1.streamlitapp.com/ height: 520px Inserting elements out of order: >>> import streamlit as st >>> >>> container = st.container() >>> container.write("This is inside the container") >>> st.write("This is outside the container") >>> >>> # Now insert some more in the container >>> container.write("This is inside too") .. output :: https://doc-container2.streamlitapp.com/ height: 480px )dg_blockselfr>/tmp/pip-unpacked-wheel-b9et7o5g/streamlit/elements/layouts.pyrs-zLayoutsMixin.containercolumnssmall)gap)specrrcs|}td}t|trd|}t|dks>> import streamlit as st >>> >>> col1, col2, col3 = st.columns(3) >>> >>> with col1: ... st.header("A cat") ... st.image("https://static.streamlit.io/examples/cat.jpg") ... >>> with col2: ... st.header("A dog") ... st.image("https://static.streamlit.io/examples/dog.jpg") ... >>> with col3: ... st.header("An owl") ... st.image("https://static.streamlit.io/examples/owl.jpg") .. output :: https://doc-columns1.streamlitapp.com/ height: 620px Or you can just call methods directly in the returned objects: >>> import streamlit as st >>> import numpy as np >>> >>> col1, col2 = st.columns([3, 1]) >>> data = np.random.randn(10, 1) >>> >>> col1.subheader("A wide column with a chart") >>> col1.line_chart(data) >>> >>> col2.subheader("A narrow column with the data") >>> col2.write(data) .. output :: https://doc-columns2.streamlitapp.com/ height: 550px zThe input argument to st.columns must be either a positive integer or a list of positive numeric weights. See [documentation](https://docs.streamlit.io/library/api-reference/layout/st.columns) for more information.)rcss|]}|dkVqdS)rNr).0weightrrr sz'LayoutsMixin.columns..cSs>t|tkr*|}dddg}||kr*|Std|ddS)NrZmediumZlargez_The gap argument to st.columns must be "small", "medium", or "large". The argument passed was .)typestrlowerr )rgap_sizeZ valid_sizesrrr column_gaps   z(LayoutsMixin.columns..column_gap)normalized_weightrcs t}||j_|j_d|_|SNT) BlockProtocolumnrr allow_empty)r$Z col_proto)r"rr column_protos z*LayoutsMixin.columns..column_protocsg|]}|qSrr)rw)r)row total_weightrr sz(LayoutsMixin.columns..) r isinstanceintlenanyfloatr&Z horizontalrrrsum)rrrweightsZweights_exceptionr# block_protor)r)r"r,r-rrMs V   zLayoutsMixin.columnstabs)r7rcsj|s tdtdd|Dr&tdttdddt}|j|j|tfdd|DS) u Insert containers separated into tabs. Inserts a number of multi-element containers as tabs. Tabs are a navigational element that allows users to easily move between groups of related content. To add elements to the returned containers, you can use "with" notation (preferred) or just call methods directly on the returned object. See examples below. .. warning:: All the content of every tab is always sent to and rendered on the frontend. Conditional rendering is currently not supported. Parameters ---------- tabs : list of strings Creates a tab for each string in the list. The first tab is selected by default. The string is used as the name of the tab and can optionally contain Markdown, supporting 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``. Returns ------- list of containers A list of container objects. Examples -------- You can use `with` notation to insert any element into a tab: >>> import streamlit as st >>> >>> tab1, tab2, tab3 = st.tabs(["Cat", "Dog", "Owl"]) >>> >>> with tab1: ... st.header("A cat") ... st.image("https://static.streamlit.io/examples/cat.jpg", width=200) ... >>> with tab2: ... st.header("A dog") ... st.image("https://static.streamlit.io/examples/dog.jpg", width=200) ... >>> with tab3: ... st.header("An owl") ... st.image("https://static.streamlit.io/examples/owl.jpg", width=200) .. output :: https://doc-tabs1.streamlitapp.com/ height: 620px Or you can just call methods directly in the returned objects: >>> import streamlit as st >>> import numpy as np >>> >>> tab1, tab2 = st.tabs(["📈 Chart", "🗃 Data"]) >>> data = np.random.randn(10, 1) >>> >>> tab1.subheader("A tab with a chart") >>> tab1.line_chart(data) >>> >>> tab2.subheader("A tab with the data") >>> tab2.write(data) .. output :: https://doc-tabs2.streamlitapp.com/ height: 700px zBThe input argument to st.tabs must contain at least one tab label.css|]}t|tdkVqdS)FN)r/r )rtabrrrr0sz$LayoutsMixin.tabs..zBThe tabs input list to st.tabs is only allowed to contain strings.)labelrcSst}||j_d|_|Sr%)r&r8r9r()r9 tab_protorrrr:5sz$LayoutsMixin.tabs..tab_protoc3s|]}|VqdS)Nr*)rZ tab_label tab_containerr:rrr>s) r r2r r&r<Z SetInParentrrtuple)rr7r6rr;rr7s[  zLayoutsMixin.tabsexpanderF)r9expandedrcCsJ|dkrtdt}||_||_t}d|_|j||jj |dS)a~ Insert a multi-element container that can be expanded/collapsed. Inserts a container into your app that can be used to hold multiple elements and can be expanded or collapsed by the user. When collapsed, all that is visible is the provided label. To add elements to the returned container, you can use "with" notation (preferred) or just call methods directly on the returned object. See examples below. .. warning:: Currently, you may not put expanders inside another expander. Parameters ---------- label : str A string to use as the header for the expander. 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``. expanded : bool If True, initializes the expander in "expanded" state. Defaults to False (collapsed). Examples -------- You can use `with` notation to insert any element into an expander >>> import streamlit as st >>> >>> st.bar_chart({"data": [1, 5, 2, 6, 2, 1]}) >>> >>> with st.expander("See explanation"): ... st.write(\"\"\" ... The chart above shows some numbers I picked for you. ... I rolled actual dice for these, so they're *guaranteed* to ... be random. ... \"\"\") ... st.image("https://static.streamlit.io/examples/dice.jpg") .. output :: https://doc-expander.streamlitapp.com/ height: 750px Or you can just call methods directly in the returned objects: >>> import streamlit as st >>> >>> st.bar_chart({"data": [1, 5, 2, 6, 2, 1]}) >>> >>> expander = st.expander("See explanation") >>> expander.write(\"\"\" ... The chart above shows some numbers I picked for you. ... I rolled actual dice for these, so they're *guaranteed* to ... be random. ... \"\"\") >>> expander.image("https://static.streamlit.io/examples/dice.jpg") .. output :: https://doc-expander.streamlitapp.com/ height: 750px Nz#A label is required for an expanderT)r6) r r&Z Expandabler?r9r(Z expandableZCopyFromrr)rr9r?Zexpandable_protor6rrrr>@sR zLayoutsMixin.expandercCs td|S)zGet our DeltaGenerator.r )rrrrrrszLayoutsMixin.dgbeta_containerz 2021-11-02 beta_expander beta_columnsN)F)__name__ __module__ __qualname__r rSpecTyperr rrrr7boolr>propertyrrr@rArBrrrrr s&/o^  r N)typingrrrrrrZstreamlit.deprecation_utilrZstreamlit.errorsr Zstreamlit.proto.Block_pb2r r&Zstreamlit.runtime.metrics_utilr Zstreamlit.delta_generatorr r0r3rFr rrrrs