跳到主要内容
界面图谱Interface Atlas
☰
EN
页面Page / Documentation

更新日志页

Changelog

别名:更新日志更新日志页版本更新记录更新记录页发版说明版本历史页新版本改了啥更新公告页

这是什么

按时间倒序罗列产品每次变化的页面:每条版本以日期与版本号开头,用新增、改进、修复分组呈现, 重要变更附迁移说明与链接。它让用户与团队在同一份事实源上理解「这次更新影响我什么」。

交互实验室

试一试,再决定怎么用

正在加载实验室…

✓ 适用场景

  • 产品持续迭代、有多个对外版本
  • 用户需要知道自己用的版本改了什么
  • 行为或 API 变更需要给出迁移说明

✕ 不适用场景

  • 只有一次发布或基本不再更新
  • 面向内部的任务流水(用项目协作工具)
  • 需要逐条 commit 的开发者视图(用 release 页)

常见形式

时间线式

Timeline

垂直时间轴,日期与版本号作为锚点

分组折叠

Grouped

按版本折叠展开,默认展开最新

订阅流

Feed

简洁列表配 RSS 或邮件订阅入口

页面结构

  1. 01

    标题与订阅

    说明更新频率,并提供 RSS 或邮件订阅。

  2. 02

    最新版本

    置顶当前版本,强调最重要的变更。

  3. 03

    版本条目

    一条版本一个区块,倒序排列,可锚点直达。

  4. 04

    变更分组

    新增、改进、修复分开列,每条一句话。

  5. 05

    迁移提示

    破坏性变更单独提示,给出替代做法。

实现要点

gridflexcounter-reset: versionborder-left: 2px solid var(--color-line)position: sticky

版本列表用有序列表或 article 语义,日期用 time 元素并带 datetime 属性。分类标签用文字而非纯色区分。 时间轴用左侧边框加圆点伪元素;折叠区用原生 details 或受控手风琴。订阅入口可见但克制; 筛选由状态驱动,不改变文档顺序。

相关概念

时间线Timeline

沿时间顺序组织事件的展示组件,通过时间、节点和内容说明事件之间的先后关系。它适合展示活动日志、项目进展或订单状态。时间线呈现已经发生或计划发生的事件,而步骤条强调需要用户完成的任务阶段;当事件可展开时,应保留事件标题和时间,避免用户失去位置。

组件包含组件
手风琴Accordion

由多个可折叠区块组成的垂直列表:点击标题展开内容、再点收起,可互斥(同时只开一项) 也可多开。用于在有限空间里收纳成组内容,让用户按需展开。

组件包含组件
徽标Badge

附着在元素角落或行内的小型状态标记:圆点、数字计数或短文字标签。用于表达未读数量、 状态(新、已废弃)或分类;不参与交互,视觉上从属于宿主元素。

组件包含组件
搜索筛选Search Filtering

用即时过滤把大列表缩到与当前输入相关的一小部分:用户在搜索框敲字,列表随之实时收窄, 并显示命中数量与空结果提示。它把"查找"变成"修剪",不用提交、不用等跳转,反馈就在眼前。

交互模式使用模式
文档页Documentation Page

以阅读为中心的长驻内容页面:一侧是可折叠的文档树导航,正文栏承载标题层级、段落、 代码块与提示框,宽屏下再加页内目录(TOC)标示当前阅读位置。页面靠永久链接与 上一页/下一页串联成站,搜索是第一入口,结构稳定到可以背下来。

页面相似概念

参考来源

Markdown 版(给 Agent) · JSON