streamlit-nightly 1.33.1.dev20240430__py2.py3-none-any.whl → 1.33.1.dev20240501__py2.py3-none-any.whl

streamlit/elements/media.py

@@ -122,10 +122,9 @@ class MediaMixin:
         loop: bool
             Whether the audio should loop playback.
         autoplay: bool
-            Whether the audio should start playing automatically.
-            Browsers will not autoplay audio files if the user has not interacted with
-            the page yet, for example by clicking on the page while it loads.
-            Defaults to False.
+            Whether the audio file should start playing automatically. This is
+            ``False`` by default. Browsers will not autoplay audio files if the
+            user has not interacted with the page by clicking somewhere.
 
         Examples
         --------
@@ -227,7 +226,7 @@ class MediaMixin:
             one of the following:
 
             * ``None`` (default): The element plays from the beginning.
-            * An``int`` or ``float`` specifying the time in seconds. ``float``
+            * An ``int`` or ``float`` specifying the time in seconds. ``float``
               values are rounded down to whole seconds.
             * A string specifying the time in a format supported by `Pandas'
               Timedelta constructor <https://pandas.pydata.org/docs/reference/api/pandas.Timedelta.html>`_,
@@ -275,14 +274,15 @@ class MediaMixin:
         loop: bool
             Whether the video should loop playback.
         autoplay: bool
-            Whether the video should start playing automatically.
-            Browsers will not autoplay video files if the user has not interacted with
-            the page yet, for example by clicking on the page while it loads.
-            To enable autoplay without user interaction, you can set muted=True.
-            Defaults to False.
+            Whether the video should start playing automatically. This is
+            ``False`` by default. Browsers will not autoplay unmuted videos
+            if the user has not interacted with the page by clicking somewhere.
+            To enable autoplay without user interaction, you must also set
+            ``muted=True``.
         muted: bool
-            Whether the video should play with the audio silenced. This can be used to
-            enable autoplay without user interaction. Defaults to False.
+            Whether the video should play with the audio silenced. This is
+            ``False`` by default. Use this in conjunction with ``autoplay=True``
+            to enable autoplay without user interaction.
 
         Example
         -------

streamlit/elements/metric.py

@@ -81,8 +81,10 @@ class MetricMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by

streamlit/elements/progress.py

@@ -119,8 +119,10 @@ class ProgressMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by

streamlit/elements/toast.py

@@ -69,13 +69,27 @@ class ToastMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
-        icon : str or None
-            An optional argument that specifies an emoji to use as
-            the icon for the toast. Shortcodes are not allowed, please use a
-            single character instead. E.g. "🚨", "🔥", "🤖", etc.
-            Defaults to None, which means no icon is displayed.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
+
+        icon : str, None
+            An optional emoji or icon to display next to the alert. 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.
 
         Example
         -------

streamlit/elements/widgets/button.py

@@ -99,8 +99,10 @@ class ButtonMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -140,10 +142,10 @@ class ButtonMixin:
         >>> import streamlit as st
         >>>
         >>> st.button("Reset", type="primary")
-        >>> if st.button('Say hello'):
-        ...     st.write('Why hello there')
+        >>> if st.button("Say hello"):
+        ...     st.write("Why hello there")
         ... else:
-        ...     st.write('Goodbye')
+        ...     st.write("Goodbye")
 
         .. output::
            https://doc-buton.streamlit.app/
@@ -219,8 +221,10 @@ class ButtonMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents)
             render. Display unsupported elements as literal characters by
@@ -278,15 +282,15 @@ class ButtonMixin:
         >>> @st.cache_data
         ... def convert_df(df):
         ...     # IMPORTANT: Cache the conversion to prevent computation on every rerun
-        ...     return df.to_csv().encode('utf-8')
+        ...     return df.to_csv().encode("utf-8")
         >>>
         >>> csv = convert_df(my_large_df)
         >>>
         >>> st.download_button(
         ...     label="Download data as CSV",
         ...     data=csv,
-        ...     file_name='large_df.csv',
-        ...     mime='text/csv',
+        ...     file_name="large_df.csv",
+        ...     mime="text/csv",
         ... )
 
         Download a string as a file:
