显示一条短消息,称为通知“toast”。

提示信息会出现在应用的右下角,并在四秒后消失。

警告

st.toast 与 Streamlit 的 缓存 不兼容,并且不能在缓存函数中调用。

函数签名[source]

st.toast(body, *, icon=None)

参数

body (str)

要显示为GitHub风格的Markdown的字符串。语法信息可以在以下链接找到:https://github.github.com/gfm

有关其他支持的Markdown指令,请参见st.markdownbody参数。

icon (str, None)

一个可选的emoji或图标,显示在警报旁边。如果iconNone(默认),则不显示图标。如果icon是一个字符串,以下选项是有效的:

  • 一个单字符的emoji。例如,你可以设置icon="🚨"icon="🔥"。不支持emoji短代码。

  • 来自Material Symbols库(圆角风格)的图标,格式为":material/icon_name:",其中"icon_name"是图标名称的蛇形命名。

    例如,icon=":material/thumb_up:"将显示Thumb Up图标。在Material Symbols字体库中查找更多图标。

示例

import streamlit as st

st.toast('Your edited image was saved!', icon='😍')

当生成多个toast时,它们会堆叠在一起。将鼠标悬停在toast上会阻止它消失。当悬停结束时,toast将在四秒后消失。

import streamlit as st import time if st.button('Three cheers'): st.toast('Hip!') time.sleep(.5) st.toast('Hip!') time.sleep(.5) st.toast('Hooray!', icon='🎉')

Toast 消息也可以更新。将 st.toast(my_message) 赋值给一个变量,并使用 .toast() 方法来更新它。注意:如果 toast 已经消失或被关闭,更新将不会被看到。

import streamlit as st import time def cook_breakfast(): msg = st.toast('Gathering ingredients...') time.sleep(1) msg.toast('Cooking...') time.sleep(1) msg.toast('Ready!', icon = "🥞") if st.button('Cook breakfast'): cook_breakfast()
forum

还有问题吗?

我们的 论坛 充满了有用的信息和Streamlit专家。