【亲测免费】 Streamlit-Antd-Components 教程

1. 项目目录结构及介绍

1.1 目录结构

StreamlitAntdComponents/
├── README.md         # 项目简介和使用说明
├── src/              # 主要代码存储目录
│   ├── components/   # 自定义组件源码
│   │   └── ...
│   └── app.py        # Streamlit 应用主文件
├── requirements.txt  # 依赖包列表
├── setup.py          # 包安装脚本
└── demo_app.py       # 示例应用文件

1.2 文件介绍

• README.md: 项目的基本信息，包括项目目的、如何安装和使用等。
• src/: 源代码目录，包含自定义的 Antd 组件。
• components/: 存放具体 Antd 设计组件的实现。
• app.py: Streamlit 应用的入口文件，展示了如何在 Streamlit 中使用自定义组件。
• requirements.txt: 列出了项目运行所需的 Python 包。
• setup.py: 安装程序，用于将项目作为 Python 包进行安装。
• demo_app.py: 示例应用文件，演示了自定义组件的各种功能。

2. 项目的启动文件介绍

src/app.py 是 Streamlit 应用的启动文件。这个文件包含了如何导入自定义组件并将其展示给用户的逻辑。下面是一个典型的 app.py 文件概览：

import streamlit as st
from streamlit_antd_components import ButtonGroup, Tab, ...  # 导入自定义组件

def main():
    # 使用组件示例
    btn_group = ButtonGroup()
    btn_group.add_button('按钮1')
    btn_group.add_button('按钮2')
    
    st.write(btn_group)

if __name__ == '__main__':
    main()

在这个例子中，ButtonGroup 是从 streamlit_antd_components 导入的一个组件。main() 函数创建了一个按钮组并添加了两个按钮，然后使用 Streamlit 的 write 函数显示出来。

3. 项目的配置文件介绍

该项目没有特定的配置文件（如 .env 或 config.py）。然而，Streamlit 应用可以通过全局配置设置来自定义行为。这通常通过在你的 Streamlit 应用顶部定义 st.set_option 来完成。例如，你可以改变主题或者页面的宽高：

import streamlit as st
st.set_option('deprecation.showPyplotGlobalUse', False)  # 隐藏 Pyplot 全局使用的警告
st.set_page_config(page_title='Streamlit Antd Components', page_icon='...',
                   layout='wide')  # 设置页面标题、图标和布局

如果你想要创建一个局部配置，可以在 app.py 文件内或 demo_app.py 文件内根据需求调整相关设置。

以上就是对 StreamlitAntdComponents 项目的基本介绍。通过理解这些关键文件和结构，你应该能够成功地部署和使用这个项目，以及自定义 Antd 组件在 Streamlit 中的应用。