streamlit-nightly 1.35.1.dev20240612__tar.gz → 1.35.1.dev20240614__tar.gz

{streamlit_nightly-1.35.1.dev20240612/streamlit_nightly.egg-info → streamlit_nightly-1.35.1.dev20240614}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: streamlit-nightly
-Version: 1.35.1.dev20240612
+Version: 1.35.1.dev20240614
 Summary: A faster way to build and share data apps
 Home-page: https://streamlit.io
 Author: Snowflake Inc
@@ -8,7 +8,7 @@ Author-email: hello@streamlit.io
 License: Apache License 2.0
 Project-URL: Source Code, https://github.com/streamlit/streamlit
 Project-URL: Bug Tracker, https://github.com/streamlit/streamlit/issues
-Project-URL: Release notes, https://docs.streamlit.io/library/changelog
+Project-URL: Release notes, https://docs.streamlit.io/develop/quick-reference/changelog
 Project-URL: Documentation, https://docs.streamlit.io/
 Project-URL: Community, https://discuss.streamlit.io/
 Project-URL: Twitter, https://twitter.com/streamlit
@@ -82,7 +82,7 @@ $ pip install streamlit
 $ streamlit hello
 ```
 
-If this opens our sweet _Streamlit Hello_ app in your browser, you're all set! If not, head over to [our docs](https://docs.streamlit.io/library/get-started) for specific installs.
+If this opens our sweet _Streamlit Hello_ app in your browser, you're all set! If not, head over to [our docs](https://docs.streamlit.io/get-started) for specific installs.
 
 The app features a bunch of examples of what you can do with Streamlit. Jump to the [quickstart](#quickstart) section to understand how that all works.
 
@@ -108,32 +108,32 @@ $ streamlit run streamlit_app.py
 
 ### Give me more!
 
-Streamlit comes in with [a ton of additional powerful elements](https://docs.streamlit.io/library/api-reference) to spice up your data apps and delight your viewers. Some examples:
+Streamlit comes in with [a ton of additional powerful elements](https://docs.streamlit.io/develop/api-reference) to spice up your data apps and delight your viewers. Some examples:
 
 <table border="0">
   <tr>
     <td>
-      <a target="_blank" href="https://docs.streamlit.io/library/api-reference/widgets">
+      <a target="_blank" href="https://docs.streamlit.io/develop/api-reference/widgets">
         <img src="https://user-images.githubusercontent.com/7164864/217936099-12c16f8c-7fe4-44b1-889a-1ac9ee6a1b44.png" style="max-height:150px; width:auto; display:block;">
       </a>
     </td>
     <td>
-      <a target="_blank" href="https://docs.streamlit.io/library/api-reference/data/st.dataframe">
+      <a target="_blank" href="https://docs.streamlit.io/develop/api-reference/data/st.dataframe">
         <img src="https://user-images.githubusercontent.com/7164864/215110064-5eb4e294-8f30-4933-9563-0275230e52b5.gif" style="max-height:150px; width:auto; display:block;">
       </a>
     </td>
     <td>
-      <a target="_blank" href="https://docs.streamlit.io/library/api-reference/charts">
+      <a target="_blank" href="https://docs.streamlit.io/develop/api-reference/charts">
         <img src="https://user-images.githubusercontent.com/7164864/215174472-bca8a0d7-cf4b-4268-9c3b-8c03dad50bcd.gif" style="max-height:150px; width:auto; display:block;">
       </a>
     </td>
     <td>
-      <a target="_blank" href="https://docs.streamlit.io/library/api-reference/layout">
+      <a target="_blank" href="https://docs.streamlit.io/develop/api-reference/layout">
         <img src="https://user-images.githubusercontent.com/7164864/217936149-a35c35be-0d96-4c63-8c6a-1c4b52aa8f60.png" style="max-height:150px; width:auto; display:block;">
       </a>
     </td>
     <td>
-      <a target="_blank" href="https://docs.streamlit.io/library/get-started/multipage-apps">
+      <a target="_blank" href="https://docs.streamlit.io/develop/concepts/multipage-apps">
         <img src="https://user-images.githubusercontent.com/7164864/215173883-eae0de69-7c1d-4d78-97d0-3bc1ab865e5b.gif" style="max-height:150px; width:auto; display:block;">
       </a>
     </td>

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/setup.py

@@ -21,7 +21,7 @@ from setuptools.command.install import install
 
 THIS_DIRECTORY = Path(__file__).parent
 
-VERSION = "1.35.1.dev20240612"  # PEP-440
+VERSION = "1.35.1.dev20240614"  # PEP-440
 
 # IMPORTANT: We should try very hard *not* to add dependencies to Streamlit.
 # And if you do add one, make the required version as general as possible:
@@ -110,7 +110,7 @@ setup(
     project_urls={
         "Source Code": "https://github.com/streamlit/streamlit",
         "Bug Tracker": "https://github.com/streamlit/streamlit/issues",
-        "Release notes": "https://docs.streamlit.io/library/changelog",
+        "Release notes": "https://docs.streamlit.io/develop/quick-reference/changelog",
         "Documentation": "https://docs.streamlit.io/",
         "Community": "https://discuss.streamlit.io/",
         "Twitter": "https://twitter.com/streamlit",

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/streamlit/__init__.py

@@ -244,7 +244,7 @@ experimental_singleton = _experimental_singleton
 experimental_user = _UserInfoProxy()
 
 
-_EXPERIMENTAL_QUERY_PARAMS_DEPRECATE_MSG = "Refer to our [docs page](https://docs.streamlit.io/library/api-reference/utilities/st.query_params) for more information."
+_EXPERIMENTAL_QUERY_PARAMS_DEPRECATE_MSG = "Refer to our [docs page](https://docs.streamlit.io/develop/api-reference/caching-and-state/st.query_params) for more information."
 
 experimental_get_query_params = _deprecate_func_name(
     _get_query_params,

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/streamlit/commands/navigation.py

@@ -61,37 +61,103 @@ def navigation(
     """
     Configure the available pages in a multipage app.
 
-    Call `st.navigation` in your main script with one or more pages defined by
-    `st.Page`. `st.navigation` returns the current page which can be executed
-    using `Page.run()`.
+    Call ``st.navigation`` in your entrypoint file with one or more pages
+    defined by ``st.Page``. ``st.navigation`` returns the current page, which
+    can be executed using ``.run()`` method.
 
-    When using `st.navigation`, the main script is executed on every app rerun,
-    with the current page executed in-line using `Page.run()`. The set of
-    available pages can be updated with each rerun for dynamic navigation. In
-    this mode, the `pages/` folder is ignored.
+    When using ``st.navigation``, your entrypoint file (the file passed to
+    ``streamlit run``) acts like a router or frame of common elements around
+    each of your pages. Streamlit executes the entrypoint file with every app
+    rerun. To execute the current page, you must call the ``.run()`` method on
+    the page object returned by ``st.navigation``.
 
-    By default, `st.navigation` draws the available pages in the side
-    navigation. This behavior can be changed using the `position=` keyword
-    argument.
+    The set of available pages can be updated with each rerun for dynamic
+    navigation. By default, ``st.navigation`` draws the available pages in the
+    side navigation if there is more than one page. This behavior can be
+    changed using the ``position`` keyword argument.
+
+    As soon as any session of your app executes the ``st.navigation`` command,
+    your app will ignore the ``pages/`` directory (across all sessions).
 
     Parameters
     ----------
-    pages: list[st.Page] or dict[str, list[st.Page]]
-        A list of `st.Page` objects or a dictionary where the keys are section
-        headers and the values are lists of `st.Page` objects.
+    pages: list[StreamlitPage] or dict[str, list[StreamlitPage]]
+        The available pages for the app.
+
+        To create labeled sections or page groupings within the navigation
+        menu, ``pages`` must be a dictionary. Each key is the label of a
+        section and each value is the list of ``StreamlitPage`` objects for
+        that section.
+
+        To create a navigation menu with no sections or page groupings,
+        ``pages`` must be a list of ``StreamlitPage`` objects.
+
+        Use ``st.Page`` to create ``StreamlitPage`` objects.
 
     position: "sidebar" or "hidden"
-        The position of the navigation menu. Can be "sidebar" or "hidden".
+        The position of the navigation menu. If ``position`` is ``"sidebar"``
+        (default), the navigation widget appears at the top of the sidebar. If
+        ``position`` is ``"hidden"``, the navigation widget is not displayed.
+
+        If there is only one page in ``pages``, the navigation will be hidden
+        for any value of ``position``.
 
-    Example
+    Returns
     -------
+    StreamlitPage
+        The current page selected by the user.
+
+    Examples
+    --------
+    The following examples show possible entrypoint files, which is the file
+    you pass to ``streamlit run``. Your entrypoint file manages your app's
+    navigation and serves as a router between pages.
+
+    You can declare pages from callables or file paths.
+
+    >>> import streamlit as st
+    >>> from page_functions import page1
+    >>>
+    >>> pg = st.navigation([st.Page(page1), st.Page("page2.py")])
+    >>> pg.run()
+
+    Use a dictionary to create sections within your navigation menu.
+
     >>> import streamlit as st
-    >>> from pages import page1, page2
     >>>
-    >>>	pg = st.navigation([st.Page(page1), st.Page(page2)])
+    >>> pages = {
+    ...     "Your account" : [
+    ...         st.Page("create_account.py", title="Create your account"),
+    ...         st.Page("manage_account.py", title="Manage your account")
+    ...     ],
+    ...     "Resources" : [
+    ...         st.Page("learn.py", title="Learn about us"),
+    ...         st.Page("trial.py", title="Try it out")
+    ...     ]
+    ... }
     >>>
-    >>>	st.title("My Awesome App")
+    >>> pg = st.navigation(pages)
     >>> pg.run()
+
+    Call widget functions in your entrypoint file when you want a widget to be
+    stateful across pages. Assign keys to your common widgets and access their
+    values through Session State within your pages.
+
+    >>> import streamlit as st
+    >>>
+    >>> def page1():
+    >>>     st.write(st.session_state.foo)
+    >>>
+    >>> def page2():
+    >>>     st.write(st.session_state.bar)
+    >>>
+    >>> # Widgets shared by all the pages
+    >>> st.sidebar.selectbox("Foo", ["A", "B", "C"], key="foo")
+    >>> st.sidebar.checkbox("Bar", key="bar")
+    >>>
+    >>> pg = st.navigation(st.Page(page1), st.Page(page2))
+    >>> pg.run()
+
     """
     nav_sections = {"": pages} if isinstance(pages, list) else pages
     page_list = pages_from_nav_sections(nav_sections)

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/streamlit/components/v1/component_registry.py

@@ -52,25 +52,40 @@ def declare_component(
     path: str | None = None,
     url: str | None = None,
 ) -> CustomComponent:
-    """Create a custom component and register it if there is a ScriptRun context.
+    """Create a custom component and register it if there is a ``ScriptRunContext``.
 
-    The component is not registered when there is no ScriptRun context; this can happen when CustomComponents are executed as standalone commands, e.g. for testing.
+    The component is not registered when there is no ``ScriptRunContext``.
+    This can happen when a ``CustomComponent`` is executed as standalone
+    command (e.g. for testing).
+
+    To use this function, import it from the ``streamlit.components.v1``
+    module.
+
+    .. warning::
+        Using ``st.components.v1.declare_component`` directly (instead of
+        importing its module) is deprecated and will be disallowd in a later
+        version.
 
     Parameters
     ----------
-    name: str
-        A short, descriptive name for the component. Like, "slider".
+    name : str
+        A short, descriptive name for the component, like "slider".
+
     path: str or None
-        The path to serve the component's frontend files from. Either
-        `path` or `url` must be specified, but not both.
+        The path to serve the component's frontend files from. If ``path`` is
+        ``None`` (default), Streamlit will server the component from the
+        location in ``url``. Either ``path`` or ``url`` must be specified, but
+        not both.
+
     url: str or None
-        The URL that the component is served from. Either `path` or `url`
-        must be specified, but not both.
+        The URL that the component is served from. If ``url`` is ``None``
+        (default), Streamlit will server the component from the location in
+        ``path``. Either ``path`` or ``url`` must be specified, but not both.
 
     Returns
     -------
     CustomComponent
-        A CustomComponent that can be called like a function.
+        A ``CustomComponent`` that can be called like a function.
         Calling the component will create a new instance of the component
         in the Streamlit app.
 

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/streamlit/config.py

@@ -465,9 +465,6 @@ _create_option(
     visibility="hidden",
     type_=bool,
     scriptable=True,
-    deprecated=True,
-    deprecation_text="logger.enableRich has been deprecated and will be removed in a future version. Exception formatting via rich will be automatically used if rich is enable.",
-    expiration_date="2024-09-10",
 )
 
 # Config Section: Client #

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/streamlit/elements/arrow.py

@@ -95,12 +95,19 @@ class DataframeSelectionState(TypedDict, total=False):
     key and attribute notation. Selection states cannot be programmatically
     changed or set through Session State.
 
+    .. warning::
+        If a user sorts a dataframe, row selections will be reset. If your
+        users need to sort and filter the dataframe to make selections, direct
+        them to use the search function in the dataframe toolbar instead.
+
     Attributes
     ----------
     rows : list[int]
-        The selected rows, identified by their positional index. The positional
-        indices match the original dataframe, even if the user sorts the
-        dataframe in their browser.
+        The selected rows, identified by their integer position. The integer
+        positions match the original dataframe, even if the user sorts the
+        dataframe in their browser. For a ``pandas.DataFrame``, you can
+        retrieve data from its interger position using methods like ``.iloc[]``
+        or ``.iat[]``.
     columns : list[str]
         The selected columns, identified by their names.
 
@@ -150,8 +157,12 @@ class DataframeState(TypedDict, total=False):
 
     Attributes
     ----------
-    selection : DataframeSelectionState
-        The state of the ``on_select`` event.
+    selection : dict
+        The state of the ``on_select`` event. This attribure returns a
+        dictionary-like object that supports both key and attribute notation.
+        The attributes are described by the ``DataframeSelectionState``
+        dictionary schema.
+
 
     """
 
@@ -346,7 +357,7 @@ class ArrowMixin:
               to change the displayed name of the column to "Dollar values"
               and add a "$" prefix in each cell. For more info on the
               available column types and config options, see
-              `Column configuration <https://docs.streamlit.io/library/api-reference/data/st.column_config>`_.
+              `Column configuration <https://docs.streamlit.io/develop/api-reference/data/st.column_config>`_.
 
             To configure the index column(s), use ``_index`` as the column name.
 

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/streamlit/elements/deck_gl_json_chart.py

