定位

小世界不是固定從某一始祖開始的族譜圖,而是以使用者目前選中的人物為中心節點。點選另一人物後,畫面以該人物重新置中,並依需要逐層展開其親屬與其他關係。

建議技術

採用 Cytoscape.js + ELK.js:

  • Cytoscape.js 負責節點、連線、縮放、拖曳、點選與畫布互動;BFS、共同祖先與人物分組由本站程式計算。
  • 現行中心心智圖使用依父母、手足、婚配、子女分區計算的 preset 位置,才能穩定維持夫妻與手足的傳統相對方位。ELK.js 已隨元件載入,保留給未來更複雜、多支系或交叉連線的自動排列,不是目前中心圖的主要布局器。
  • Quartz 繼續負責人物頁與靜態網站,不必改成 React 專案。

互動規則

  1. 中心心智圖只繪製中心人物及目前選取的一層父母、手足、婚配與子女;現行小型資料集仍一次載入完整 family-data.json,但不一次畫出全部人物。
  2. 單擊人物:改以該人物為中心重新展開;雙擊人物:在同頁切換至完整人物圖卡。
  3. 畫布上方以父母、手足、婚配、子女四個分類按鈕切換顯示,不在每個節點旁重複放展開控制。
  4. 妻、妾、前妻、後妻、收養等關係保留獨立類型;婚姻可用聯姻節點協助多配偶家庭排列。
  5. 提供「返回上一人」「置中全圖」「人物內頁」;重新置中時只保存中心人物歷史,不累積舊中心的整張展開畫布。
  6. 人物圖卡可返回原畫布並保留中心、縮放與位置,也可直接改以圖卡人物為中心。

三種檢視

  • 中心心智圖:中心人物在中央,父母在上、手足依夫妻方位分列左右、婚配相鄰、子女向下,適合逐人探索。
  • 兩人關係:用 BFS 計算最短親屬路徑,並列出目前資料中的最近共同祖先。
  • 直式世系:依使用者選擇向下展開 3~5 層,保留同輩由右至左、長幼順序與考右妣左,並可列印或另存 PDF。

RWD 與可讀性

  • 小世界外框一律依中央內容欄寬度伸縮,不直接以 100vw 撐開頁面。
  • 畫布寬度不超過容器;工具列、關係篩選、操作按鈕、圖例與提示在窄畫面自動換行。
  • 畫布寬度 720px 以下首次載入時自動置入目前全部節點;480px 以下改採較緊密的三欄排列,避免為了顯示全圖而把姓名縮得過小。
  • RWD 驗收必須包含 1600、1366、1024、768、390px,並確認頁面無水平溢出、所有節點在畫布內且最小人物卡寬度不少於 60px。
  • 使用 Chrome Remote 執行 scripts/family/responsive-smoke.mjs;互動功能另以 browser-smoke.mjs 回歸驗證。

大型資料原則

現行數百人規模會把完整 family-data.json 載入瀏覽器,再只繪製中心人物的一層關係;實際人數以建置時自動產生的 資料統計 為準。此方式對目前資料量簡單且足夠。若資料成長到數萬人以上,必須先量測 JSON 大小、載入時間與 BFS 記憶體,再改為人物索引及關係分片。達到大型或百萬人物規模時,瀏覽器只應接收指定人物一至三層的鄰接子圖,搜尋與跨分片路徑另設索引或後端服務,不得一次把整張圖送入瀏覽器。