@@ -294,15 +298,15 @@ class ButtonMixin:
         >>> import streamlit as st
         >>>
         >>> text_contents = '''This is some text'''
-        >>> st.download_button('Download some text', text_contents)
+        >>> st.download_button("Download some text", text_contents)
 
         Download a binary file:
 
         >>> import streamlit as st
         >>>
-        >>> binary_contents = b'example content'
-        >>> # Defaults to 'application/octet-stream'
-        >>> st.download_button('Download binary file', binary_contents)
+        >>> binary_contents = b"example content"
+        >>> # Defaults to "application/octet-stream"
+        >>> st.download_button("Download binary file", binary_contents)
 
         Download an image:
 
@@ -380,8 +384,10 @@ class ButtonMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents)
             render. Display unsupported elements as literal characters by
@@ -473,8 +479,10 @@ class ButtonMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents)
             render. Display unsupported elements as literal characters by

streamlit/elements/widgets/camera_input.py

@@ -114,8 +114,10 @@ class CameraInputMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by

streamlit/elements/widgets/chat.py

@@ -140,18 +140,35 @@ class ChatMixin:
             accessibility label. For accessibility reasons, you should not use
             an empty string.
 
-        avatar : str, numpy.ndarray, or BytesIO
-            The avatar shown next to the message. Can be one of:
+        avatar : Anything supported by st.image, str, or None
+            The avatar shown next to the message.
 
-            * A single emoji, e.g. "🧑‍💻", "🤖", "🦖". Shortcodes are not supported.
+            If ``avatar`` is ``None`` (default), the icon will be determined
+            from ``name`` as follows:
 
-            * An image using one of the formats allowed for ``st.image``: path of a local
-                image file; URL to fetch the image from; an SVG image; array of shape
-                (w,h) or (w,h,1) for a monochrome image, (w,h,3) for a color image,
-                or (w,h,4) for an RGBA image.
+            * If ``name`` is ``"user"`` or ``"human"``, the message will have a
+              default user icon.
 
-            If None (default), uses default icons if ``name`` is "user",
-            "assistant", "ai", "human" or the first letter of the ``name`` value.
+            * If ``name`` is ``"ai"`` or ``"assistant"``, the message will have
+              a default bot icon.
+
+            * For all other values of ``name``, the message will show the first
+              letter of the name.
+
+            In addition to the types supported by ``st.image`` (like URLs or numpy
+            arrays), the following strings are valid:
+
+            * A single-character emoji. For example, you can set ``avatar="🧑‍💻"``
+              or ``avatar="🦖"``. 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.
 
         Returns
         -------

streamlit/elements/widgets/checkbox.py

@@ -88,8 +88,10 @@ class CheckboxMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -132,10 +134,10 @@ class CheckboxMixin:
         -------
         >>> import streamlit as st
         >>>
-        >>> agree = st.checkbox('I agree')
+        >>> agree = st.checkbox("I agree")
         >>>
         >>> if agree:
-        ...     st.write('Great!')
+        ...     st.write("Great!")
 
         .. output::
            https://doc-checkbox.streamlit.app/
@@ -192,8 +194,10 @@ class CheckboxMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -236,10 +240,10 @@ class CheckboxMixin:
         -------
         >>> import streamlit as st
         >>>
-        >>> on = st.toggle('Activate feature')
+        >>> on = st.toggle("Activate feature")
         >>>
         >>> if on:
-        ...     st.write('Feature activated!')
+        ...     st.write("Feature activated!")
 
         .. output::
            https://doc-toggle.streamlit.app/

streamlit/elements/widgets/color_picker.py

@@ -88,8 +88,10 @@ class ColorPickerMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -134,8 +136,8 @@ class ColorPickerMixin:
         -------
         >>> import streamlit as st
         >>>
-        >>> color = st.color_picker('Pick A Color', '#00f900')
-        >>> st.write('The current color is', color)
+        >>> color = st.color_picker("Pick A Color", "#00f900")
+        >>> st.write("The current color is", color)
 
         .. output::
            https://doc-color-picker.streamlit.app/

streamlit/elements/widgets/file_uploader.py

