streamlit-nightly 1.37.2.dev20240822__py2.py3-none-any.whl → 1.37.2.dev20240824__py2.py3-none-any.whl

streamlit/elements/widgets/button.py

@@ -86,6 +86,7 @@ class ButtonMixin:
         kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
         type: Literal["primary", "secondary"] = "secondary",
+        icon: str | None = None,
         disabled: bool = False,
         use_container_width: bool = False,
     ) -> bool:
@@ -134,6 +135,23 @@ class ButtonMixin:
             button with additional emphasis or "secondary" for a normal button. Defaults
             to "secondary".
 
+        icon : str or None
+            An optional emoji or icon to display next to the button 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 (rounded 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=Rounded>`_
+              font library.
+
         disabled : bool
             An optional boolean, which disables the button if set to True. The
             default is False.
@@ -188,6 +206,7 @@ class ButtonMixin:
             kwargs=kwargs,
             disabled=disabled,
             type=type,
+            icon=icon,
             use_container_width=use_container_width,
             ctx=ctx,
         )
@@ -761,6 +780,7 @@ class ButtonMixin:
         kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
         type: Literal["primary", "secondary"] = "secondary",
+        icon: str | None = None,
         disabled: bool = False,
         use_container_width: bool = False,
         ctx: ScriptRunContext | None = None,
@@ -780,6 +800,7 @@ class ButtonMixin:
             "button",
             user_key=key,
             label=label,
+            icon=icon,
             key=key,
             help=help,
             is_form_submitter=is_form_submitter,
@@ -816,6 +837,9 @@ class ButtonMixin:
         if help is not None:
             button_proto.help = dedent(help)
 
+        if icon is not None:
+            button_proto.icon = validate_icon_or_emoji(icon)
+
         serde = ButtonSerde()
 
         button_state = register_widget(

streamlit/proto/Button_pb2.py

@@ -14,7 +14,7 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1cstreamlit/proto/Button.proto\"\xab\x01\n\x06\x42utton\x12\n\n\x02id\x18\x01 \x01(\t\x12\r\n\x05label\x18\x02 \x01(\t\x12\x0f\n\x07\x64\x65\x66\x61ult\x18\x03 \x01(\x08\x12\x0c\n\x04help\x18\x04 \x01(\t\x12\x0f\n\x07\x66orm_id\x18\x05 \x01(\t\x12\x19\n\x11is_form_submitter\x18\x06 \x01(\x08\x12\x0c\n\x04type\x18\x07 \x01(\t\x12\x10\n\x08\x64isabled\x18\x08 \x01(\x08\x12\x1b\n\x13use_container_width\x18\t \x01(\x08\x42+\n\x1c\x63om.snowflake.apps.streamlitB\x0b\x42uttonProtob\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1cstreamlit/proto/Button.proto\"\xb9\x01\n\x06\x42utton\x12\n\n\x02id\x18\x01 \x01(\t\x12\r\n\x05label\x18\x02 \x01(\t\x12\x0f\n\x07\x64\x65\x66\x61ult\x18\x03 \x01(\x08\x12\x0c\n\x04help\x18\x04 \x01(\t\x12\x0f\n\x07\x66orm_id\x18\x05 \x01(\t\x12\x19\n\x11is_form_submitter\x18\x06 \x01(\x08\x12\x0c\n\x04type\x18\x07 \x01(\t\x12\x10\n\x08\x64isabled\x18\x08 \x01(\x08\x12\x1b\n\x13use_container_width\x18\t \x01(\x08\x12\x0c\n\x04icon\x18\n \x01(\tB+\n\x1c\x63om.snowflake.apps.streamlitB\x0b\x42uttonProtob\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -23,5 +23,5 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
   _globals['DESCRIPTOR']._serialized_options = b'\n\034com.snowflake.apps.streamlitB\013ButtonProto'
   _globals['_BUTTON']._serialized_start=33
-  _globals['_BUTTON']._serialized_end=204
+  _globals['_BUTTON']._serialized_end=218
 # @@protoc_insertion_point(module_scope)

streamlit/proto/Button_pb2.pyi

@@ -37,6 +37,7 @@ class Button(google.protobuf.message.Message):
     TYPE_FIELD_NUMBER: builtins.int
     DISABLED_FIELD_NUMBER: builtins.int
     USE_CONTAINER_WIDTH_FIELD_NUMBER: builtins.int
+    ICON_FIELD_NUMBER: builtins.int
     id: builtins.str
     label: builtins.str
     default: builtins.bool
@@ -50,6 +51,7 @@ class Button(google.protobuf.message.Message):
     type: builtins.str
     disabled: builtins.bool
     use_container_width: builtins.bool
+    icon: builtins.str
     def __init__(
         self,
         *,
@@ -62,7 +64,8 @@ class Button(google.protobuf.message.Message):
         type: builtins.str = ...,
         disabled: builtins.bool = ...,
         use_container_width: builtins.bool = ...,
+        icon: builtins.str = ...,
     ) -> None: ...
-    def ClearField(self, field_name: typing.Literal["default", b"default", "disabled", b"disabled", "form_id", b"form_id", "help", b"help", "id", b"id", "is_form_submitter", b"is_form_submitter", "label", b"label", "type", b"type", "use_container_width", b"use_container_width"]) -> None: ...
+    def ClearField(self, field_name: typing.Literal["default", b"default", "disabled", b"disabled", "form_id", b"form_id", "help", b"help", "icon", b"icon", "id", b"id", "is_form_submitter", b"is_form_submitter", "label", b"label", "type", b"type", "use_container_width", b"use_container_width"]) -> None: ...
 
 global___Button = Button

streamlit/static/asset-manifest.json

@@ -1,7 +1,7 @@
 {
   "files": {
     "main.css": "./static/css/main.5513bd04.css",
-    "main.js": "./static/js/main.33cac65c.js",
+    "main.js": "./static/js/main.771fbdca.js",
     "static/js/9336.3e046ad7.chunk.js": "./static/js/9336.3e046ad7.chunk.js",
     "static/js/9330.32e8a53a.chunk.js": "./static/js/9330.32e8a53a.chunk.js",
     "static/js/2736.3d50ec7f.chunk.js": "./static/js/2736.3d50ec7f.chunk.js",
@@ -20,7 +20,7 @@
     "static/js/4113.786b0142.chunk.js": "./static/js/4113.786b0142.chunk.js",
     "static/js/1168.7c30158a.chunk.js": "./static/js/1168.7c30158a.chunk.js",
     "static/js/178.ddebe26b.chunk.js": "./static/js/178.ddebe26b.chunk.js",
-    "static/js/1792.d126bbd9.chunk.js": "./static/js/1792.d126bbd9.chunk.js",
+    "static/js/1792.61097259.chunk.js": "./static/js/1792.61097259.chunk.js",
     "static/js/1116.85ec79d5.chunk.js": "./static/js/1116.85ec79d5.chunk.js",
     "static/js/3513.5e3a04f2.chunk.js": "./static/js/3513.5e3a04f2.chunk.js",
     "static/js/7602.a6e1d802.chunk.js": "./static/js/7602.a6e1d802.chunk.js",
@@ -153,6 +153,6 @@
   },
   "entrypoints": [
     "static/css/main.5513bd04.css",
-    "static/js/main.33cac65c.js"
+    "static/js/main.771fbdca.js"
   ]
 }

streamlit/static/index.html

@@ -1 +1 @@
-<!doctype html><html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width,initial-scale=1,shrink-to-fit=no"/><link rel="shortcut icon" href="./favicon.png"/><link rel="preload" href="./static/media/SourceSansPro-Regular.0d69e5ff5e92ac64a0c9.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-SemiBold.abed79cd0df1827e18cf.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-Bold.118dea98980e20a81ced.woff2" as="font" type="font/woff2" crossorigin><title>Streamlit</title><script>window.prerenderReady=!1</script><script defer="defer" src="./static/js/main.33cac65c.js"></script><link href="./static/css/main.5513bd04.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>
+<!doctype html><html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width,initial-scale=1,shrink-to-fit=no"/><link rel="shortcut icon" href="./favicon.png"/><link rel="preload" href="./static/media/SourceSansPro-Regular.0d69e5ff5e92ac64a0c9.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-SemiBold.abed79cd0df1827e18cf.woff2" as="font" type="font/woff2" crossorigin><link rel="preload" href="./static/media/SourceSansPro-Bold.118dea98980e20a81ced.woff2" as="font" type="font/woff2" crossorigin><title>Streamlit</title><script>window.prerenderReady=!1</script><script defer="defer" src="./static/js/main.771fbdca.js"></script><link href="./static/css/main.5513bd04.css" rel="stylesheet"></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>

streamlit/static/static/js/1792.61097259.chunk.js

@@ -0,0 +1 @@
+"use strict";(self.webpackChunk_streamlit_app=self.webpackChunk_streamlit_app||[]).push([[1792],{61792:(e,t,s)=>{s.r(t),s.d(t,{default:()=>c});s(66845);var i=s(25621),l=s(81354),a=s(27446),n=s(9003),r=s(22704),d=s(12596),o=s(40864);const c=function(e){const{colors:t}=(0,i.u)(),{disabled:s,element:c,widgetMgr:u,width:h,fragmentId:p}=e,m={width:h},b="primary"===c.type?l.nW.PRIMARY:l.nW.SECONDARY,g=!c.help||h,f=c.icon.startsWith(":material");return(0,o.jsx)("div",{className:"stButton","data-testid":"stButton",style:m,children:(0,o.jsx)(a.t,{help:c.help,children:(0,o.jsxs)(n.ZP,{kind:b,size:l.V5.SMALL,disabled:s,fluidWidth:!!c.useContainerWidth&&g,onClick:()=>u.setTriggerValue(c,{fromUi:!0},p),children:[c.icon&&(0,o.jsx)(r.p,{size:f?"lg":"base",margin:f?"0 sm 0 0":"0 md 0 0",color:t.bodyText,iconValue:c.icon}),(0,o.jsx)(d.ZP,{source:c.label,allowHTML:!1,isLabel:!0,largerLabel:!0,disableLinks:!0})]})})})}}}]);