The app chrome
您的Streamlit应用程序在右上角有几个小部件,以帮助您在开发过程中使用。这些小部件也可以帮助您的观众在使用您的应用程序时。我们称这些东西为“应用程序装饰”。装饰包括状态区域、工具栏和应用程序菜单。
您的应用程序菜单是可配置的。默认情况下,当您在本地或登录具有管理访问权限的账户时在Streamlit社区云上查看应用程序时,可以从应用程序菜单访问开发者选项。在查看应用程序时,点击右上角的图标以访问菜单。

Menu options
菜单分为两个部分。上半部分包含所有查看者可用的选项,下半部分包含开发者的选项。在本页末尾阅读更多关于自定义此菜单的信息。
Rerun
你可以通过点击应用菜单中的“重新运行”来手动触发应用的重新运行。这次重新运行不会重置你的会话。存储在st.session_state中的小部件状态和值将被保留。作为快捷方式,无需打开应用菜单,你可以通过按键盘上的“R”键来重新运行你的应用(如果你当前没有聚焦在输入元素上)。
Settings
通过“设置”选项,您可以在应用程序运行时控制其外观。如果在本地查看应用程序,您可以设置应用程序如何响应源代码中的更改。有关开发流程的更多信息,请参阅基本概念。您还可以强制应用程序以宽模式显示,即使未在脚本中使用st.set_page_config进行设置。
主题设置
从应用菜单中点击“设置”后,您可以选择应用的基础主题为“浅色”、“深色”或“使用系统设置”。点击“编辑当前主题”可以逐色修改主题。


点击“打印”或使用键盘快捷键(⌘+P 或 Ctrl+P)打开打印对话框。此选项使用浏览器的内置打印到PDF功能。要修改打印的外观,您可以执行以下操作:
- 在打印前展开或折叠侧边栏,以分别将其包含在打印中或排除在外。
- 通过点击并拖动侧边栏的右边框来调整应用程序中侧边栏的大小,以达到您想要的宽度。
- 如果您在暗模式下打印,可能需要在打印对话框中启用“背景图形”。
- 您可能需要在设置中禁用宽模式或调整打印比例,以防止元素从页面剪裁掉。
Record a screencast
你可以直接从你的应用程序轻松进行屏幕录制!屏幕录制在最新版本的Chrome、Edge和Firefox中受支持。确保你的浏览器是最新的以保证兼容性。根据你当前的设置,你可能需要授予浏览器权限来录制你的屏幕或使用麦克风(如果录制旁白)。
- 在查看您的应用程序时,从右上角打开应用程序菜单。
- 点击“录制屏幕”。
- 如果你想通过麦克风录制音频,请勾选“同时录制音频”。
- 点击“开始录制”。(您的操作系统可能会提示您允许浏览器录制屏幕或使用麦克风。)

- 从列出的选项中选择您想要录制的标签页、窗口或监视器。界面将根据您的浏览器而有所不同。

- 点击“分享”。

- 在录制过程中,您将在应用程序的标签和应用程序菜单图标上看到一个红色的圆圈。如果您想取消录制,请点击应用程序底部的“停止共享”。

- 当您完成录制后,请按键盘上的“Esc”键或从应用程序菜单中选择“停止录制”。

- 按照浏览器的指示保存您的录音。保存的录音将出现在浏览器保存下载的位置。
整个过程看起来像这样:

About
您可以方便地从“关于”选项中查看正在运行的Streamlit版本。开发者还可以使用st.set_page_config自定义此处显示的消息。
Developer options
默认情况下,开发者选项仅在本地查看应用程序或在使用管理员权限登录时查看社区云应用程序时显示。如果您希望这些选项对所有用户可用,可以自定义菜单。
Clear cache
通过点击应用菜单中的“清除缓存”或在未聚焦于输入元素时按下键盘上的“C”来重置应用的缓存。这将删除@st.cache_data和@st.cache_resource的所有缓存条目。
Deploy this app
如果你正在从git仓库本地运行一个应用程序,你可以通过几个简单的点击将你的应用程序部署到Streamlit社区云!在开始之前,请确保你的工作已经推送到你的在线GitHub仓库。为了最大的便利,请确保你已经创建了你的社区云账户并且已经登录。
- 点击应用菜单图标旁边的“部署”(more_vert)。

- 点击“立即部署”。

- 您将被带到Community Cloud的“部署应用程序”页面。您的应用程序的仓库、分支和文件名将预先填写以匹配您当前的应用程序!了解更多关于在Streamlit Community Cloud上部署应用程序的信息。
整个过程看起来像这样:

Customize the menu
在你的应用程序的配置中使用client.toolbarMode,你可以让应用菜单以以下方式显示:
"developer"— 向所有查看者显示开发者选项。"viewer"— 对所有查看者隐藏开发者选项。"minimal"— 仅显示那些外部设置的选项。这些选项可以通过st.set_page_config声明,或通过 Streamlit Community Cloud 填充。"auto"— 这是默认设置,当通过localhost访问或通过Streamlit Community Cloud登录到应用程序的管理员账户时,将显示开发者选项。否则,开发者选项将不会显示。
还有问题吗?
我们的 论坛 充满了有用的信息和Streamlit专家。