Design SystemPatternsAssetEventTimeline

EventTimeline

Adopted在本 repo 設計、production 已採用。站上是設計端的版本,production 實作可能已再調整。

Production:src/components/AssetPrediction/source/EventTimeline/EventTimeline.tsx

Installation

import { EventTimeline } from "@/components/product/event-timeline/event-timeline";

Overview

資產 dashboard 右欄的事件軌:一則一則「可能改變讀法」的近期事件,時間新到舊。 每則三行 —— 時間 · 分類 / 標題 / 一句話說明為什麼這件事有關係。

為什麼不直接用 production 的 VerticalTimeline: 那個組件模型是「結算流程步驟」—— 兩行、brand 色圓點、brand 色連接線。 brand 色在那裡帶著進度語意(這一步已完成)。事件流沒有進度可言, 沿用會讓畫面對內容說謊。三個差異都是語意層的,不是外觀偏好:

面向production VerticalTimelineEventTimeline(本組件)
行數2 行(primary 左 / secondary 右)3 行(meta / 標題 / 說明)
圓點與連接線brand 圓點 + brand 直條中性圓點 + 中性細線
語意已知序列的第 N 步開放式事件流的第 N 則

連接線保留 —— 改變的是它從 brand 轉成中性(border-secondary), 讀起來是「這些屬於同一串」而不是「進度到這裡」。 圓點走 --color-data-point, 2026-07-27 隨 data visualization token 組新增的中性序列標記角色。 刻意不是 brand、也不是極性色 —— 一則事件在讀者判斷之前,既不是好消息也不是壞消息。

Interactive Demo

Rail 情境(dashboard 右欄實際用法)

BTC timelineLatest events that may change the read

18 min ago · ETF flows

Spot Bitcoin ETF flows turn positive

Sustained inflows could support the bid into the weekly settlement.

42 min ago · Options

Open interest clusters near $70k

The strike may become more relevant as expiry approaches.

1 hr ago · Macro

Fed commentary lifts risk assets

A softer rate path may improve appetite across the complex.

3 hr ago · Regulation

Senate advances digital-asset bill

Clearer market structure could reduce the regulatory discount.

Static State Matrix

單則 / 兩則 / 完整四則(最後一則不留尾端間距)

18 min ago · ETF flows

Spot Bitcoin ETF flows turn positive

Sustained inflows could support the bid into the weekly settlement.

18 min ago · ETF flows

Spot Bitcoin ETF flows turn positive

Sustained inflows could support the bid into the weekly settlement.

42 min ago · Options

Open interest clusters near $70k

The strike may become more relevant as expiry approaches.

18 min ago · ETF flows

Spot Bitcoin ETF flows turn positive

Sustained inflows could support the bid into the weekly settlement.

42 min ago · Options

Open interest clusters near $70k

The strike may become more relevant as expiry approaches.

1 hr ago · Macro

Fed commentary lifts risk assets

A softer rate path may improve appetite across the complex.

3 hr ago · Regulation

Senate advances digital-asset bill

Clearer market structure could reduce the regulatory discount.

無分類 / 無說明(欄位缺漏時不留空行)

5 min ago

沒有分類的事件

2 hr ago

也沒有說明文字

5 min ago · Macro

有分類,無說明

2 hr ago

無分類,有說明

說明仍然照常出現在標題下方。

surface — 圓點的環必須跟實際底色一致

surface="primary"(預設,卡片/頁面底)

18 min ago · ETF flows

Spot Bitcoin ETF flows turn positive

Sustained inflows could support the bid into the weekly settlement.

42 min ago · Options

Open interest clusters near $70k

The strike may become more relevant as expiry approaches.

surface="secondary"(浮起表面)

18 min ago · ETF flows

Spot Bitcoin ETF flows turn positive

Sustained inflows could support the bid into the weekly settlement.

42 min ago · Options

Open interest clusters near $70k

The strike may become more relevant as expiry approaches.

長文字(標題換行 / 說明兩行以上)

18 min ago · Regulation

Senate advances digital-asset market structure bill out of committee

Clearer market structure could reduce the regulatory discount priced into spot, though the House timetable remains unresolved and the effect may not show up before the weekly settlement.

1 hr ago · Macro

短標題對照

這個組件沒有 hover / pressed / focus —— 它是唯讀顯示層,項目本身不可點。 若之後每則要能點進新聞來源,才會需要補互動 state。

Implementation Notes

來源:../opinion-labs-archive/prototypes/assets-forecasting/btc-dashboard-spike-v1.html 的 .tl / .tl-item / .tl-dot / .tl-time / .tl-title / .tl-copy。

已知偏離(字級收斂,未逐項裁決)

  • 說明文字:稿子 12/18,改用 text-bodyS(12/16)。 系統沒有 12/18 這一階,段落行高因此緊 2px。
  • 左內距:稿子 22px,改用 pl-6(24px)。22 不在 4px 級數上。

兩項都是「稿子值不在 token 級數上」造成的,不是視覺決策。 若要 pixel-perfect 對回稿子,需要新增字級階與 spacing 階,成本高於效益 —— 建議接受收斂值。