# st.columns

Source: https://docs.streamlit.io/develop/api-reference/layout/st.columns

* Function signature:

   ```python
   st.columns(spec, *, gap="small", vertical_alignment="top", border=False, width="stretch", wrap=True)
   ```

* Parameters:

   | name | type | default | description |
   |---|---|---|---|
   | spec | int or Iterable of numbers |  | Controls the number and width of columns to insert. Can be one of:  An integer that specifies the number of columns. All columns have equal width in this case. An Iterable of numbers (int or float) that specify the relative width of each column. E.g. [0.7, 0.3] creates two columns where the first one takes up 70% of the available with and the second one takes up 30%. Or [1, 2, 3] creates three columns where the second one is two times the width of the first one, and the third one is three times that width. |
   | gap | "xxsmall", "xsmall", "small", "medium", "large", "xlarge", "xxlarge", int, or None |  | The size of the gap between the columns. This can be one of the following:  "xxsmall": 0.25rem gap between the columns. "xsmall": 0.5rem gap between the columns. "small" (default): 1rem gap between the columns. "medium": 2rem gap between the columns. "large": 4rem gap between the columns. "xlarge": 6rem gap between the columns. "xxlarge": 8rem gap between the columns. A non-negative integer specifying the gap in pixels. For example, gap=20 sets a 20-pixel gap. None: No gap between the columns.  The rem unit is relative to the theme.baseFontSize configuration option. |
   | vertical_alignment | "top", "center", or "bottom" | is | The vertical alignment of the content inside the columns. The default is "top". |
   | border | bool |  | Whether to show a border around the column containers. If this is False (default), no border is shown. If this is True, a border is shown around each column. |
   | width | "stretch" or int |  | The width of the column group. This can be one of the following:  "stretch" (default): The width of the column group matches the width of the parent container. An integer specifying the width in pixels: The column group has a fixed width. If the specified width is greater than the width of the parent container, the width of the column group matches the width of the parent container. |
   | wrap | bool |  | Whether columns may stack vertically on narrow viewports. If this is True (default), columns stack when the viewport is at most 640px wide. If this is False, stacking is disabled and columns stay in a single row. Columns shrink until a usable minimum width, then the column group scrolls horizontally instead of overflowing the page. |

* Returns: list of containers

    A list of container objects.
Type checkers see a fixed-length tuple in either of these cases:

spec is an integer literal from 1 to 6, or a
variable whose type is still that literal.
spec is a tuple of 1 to 6 numbers (int or float),
or a variable with that fixed-length tuple type.

Type checkers then report mismatched unpacking, such as
a, b = st.columns(3) or a, b = st.columns((1, 2, 3)).
Every other spec is a list, including a non-literal integer,
a list of widths, and a tuple longer than 6 or of unknown length.
Streamlit always returns a list, so tuple-only operations are not
valid. To annotate a variable or parameter that holds columns from
any spec, use Sequence[DeltaGenerator].
