Global One Line Notice
全局顶部单行公告功能说明,覆盖维护公告、高优先级运营通知、显示规则和多语言规则。
Global One Line Notice 是登录后业务页面共用的全局顶部公告组件,用于展示系统维护、临时中断、财务风险或重要运营规则变更。Login 页面不展示该模块。
页面摘要
| 项目 | 说明 |
|---|---|
| 页面性质 | 登录后业务页面共用的全局顶部公告组件,不属于 Notification 记录列表 |
| 核心动作 | 展示当前最高优先级有效公告,按配置决定文案、语言、有效期和可选跳转 |
| 数据范围 | 后台公告配置、当前语言、当前登录页面和有效公告时间范围 |
| 当前状态 | 展示、隐藏、优先级、多语言和跳转规则已定义;暂无独立开放问题区 |
需求状态
| 状态 | 内容 |
|---|---|
Confirmed | Global One Line Notice 是全局组件,除 Login 外在登录后业务页按统一规则展示或隐藏。 |
Inferred from Figma | 当前只展示单条顶部红色公告;多条公告按优先级、发布时间和类型排序后只展示一条。 |
Open Question | 当前未发现阻塞实现的独立开放问题;如新增多公告轮播、复杂跳转或分品牌展示,需要补充后续 PRD。 |
1. Figma 原型
页面状态 Figma 截图
Global / One Line Notice
One Line Notice 使用高饱和红色横幅,在页面顶部集中提示系统维护或高优先级运营通知。
2. 概览
Global One Line Notice 位于 Top 下方、页面面包屑或页签上方。它只承载高优先级通知,不用于普通营销文案、低优先级提示或页面内局部错误。
组件存在有效公告时展示;无有效公告时整体隐藏,不保留空白高度。
3. 页面组成
页面组成只描述 UI 结构。显示条件、公告来源、点击行为和异常处理写在功能说明中。
| 元素 | UI 表现 | 对应功能说明 |
|---|---|---|
| 公告容器 | 高饱和红色横幅,横向铺满内容区 | 公告容器 |
| 左侧图标 | 白色通知图标 | 公告图标 |
| 公告正文 | 白色加粗文字,居中展示 | 公告正文 |
| 右侧图标 | 白色通知图标 | 公告图标 |
| 可选跳转 | 配置链接后整条公告可点击 | 公告跳转 |
4. 功能说明
4.1 公告容器
公告容器承载当前最高优先级的有效公告。
| 项目 | 说明 |
|---|---|
| 显示位置 | 位于 Top 下方,面包屑或页面页签上方。 |
| 显示条件 | 当前存在有效 Global One Line Notice,并且当前页面不是 Login。 |
| 隐藏条件 | 无有效公告、公告加载失败、当前页面是 Login。 |
| 布局规则 | 展示时占用固定横幅高度;隐藏时不保留空白。 |
| 层级规则 | 不遮挡 Top、侧边栏、面包屑、页签和页面主体内容。 |
4.2 公告图标
公告图标用于强化维护、告警或高优先级通知语义。
| 项目 | 说明 |
|---|---|
| 图标位置 | 公告正文左右两侧各展示一个白色通知图标。 |
| 功能定位 | 只作为视觉强调,不单独承载点击行为。 |
| 响应式 | 宽度不足时优先保留正文,图标可按产品规则缩减间距。 |
| 异常处理 | 图标资源异常时不影响公告正文展示。 |
4.3 公告正文
公告正文展示当前生效公告的主要内容。
| 项目 | 说明 |
|---|---|
| 内容来源 | 后台公告配置。 |
| 公告类型 | 系统维护、临时中断、财务风险、重要运营规则变更。 |
| 多语言 | 支持中文、英文、韩文;当前语言缺失时按共享语言兜底规则展示。 |
| 长度规则 | 默认单行展示;超长时截断或按产品规则滚动,不能改变横幅高度。 |
| 更新规则 | 页面刷新或轮询获取新公告后替换文案。 |
同一时间多条公告生效时,只展示一条。排序规则为:公告优先级 > 发布时间 > 公告类型。不能在同一横幅中堆叠多条公告。
4.4 公告跳转
公告默认不可点击。只有后台配置跳转目标时,整条公告才可点击。
| 项目 | 说明 |
|---|---|
| 默认状态 | 不可点击,仅展示公告内容。 |
| 可点击状态 | 配置跳转链接后,鼠标悬停需要有明确 hover 状态。 |
| 内部跳转 | 跳转到系统内页面时,需进入对应页面 PRD 定义的业务页面。 |
| 外部跳转 | 打开外部链接时,需要遵守系统安全策略。 |
| 失败处理 | 跳转失败时保留当前页面,并提示用户稍后重试。 |
5. 业务规则
- Global One Line Notice 是全局组件,除 Login 外,所有登录后业务页面都使用同一套显示规则。
- 公告必须配置开始时间和结束时间;不在有效期内不得展示。
- 公告内容必须来自后台配置,不允许前端写死固定维护文案。
- 多语言文案必须按 共享规则 的语言兜底方式处理。
- 高优先级公告展示期间,不应被普通页面提示、toast 或局部错误遮挡。
- 无公告时组件完全隐藏,不影响页面顶部间距。
6. 异常与空态
| 场景 | 处理 |
|---|---|
| 无有效公告 | 不展示横幅,不保留占位。 |
| 公告加载失败 | 不展示模拟公告;不中断用户当前页面操作。 |
| 当前语言缺失 | 按语言兜底规则展示其他语言版本。 |
| 公告文案过长 | 单行截断或按产品规则滚动,保持横幅高度稳定。 |
| 跳转链接无效 | 保留当前页面,提示稍后重试。 |
| 当前页面为 Login | 不展示 Global One Line Notice。 |