mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2025-12-14 21:52:56 +08:00
c7ef6fdb17
Some checks failed
检查bot是否运行正常 / bot check (push) Has been cancelled
CodeQL Code Security Analysis / Analyze (${{ matrix.language }}) (none, javascript-typescript) (push) Has been cancelled
CodeQL Code Security Analysis / Analyze (${{ matrix.language }}) (none, python) (push) Has been cancelled
Sequential Lint and Type Check / ruff-call (push) Has been cancelled
Release Drafter / Update Release Draft (push) Has been cancelled
Force Sync to Aliyun / sync (push) Has been cancelled
Update Version / update-version (push) Has been cancelled
Sequential Lint and Type Check / pyright-call (push) Has been cancelled
* ✨ feat(table): 添加 ComponentCell 以支持表格单元格中嵌入可渲染组件 * ✨ feat(ui): 增强表格构建器并完善组件模型文档 - 增强 `TableBuilder`，新增 `_normalize_cell` 辅助方法，支持自动将原生数据类型（如 `str`, `int`, `Path`）转换为 `TableCell` 模型，简化了表格行的创建。 - 完善 `zhenxun/ui/models` 目录下所有组件模型字段的 `description` 属性和文档字符串，显著提升了代码可读性和开发者体验。 - 优化 `shop/_data_source.py` 中 `gold_rank` 函数的平台路径判断格式，并统一 `my_props` 函数中图标路径的处理逻辑。 * 🚨 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>
42 lines
1.3 KiB
Python
42 lines
1.3 KiB
Python
from typing import Literal
|
|
|
|
from pydantic import Field
|
|
|
|
from ..core.base import RenderableComponent
|
|
|
|
__all__ = ["Avatar", "AvatarGroup"]
|
|
|
|
|
|
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"
|