Python AdminUI 开源项目教程

1. 项目介绍

Python AdminUI 是一个基于 Flask/FastApi 的后端框架，它允许开发者使用 Python 快速构建 Web 界面，而无需编写 HTML、CSS 或 JS 代码。它适用于数据项目、工具和脚本、小型 IT 系统和管理系统等场景，特别适合那些不需要过多自定义样式或处理高流量性能的系统。

该项目结合了 Ant Design Pro 的前端组件，提供了一套完整的解决方案，包括表单、图表、数据表格和自适应移动设备的设计，使得开发者可以专注于业务逻辑而非界面设计。

2. 项目快速启动

首先，确保你已经安装了 Python 和 pip。以下是快速启动 Python AdminUI 的步骤：

# 安装 Python AdminUI
pip install adminui

# 创建一个简单的表单页面示例
from adminui import *

app = AdminApp()

def on_submit(form_data):
    print(form_data)

@app.page('/', 'form')
def form_page():
    return [
        Form(on_submit=on_submit, content=[
            TextField('标题', required_message="标题是必填项！"),
            TextArea('描述'),
            FormActions(content=[
                SubmitButton('提交')
            ])
        ])
    ]

# 运行应用
if __name__ == '__main__':
    app.run()

运行上述 Python 文件后，访问 http://127.0.0.1:5000/ 即可看到结果。

如果你想使用 FastApi，可以在创建 AdminApp 时设置 use_fastapi=True，并在命令行使用 uvicorn 运行应用。

3. 应用案例和最佳实践

表单处理

对于需要用户输入数据的场景，AdminUI 提供了表单组件，可以轻松创建和验证表单数据。

@app.page('/submit-form', 'form')
def submit_form_page():
    def on_submit(form_data):
        # 处理表单数据
        pass

    return [
        Form(on_submit=on_submit, content=[
            # 表单项
        ])
    ]

数据展示

数据表格是展示数据的好方法。AdminUI 支持分页和自定义列。

@app.page('/data-table', 'table')
def data_table_page():
    # 数据源
    data_source = [
        {'name': '数据1', 'value': '值1'},
        # 其他数据
    ]

    return [
        DataTable(data_source, columns=[
            Column('name', '名称'),
            Column('value', '值'),
        ])
    ]

图表应用

AdminUI 支持多种图表类型，如折线图、柱状图、饼图等。

@app.page('/charts', 'chart')
def charts_page():
    # 图表数据
    chart_data = {
        'xData': ['类别1', '类别2'],
        'yData': [120, 200],
    }

    return [
        LineChart(chart_data)
    ]

4. 典型生态项目

AdminUI 作为一个开源项目，其生态系统还包括了一些典型的扩展和插件，例如：

• 数据库集成：与各种数据库系统（如 MySQL、SQLite、Excel 等）的无缝集成。
• 认证系统：基于 JWT 的认证和登录系统，带有一个简洁的登录页面。
• 移动适配：自动适配移动设备，无需额外编写代码。

通过以上教程，开发者可以快速上手 Python AdminUI，构建出满足各种需求的 Web 应用。