用途:为 Streamlit 应用创建并定制主题,覆盖配色、字体、圆角、侧边栏与明暗模式,使界面符合品牌规范。
主要能力:在 .streamlit/config.toml 的 [theme] 段配置颜色(primaryColor、backgroundColor、secondaryBackgroundColor、textColor、linkColor、codeTextColor、codeBackgroundColor、borderColor);通过 base 从内置主题或外部文件(本地路径或远程 URL)继承,仅覆盖需改项;定义语义色(redColor 等,含 background/text 变体);配置图表色(chartCategoricalColors、chartSequentialColors,后者需恰好 10 色);数据框样式;字体(内置、Google Fonts、[[theme.fontFaces]] 自托管,字体文件需置于 static/ 并通过应用提供);字号字重(baseFontSize、headingFontSizes、codeFontSize 等);圆角与边框(baseRadius、buttonRadius、showWidgetBorder、showSidebarBorder);[theme.sidebar] 独立定制;[theme.light] 与 [theme.dark] 分别定义以便用户切换,仅有 [theme] 时锁定单一模式;用 st.context.theme.base 检测当前模式。
使用方式:将选项写入 config.toml 的 [theme] 段;多数选项保存并重跑后实时生效,字体相关选项(fontFaces)需重启服务器。除用户明确要求外,不应使用自定义 CSS 或 HTML 进行主题化。
适用场景:品牌化应用、明暗双模式、图表与数据框统一视觉、上传字体资源。
限制:外部 base 主题文件只能含单个 [theme] 段;fontFaces 需重启且字体须经 static/ 提供;chartSequentialColors 必须为 10 个颜色;需注意主色与白色按钮文字、文本与背景的对比度。