@@ -243,7 +243,7 @@ class FileUploaderMixin:
     ) -> UploadedFile | list[UploadedFile] | None:
         r"""Display a file uploader widget.
         By default, uploaded files are limited to 200MB. You can configure
-        this using the `server.maxUploadSize` config option. For more info
+        this using the ``server.maxUploadSize`` config option. For more info
         on how to set config options, see
         https://docs.streamlit.io/library/advanced-features/configuration#set-configuration-options
 
@@ -266,8 +266,10 @@ class FileUploaderMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by

streamlit/elements/widgets/multiselect.py

@@ -181,8 +181,10 @@ class MultiSelectMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -240,11 +242,11 @@ class MultiSelectMixin:
         >>> import streamlit as st
         >>>
         >>> options = st.multiselect(
-        ...     'What are your favorite colors',
-        ...     ['Green', 'Yellow', 'Red', 'Blue'],
-        ...     ['Yellow', 'Red'])
+        ...     "What are your favorite colors",
+        ...     ["Green", "Yellow", "Red", "Blue"],
+        ...     ["Yellow", "Red"])
         >>>
-        >>> st.write('You selected:', options)
+        >>> st.write("You selected:", options)
 
         .. output::
            https://doc-multiselect.streamlit.app/

streamlit/elements/widgets/number_input.py

@@ -158,8 +158,10 @@ class NumberInputMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -222,8 +224,8 @@ class NumberInputMixin:
         -------
         >>> import streamlit as st
         >>>
-        >>> number = st.number_input('Insert a number')
-        >>> st.write('The current number is ', number)
+        >>> number = st.number_input("Insert a number")
+        >>> st.write("The current number is ", number)
 
         .. output::
            https://doc-number-input.streamlit.app/
@@ -234,7 +236,7 @@ class NumberInputMixin:
         >>> import streamlit as st
         >>>
         >>> number = st.number_input("Insert a number", value=None, placeholder="Type a number...")
-        >>> st.write('The current number is ', number)
+        >>> st.write("The current number is ", number)
 
         .. output::
            https://doc-number-input-empty.streamlit.app/

streamlit/elements/widgets/radio.py

@@ -121,8 +121,10 @@ class RadioMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -189,10 +191,10 @@ class RadioMixin:
         ...     [":rainbow[Comedy]", "***Drama***", "Documentary :movie_camera:"],
         ...     captions = ["Laugh out loud.", "Get the popcorn.", "Never stop learning."])
         >>>
-        >>> if genre == ':rainbow[Comedy]':
-        ...     st.write('You selected comedy.')
+        >>> if genre == ":rainbow[Comedy]":
+        ...     st.write("You selected comedy.")
         ... else:
-        ...     st.write("You didn\'t select comedy.")
+        ...     st.write("You didn't select comedy.")
 
         .. output::
            https://doc-radio.streamlit.app/

streamlit/elements/widgets/select_slider.py

@@ -149,8 +149,10 @@ class SelectSliderMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -207,19 +209,19 @@ class SelectSliderMixin:
         >>> import streamlit as st
         >>>
         >>> color = st.select_slider(
-        ...     'Select a color of the rainbow',
-        ...     options=['red', 'orange', 'yellow', 'green', 'blue', 'indigo', 'violet'])
-        >>> st.write('My favorite color is', color)
+        ...     "Select a color of the rainbow",
+        ...     options=["red", "orange", "yellow", "green", "blue", "indigo", "violet"])
+        >>> st.write("My favorite color is", color)
 
         And here's an example of a range select slider:
 
         >>> import streamlit as st
         >>>
         >>> start_color, end_color = st.select_slider(
-        ...     'Select a range of color wavelength',
-        ...     options=['red', 'orange', 'yellow', 'green', 'blue', 'indigo', 'violet'],
-        ...     value=('red', 'blue'))
-        >>> st.write('You selected wavelengths between', start_color, 'and', end_color)
+        ...     "Select a range of color wavelength",
+        ...     options=["red", "orange", "yellow", "green", "blue", "indigo", "violet"],
+        ...     value=("red", "blue"))
+        >>> st.write("You selected wavelengths between", start_color, "and", end_color)
 
         .. output::
            https://doc-select-slider.streamlit.app/

streamlit/elements/widgets/selectbox.py

@@ -113,8 +113,10 @@ class SelectboxMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -150,7 +152,7 @@ class SelectboxMixin:
             An optional dict of kwargs to pass to the callback.
         placeholder : str
             A string to display when no options are selected.
-            Defaults to 'Choose an option'.
+            Defaults to "Choose an option".
         disabled : bool
             An optional boolean, which disables the selectbox if set to True.
             The default is False.
@@ -170,10 +172,10 @@ class SelectboxMixin:
         >>> import streamlit as st
         >>>
         >>> option = st.selectbox(
-        ...     'How would you like to be contacted?',
-        ...     ('Email', 'Home phone', 'Mobile phone'))
+        ...     "How would you like to be contacted?",
+        ...     ("Email", "Home phone", "Mobile phone"))
         >>>
-        >>> st.write('You selected:', option)
+        >>> st.write("You selected:", option)
 
         .. output::
            https://doc-selectbox.streamlit.app/
@@ -190,7 +192,7 @@ class SelectboxMixin:
         ...    placeholder="Select contact method...",
         ... )
         >>>
-        >>> st.write('You selected:', option)
+        >>> st.write("You selected:", option)
 
         .. output::
            https://doc-selectbox-empty.streamlit.app/

streamlit/elements/widgets/slider.py

@@ -191,11 +191,11 @@ class SliderMixin:
         This supports int, float, date, time, and datetime types.
 
         This also allows you to render a range slider by passing a two-element
-        tuple or list as the `value`.
+        tuple or list as the ``value``.
 
-        The difference between `st.slider` and `st.select_slider` is that
-        `slider` only accepts numerical or date/time data and takes a range as
-        input, while `select_slider` accepts any datatype and takes an iterable
+        The difference between ``st.slider`` and ``st.select_slider`` is that
+        ``slider`` only accepts numerical or date/time data and takes a range as
+        input, while ``select_slider`` accepts any datatype and takes an iterable
         set of options.
 
         .. note::
@@ -223,8 +223,10 @@ class SliderMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -291,17 +293,17 @@ class SliderMixin:
         --------
         >>> import streamlit as st
         >>>
-        >>> age = st.slider('How old are you?', 0, 130, 25)
-        >>> st.write("I'm ", age, 'years old')
+        >>> age = st.slider("How old are you?", 0, 130, 25)
+        >>> st.write("I'm ", age, "years old")
 
         And here's an example of a range slider:
 
         >>> import streamlit as st
         >>>
         >>> values = st.slider(
-        ...     'Select a range of values',
+        ...     "Select a range of values",
         ...     0.0, 100.0, (25.0, 75.0))
-        >>> st.write('Values:', values)
+        >>> st.write("Values:", values)
 
         This is a range time slider:
 

streamlit/elements/widgets/text_widgets.py

@@ -152,8 +152,10 @@ class TextWidgetsMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -212,8 +214,8 @@ class TextWidgetsMixin:
         -------
         >>> import streamlit as st
         >>>
-        >>> title = st.text_input('Movie title', 'Life of Brian')
-        >>> st.write('The current movie title is', title)
+        >>> title = st.text_input("Movie title", "Life of Brian")
+        >>> st.write("The current movie title is", title)
 
         .. output::
            https://doc-text-input.streamlit.app/
@@ -418,8 +420,10 @@ class TextWidgetsMixin:
 
             * Colored text and background colors for text, using the syntax
               ``:color[text to be colored]`` and ``:color-background[text to be colored]``,
-              respectively — where ``color`` needs to be replaced with any of the following
+              respectively. ``color`` must be replaced with any of the following
               supported colors: blue, green, orange, red, violet, gray/grey, rainbow.
+              For example, you can use ``:orange[your text here]`` or
+              ``:blue-background[your text here]``.
 
             Unsupported elements are unwrapped so only their children (text contents) render.
             Display unsupported elements as literal characters by
@@ -481,7 +485,7 @@ class TextWidgetsMixin:
         ...     "despair, (...)",
         ...     )
         >>>
-        >>> st.write(f'You wrote {len(txt)} characters.')
+        >>> st.write(f"You wrote {len(txt)} characters.")
 
         .. output::
            https://doc-text-area.streamlit.app/