@@ -66,7 +66,7 @@ class PydeckMixin:
 
         To get a token for yourself, create an account at https://mapbox.com.
         For more info on how to set config options, see
-        https://docs.streamlit.io/library/advanced-features/configuration
+        https://docs.streamlit.io/develop/api-reference/configuration/config.toml.
 
         Parameters
         ----------

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/streamlit/elements/dialog_decorator.py

@@ -127,9 +127,11 @@ def dialog_decorator(
     handling any side effects of that behavior.
 
     .. warning::
-        A dialog may not open another dialog. Only one dialog function may be
-        called in a script run, which means that only one dialog can be open at
-        any given time.
+        Only one dialog function may be called in a script run, which means
+        that only one dialog can be open at any given time. Since a dialog is
+        also a fragment, all fragment limitations apply. Dialogs can't contain
+        fragments, and fragments can't contain dialogs. Using dialogs in widget
+        callback functions is not supported.
 
     .. |st.experimental_fragment| replace:: ``st.experimental_fragment``
     .. _st.experimental_fragment: https://docs.streamlit.io/develop/api-reference/execution-flow/st.fragment

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/streamlit/elements/html.py

@@ -57,15 +57,7 @@ class HtmlMixin:
         -------
         >>> import streamlit as st
         >>>
-        >>> code = \"""
-        ... <style>
-        ...     p {
-        ...         color: red;
-        ...     }
-        ... </style>
-        ... \"""
-        >>> st.html(code)
-        >>> st.markdown("Lorem ipsum")
+        >>> st.html("<p><span style='text-decoration: line-through double red;'>Oops</span>!</p>")
 
         .. output::
            https://doc-html.streamlit.app/

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/streamlit/elements/iframe.py

@@ -34,18 +34,37 @@ class IframeMixin:
     ) -> DeltaGenerator:
         """Load a remote URL in an iframe.
 
+        To use this function, import it from the ``streamlit.components.v1``
+        module.
+
+        .. warning::
+            Using ``st.components.v1.iframe`` directly (instead of importing
+            its module) is deprecated and will be disallowd in a later version.
+
         Parameters
         ----------
         src : str
             The URL of the page to embed.
+
         width : int
-            The width of the frame in CSS pixels. Defaults to the app's
-            default element width.
+            The width of the iframe in CSS pixels. By default, this is the
+            app's default element width.
+
         height : int
-            The height of the frame in CSS pixels. Defaults to 150.
+            The height of the frame in CSS pixels. By default, this is ``150``.
+
         scrolling : bool
-            If True, show a scrollbar when the content is larger than the iframe.
-            Otherwise, do not show a scrollbar. Defaults to False.
+            Whether to allow scrolling in the iframe. If this ``False``
+            (default), Streamlit crops any content larger than the iframe and
+            does not show a scrollbar. If this is ``True``, Streamlit shows a
+            scrollbar when the content is larger than the iframe.
+
+        Example
+        -------
+
+        >>> import streamlit.components.v1 as components
+        >>>
+        >>> components.iframe("https://example.com", height=500)
 
         """
         iframe_proto = IFrameProto()
@@ -68,18 +87,42 @@ class IframeMixin:
     ) -> DeltaGenerator:
         """Display an HTML string in an iframe.
 
+        To use this function, import it from the ``streamlit.components.v1``
+        module.
+
+        If you want to insert HTML text into your app without an iframe, try
+        ``st.html`` instead.
+
+        .. warning::
+            Using ``st.components.v1.html`` directly (instead of importing
+            its module) is deprecated and will be disallowd in a later version.
+
         Parameters
         ----------
         html : str
             The HTML string to embed in the iframe.
+
         width : int
-            The width of the frame in CSS pixels. Defaults to the app's
-            default element width.
+            The width of the iframe in CSS pixels. By default, this is the
+            app's default element width.
+
         height : int
-            The height of the frame in CSS pixels. Defaults to 150.
+            The height of the frame in CSS pixels. By default, this is ``150``.
+
         scrolling : bool
-            If True, show a scrollbar when the content is larger than the iframe.
-            Otherwise, do not show a scrollbar. Defaults to False.
+            Whether to allow scrolling in the iframe. If this ``False``
+            (default), Streamlit crops any content larger than the iframe and
+            does not show a scrollbar. If this is ``True``, Streamlit shows a
+            scrollbar when the content is larger than the iframe.
+
+        Example
+        -------
+
+        >>> import streamlit.components.v1 as components
+        >>>
+        >>> components.html(
+        >>>     "<p><span style='text-decoration: line-through double red;'>Oops</span>!</p>"
+        >>> )
 
         """
         iframe_proto = IFrameProto()

{streamlit_nightly-1.35.1.dev20240612 → streamlit_nightly-1.35.1.dev20240614}/streamlit/elements/layouts.py

@@ -21,6 +21,7 @@ from typing_extensions import TypeAlias
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.Block_pb2 import Block as BlockProto
 from streamlit.runtime.metrics_util import gather_metrics
+from streamlit.string_util import validate_icon_or_emoji
 
 if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator
@@ -163,7 +164,8 @@ class LayoutsMixin:
         Columns can only be placed inside other columns up to one level of nesting.
 
         .. warning::
-            Columns cannot be placed inside other columns in the sidebar. This is only possible in the main area of the app.
+            Columns cannot be placed inside other columns in the sidebar. This
+            is only possible in the main area of the app.
 
         Parameters
         ----------
@@ -179,10 +181,11 @@ class LayoutsMixin:
               the width of the first one, and the third one is three times that width.
 
         gap : "small", "medium", or "large"
-            The size of the gap between the columns. Defaults to "small".
+            The size of the gap between the columns. The default is ``"small"``.
 
         vertical_alignment : "top", "center", or "bottom"
-            The vertical alignment of the content inside the columns. Defaults to "top".
+            The vertical alignment of the content inside the columns. The
+            default is ``"top"``.
 
         Returns
         -------
@@ -231,6 +234,38 @@ class LayoutsMixin:
             https://doc-columns2.streamlit.app/
             height: 550px
 
+        Use ``vertical_alignment="bottom"`` to align widgets.
+
+        >>> import streamlit as st
+        >>>
+        >>> left, middle, right = st.columns(3, vertical_alignment="bottom")
+        >>>
+        >>> left.text_input("Write something")
+        >>> middle.button("Click me", use_container_width=True)
+        >>> right.checkbox("Check me")
+
+        .. output ::
+            https://doc-columns-bottom-widgets.streamlit.app/
+            height: 200px
+
+        Adjust vertical alignment to customize your grid layouts.
+
+        >>> import streamlit as st
+        >>> import numpy as np
+        >>>
+        >>> vertical_alignment = st.selectbox(
+        >>>     "Vertical alignment", ["top", "center", "bottom"], index=2
+        >>> )
+        >>>
+        >>> left, middle, right = st.columns(3, vertical_alignment=vertical_alignment)
+        >>> left.image("https://static.streamlit.io/examples/cat.jpg")
+        >>> middle.image("https://static.streamlit.io/examples/dog.jpg")
+        >>> right.image("https://static.streamlit.io/examples/owl.jpg")
+
+        .. output ::
+            https://doc-columns-vertical-alignment.streamlit.app/
+            height: 600px
+
         """
         weights = spec
         if isinstance(weights, int):
@@ -243,7 +278,7 @@ class LayoutsMixin:
             raise StreamlitAPIException(
                 "The 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) "
+                "See [documentation](https://docs.streamlit.io/develop/api-reference/layout/st.columns) "
                 "for more information."
             )
 
@@ -408,7 +443,13 @@ class LayoutsMixin:
         return tuple(tab_container._block(tab_proto(tab_label)) for tab_label in tabs)
 
     @gather_metrics("expander")
-    def expander(self, label: str, expanded: bool = False) -> DeltaGenerator:
+    def expander(
+        self,
+        label: str,
+        expanded: bool = False,
+        *,
+        icon: str | None = None,
+    ) -> DeltaGenerator:
         r"""Insert a multi-element container that can be expanded/collapsed.
 
         Inserts a container into your app that can be used to hold multiple elements
@@ -449,10 +490,28 @@ class LayoutsMixin:
             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).
 
+        icon : str, None
+            An optional emoji or icon to display next to the expander label. If ``icon``
+            is ``None`` (default), no icon is displayed. If ``icon`` is a
+            string, the following options are valid:
+
+            * A single-character emoji. For example, you can set ``icon="🚨"``
+              or ``icon="🔥"``. Emoji short codes are not supported.
+
+            * An icon from the Material Symbols library (outlined style) in the
+              format ``":material/icon_name:"`` where "icon_name" is the name
+              of the icon in snake case.
+
+              For example, ``icon=":material/thumb_up:"`` will display the
+              Thumb Up icon. Find additional icons in the `Material Symbols \
+              <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Outlined>`_
+              font library.
+
         Examples
         --------
         You can use the ``with`` notation to insert any element into an expander
@@ -498,6 +557,8 @@ class LayoutsMixin:
         expandable_proto = BlockProto.Expandable()
         expandable_proto.expanded = expanded
         expandable_proto.label = label
+        if icon is not None:
+            expandable_proto.icon = validate_icon_or_emoji(icon)
 
         block_proto = BlockProto()
         block_proto.allow_empty = False