mxihpddlmZddlmZmZddlmZmZmZddl m Z ddl m Z erddlmZGddZy ) ) annotations) TYPE_CHECKINGcast) LayoutConfig SpaceSizevalidate_space_size)Space)gather_metrics)DeltaGeneratorcFeZdZed d ddZeddZy) SpaceMixinspacect}t|t||}|jj d||S)a Add vertical or horizontal space. This command adds space in the direction of its parent container. In a vertical layout, it adds vertical space. In a horizontal layout, it adds horizontal space. Parameters ---------- size : "xxsmall", "xsmall", "small", "medium", "large", "xlarge", "xxlarge", "stretch", or int The size of the space. This can be one of the following values: - ``"xxsmall"``: 0.25rem, matching the ``"xxsmall"`` gap in ``st.container`` and ``st.columns``. - ``"xsmall"``: 0.5rem, matching the ``"xsmall"`` gap in ``st.container`` and ``st.columns``. - ``"small"`` (default): 0.75rem, which is the height of a widget label. This is useful for aligning buttons with labeled widgets. - ``"medium"``: 2.5rem, which is the height of a button or (unlabeled) input field. - ``"large"``: 4.25rem, which is the height of a labeled input field or unlabeled media widget, like ``st.file_uploader``. - ``"xlarge"``: 6rem, matching the ``"xlarge"`` gap in ``st.container`` and ``st.columns``. - ``"xxlarge"``: 8rem, matching the ``"xxlarge"`` gap in ``st.container`` and ``st.columns``. - ``"stretch"``: Expands to fill remaining space in the container. - An integer: Fixed size in pixels. Examples -------- **Example 1: Use vertical space to align elements** Use small spaces to replace label heights. Use medium spaces to replace two label heights or a button. >>> import streamlit as st >>> >>> left, middle, right = st.columns(3) >>> >>> left.space("medium") >>> left.button("Left button", width="stretch") >>> >>> middle.space("small") >>> middle.text_input("Middle input") >>> >>> right.audio_input("Right uploader") .. output:: https://doc-space-vertical.streamlit.app/ height: 260px **Example 2: Add horizontal space in a container** Use stretch space to float elements left and right. >>> import streamlit as st >>> >>> with st.container(horizontal=True): ... st.button("Left") ... st.space("stretch") ... st.button("Right") .. output:: https://doc-space-horizontal.streamlit.app/ height: 200px )widthheightr) layout_config) SpaceProtorrdg_enqueue)selfsize space_protors O/home/htdocs/ttos/venv/lib/python3.12/site-packages/streamlit/elements/space.pyrzSpaceMixin.space s>P!l D!%4= wwMRRctd|S)zGet our DeltaGenerator.r )r)rs rrz SpaceMixin.dgvs$d++rN)small)rrreturnr )rr )__name__ __module__ __qualname__r rpropertyrrrr r sMG"SSSS SSSSj,,rr N) __future__rtypingrr#streamlit.elements.lib.layout_utilsrrrstreamlit.proto.Space_pb2r rstreamlit.runtime.metrics_utilr streamlit.delta_generatorr r r"rrr)s1#& :98Z,Z,r