桌面组件概述
PPtink桌面框架提供了丰富的UI组件，帮助开发者快速构建美观、功能完善的桌面应用。本文档基于实际代码示例，展示各组件的使用方法与参数配置。
组件分类
我们的组件库按功能分为以下几类：
基本输入组件
选择组件
不常用组件
服务设置组件
- 服务配置 - 端口配置等服务相关设置
组件基础配置
所有组件都支持以下通用配置选项：
metavar- 组件标题help- 组件帮助提示default- 默认值widget- 组件类型gooey_options- 组件配置选项
组件使用示例
Python 示例
python
from app.WebDemo.common.GuiConfig import GooeyConfig
# 初始化GUI配置
gui_config = GooeyConfig(
program_name="PPtink桌面演示",
program_description="组件演示程序"
)
# 添加文本输入框
gui_config.add_argument(
"name",
metavar="文本输入框",
help="输入字符串",
default="默认值",
widget="TextField",
gooey_options={
"placeholder": "请输入文本",
"size": "large"
}
)前端使用
组件会自动根据配置渲染成对应的表单元素，开发者无需关注具体的渲染实现。
表单验证
组件支持多种验证方式：
- 内置验证 - 类型验证、必填验证等
- 自定义验证 - 通过
validate参数指定验证方法
python
# 示例：添加带验证的文本框
gui_config.add_argument(
"username",
metavar="用户名",
help="请输入用户名",
widget="TextField",
validate="customize_verify" # 自定义验证
)