wc-toast 0.1.0

A polished macOS-style toast notification widget for PySide6

wc_toast

一个独立、轻量的 PySide6 弱提示组件，视觉参考 macOS 通知中心。

特性

• 浅色半透明圆角通知卡片
• 成功、信息、警告、错误和默认主题
• 滑入、回弹、淡出动画
• 同一位置多条通知自动堆叠
• 支持操作按钮、关闭按钮和自动消失
• 不依赖 pyqttoast
• 支持七个预设位置

安装

pip install wc_toast

快速使用

from PySide6.QtWidgets import QApplication
from wc_toast import Toast, ToastPosition

app = QApplication([])

Toast.success(
    "保存成功",
    "项目文件已经保存。",
    position=ToastPosition.TOP_RIGHT,
)

app.exec()

可用位置

ToastPosition.TOP_LEFT       # 顶部靠左
ToastPosition.TOP_MIDDLE     # 顶部中间
ToastPosition.TOP_RIGHT      # 顶部靠右
ToastPosition.MIDDLE_LOWER   # 屏幕中间偏下
ToastPosition.BOTTOM_LEFT    # 底部靠左
ToastPosition.BOTTOM_MIDDLE  # 底部中间
ToastPosition.BOTTOM_RIGHT   # 底部靠右

完整配置

from wc_toast import Toast, ToastPosition, ToastPreset

toast = Toast()
toast.setPreset(ToastPreset.INFORMATION)
toast.setTitle("处理完成")
toast.setText("文件已经导入，可以继续下一步。")
toast.setDuration(3000)
toast.setPosition(ToastPosition.MIDDLE_LOWER)
toast.setAction("查看详情", lambda: print("查看"))
toast.show()

duration=0 时通知不会自动关闭。

本地演示

python -m wc_toast.toast

许可证

MIT