DESIGN.md v1.1 · 全站视觉与交互标准 · 控件测试页
科技 · 创造 · 无限可能品牌主色、强调色、功能色与中性色 Token(DESIGN.md §2)。
字号 / 行高 / 字重规范(DESIGN.md §3)。
这是默认正文样式,用于主要内容的阅读与描述,行高保持 1.6 以获得良好可读性。
五种类型 × 三种规格 + 禁用 + 加载态(DESIGN.md §4.1)。
输入框状态、下拉、复选框 / 单选框 / 开关(DESIGN.md §4.2-4.4)。
普通卡片与可点击卡片(DESIGN.md §4.5)。
系统工具与 MOD / DLC 下载中心,支持授权验证与自动更新。
基于密钥校验的安全验证服务,保护你的应用免受滥用。
Minecraft 模组维基百科(可点击卡片:hover 抬升)。
打开演示:遮罩淡入 + 面板上移淡入;Esc / 遮罩 / 取消关闭(DESIGN.md §4.7)。
表头 / 斑马纹 / 行悬停 / 操作列(DESIGN.md §4.8)。
| 用户名 | 角色 | 状态 | 注册时间 | 操作 |
|---|---|---|---|---|
| Minecraft_zy227 | VIP | 正常 | 2025-06-12 | |
| ziyit_user | 普通 | 正常 | 2026-01-03 | |
| test_104 | 普通 | 已封禁 | 2026-03-21 |
VIP / 封禁 / 普通 / 主色标签 与 计数徽章(DESIGN.md §4.10)。
主加载指示器/ 骨架屏 / 按钮加载(DESIGN.md §4.12)。
无数据引导,必须提供下一步动作(DESIGN.md §4.13)。
试试更换关键词,或浏览全部 MOD
浅色 / 深色 / 跟随系统(DESIGN.md §4.14)。偏好自动保存至 cookie(key:ziyit-theme,有效期 1 年),刷新后保持;"跟随系统"实时响应系统设置。
prefers-color-scheme,系统切换时"跟随系统"模式自动响应。注册 / 修改邮箱 / 修改密码共用同一套规则与交互(DESIGN.md §4.15)。空值在失焦、输入阶段不提示,只有点击提交时才提示必填。
| 时机 | 必须行为 | 视觉结果 |
|---|---|---|
| 失焦(空值) | 不提示、不报错,必填校验留到提交 | 保持默认样式 |
| 失焦(非空) | 立即执行该输入框的完整规则校验 | 失败:红框 + 13px 红色文案 |
| 输入中(已有错误) | 每次内容变化即时复检 | 一旦合规:立刻移除红框与文案 |
| 输入中(密码) | 逐项实时判断强度规则 | 满足项由灰色 ○ 变绿色 ✓ |
| 提交 | ZIYIT_FV.validateAll([...]) 逐项校验,聚焦第一个非法项 | 空值在此刻提示必填,并阻止请求 |
全站所有页面、所有按钮共用一套加载态(DESIGN.md §4.1 / §4.16)。点击后立即拦截重复点击;操作超过 100ms 才显示加载态并禁用,瞬间完成的操作不出现任何闪烁。该次操作触发的 fetch / XHR(含 SSE 流式响应)全部结束后,无论成功或失败都立即恢复。
| 时机 | 必须行为 | 视觉结果 |
|---|---|---|
| 操作 <100ms 完成 | 不展示加载态,仅静默拦截重复点击 | 按钮外观完全不变,无闪烁 |
| 操作持续 ≥100ms | 第 100ms 进入加载态并禁用 | 转圈 + 加载文案,按钮不可再次点击 |
| 加载中 | 拦截重复点击、回车与程序化 click | 不重复提交,按钮保持加载态 |
| 操作成功 | 最后一个请求结束时立即恢复 | 恢复原文案与原宽度,可再次点击 |
| 操作失败 | 与成功一致,立即恢复可用 | 恢复原文案,由页面给出失败提示 |
| 兜底 | 任何按钮加载超过 120s 强制恢复并告警 | 不会永久卡在加载态 |
ZIYIT_BTN.wrap(btn, promise) 手动指定异步任务。成功 / 错误 / 信息,自动消失,替代 alert()(DESIGN.md §4.9)。
线性风格,四档尺寸(DESIGN.md §5)。
Elevation 1-3 阴影系统(DESIGN.md §7)。