mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2026-09-28 16:20:56 +08:00
5e30694663
* ♻️ refactor(ui): 重构 UI 渲染系统并优化资源管理 - 【重构】重构 `RendererService` 架构，解耦模板引擎、主题管理与截图引擎 - 【重构】重构 `ui` 模块，采用组件注册机制与数据模型驱动，移除旧版 `builders` - 【功能】新增 UI 热重载模式，支持在不重启的情况下实时预览 HTML/CSS 修改 - 【功能】增强启动项资源检查，支持基于 `resources.spec` 的版本校验与自动更新 - 【优化】统一内置插件的 UI 渲染逻辑，迁移至新的 `ui.table`、`ui.markdown` 等工厂接口 - 【优化】优化日志脱敏工具，支持自动折叠调试输出中冗长的样式标签 - 【优化】引入 `AssetResolutionService`，完善皮肤、组件、主题间的多级资源回退机制 - 【优化】新增组件生命周期钩子 `prepare`，支持渲染前的异步数据预处理 * 🚨 auto fix by pre-commit hooks --------- Co-authored-by: webjoin111 <455457521@qq.com> Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
103 lines
3.5 KiB
Python
103 lines
3.5 KiB
Python
from typing import Literal
|
|
|
|
from pydantic import Field
|
|
|
|
from ..core.base import RenderableComponent
|
|
|
|
__all__ = ["Avatar", "AvatarGroup", "Divider", "Rectangle", "UserInfoBlock"]
|
|
|
|
|
|
class Avatar(RenderableComponent):
|
|
"""单个头像组件。"""
|
|
|
|
component_type: Literal["avatar"] = "avatar"
|
|
"""组件类型"""
|
|
src: str = Field(..., description="头像的URL或Base64数据URI")
|
|
"""头像的URL或Base64数据URI"""
|
|
shape: Literal["circle", "square"] = Field("circle", description="头像形状")
|
|
"""头像形状"""
|
|
size: int = Field(50, description="头像尺寸（像素）")
|
|
"""头像尺寸（像素）"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/avatar"
|
|
|
|
|
|
class AvatarGroup(RenderableComponent):
|
|
"""一组堆叠的头像组件。"""
|
|
|
|
component_type: Literal["avatar_group"] = "avatar_group"
|
|
"""组件类型"""
|
|
avatars: list[Avatar] = Field(default_factory=list, description="头像列表")
|
|
"""头像列表"""
|
|
spacing: int = Field(-15, description="头像间的间距（负数表示重叠）")
|
|
"""头像间的间距（负数表示重叠）"""
|
|
max_count: int | None = Field(
|
|
None, description="最多显示的头像数量，超出部分会显示为'+N'"
|
|
)
|
|
"""最多显示的头像数量，超出部分会显示为'+N'"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/avatar"
|
|
|
|
|
|
class Divider(RenderableComponent):
|
|
"""一个简单的分割线组件。"""
|
|
|
|
component_type: Literal["divider"] = "divider"
|
|
"""组件类型"""
|
|
margin: str = Field("2em 0", description="CSS margin属性，控制分割线上下的间距")
|
|
"""CSS margin属性，控制分割线上下的间距"""
|
|
color: str = Field("#f7889c", description="分割线颜色")
|
|
"""分割线颜色"""
|
|
style: Literal["solid", "dashed", "dotted"] = Field("solid", description="线条样式")
|
|
"""线条样式"""
|
|
thickness: str = Field("1px", description="线条粗细")
|
|
"""线条粗细"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/divider"
|
|
|
|
|
|
class Rectangle(RenderableComponent):
|
|
"""一个矩形背景块组件。"""
|
|
|
|
component_type: Literal["rectangle"] = "rectangle"
|
|
"""组件类型"""
|
|
height: str = Field("50px", description="矩形的高度 (CSS value)")
|
|
"""矩形的高度 (CSS value)"""
|
|
background_color: str = Field("#fdf1f5", description="背景颜色")
|
|
"""背景颜色"""
|
|
border: str = Field("1px solid #fce4ec", description="CSS border属性")
|
|
"""CSS border属性"""
|
|
border_radius: str = Field("8px", description="CSS border-radius属性")
|
|
"""CSS border-radius属性"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/rectangle"
|
|
|
|
|
|
class UserInfoBlock(RenderableComponent):
|
|
"""一个带头像、名称和副标题的用户信息块组件。"""
|
|
|
|
component_type: Literal["user_info_block"] = "user_info_block"
|
|
"""组件类型"""
|
|
avatar_url: str = Field(..., description="用户头像的URL")
|
|
"""用户头像的URL"""
|
|
name: str = Field(..., description="用户的名称")
|
|
"""用户的名称"""
|
|
subtitle: str | None = Field(
|
|
default=None, description="显示在名称下方的副标题 (如UID或角色)"
|
|
)
|
|
"""显示在名称下方的副标题 (如UID或角色)"""
|
|
tags: list[str] = Field(default_factory=list, description="附加的标签列表")
|
|
"""附加的标签列表"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/user_info_block"
|