在下載 SVG 之前,請將 HTML 預覽中的每個儲存格與來源 CSV 逐一比對;這是區分解析錯誤與顯示問題最可靠的方法。
如果逗號被讀取為分隔符、較長的標籤為了圖片而遭縮短,或是寬表格難以閱讀,結果也可能看起來有誤。Table Chart Maker 完全在瀏覽器中轉換以逗號分隔的小型資料集,而且該頁面不會上傳 CSV 值。請依序從來源 CSV、預覽到下載的素材進行處理,不要試著修補完成的圖片。

找出不符的起始位置
將流程分成三個層級:來源 CSV、解析後的 HTML 預覽,以及算繪出的 SVG。如果預覽中的值有誤,問題就在 CSV 結構。如果預覽正確但 SVG 看起來有誤,請聚焦於圖片截斷、欄寬、固定列高,或目標應用程式顯示 SVG 檔案的方式。
| 症狀 | 可能原因 | 修正方式 |
|---|---|---|
| 某個值被分割到多個欄位 | 來源儲存格包含逗號,但未以雙引號括住。 | 以引號括住完整儲存格,然後重新產生圖表。 |
| 產生程序拒絕 CSV | 標題沒有文字、某列的儲存格數量不同,或引號欄位的格式有誤。 | 修正來源記錄,因為解析器會拒絕格式有誤的輸入,而不會自行猜測。 |
| 預覽正確,但 SVG 標籤較短 | 顯示的圖片值會在超過 30 個 Unicode 字元後遭縮短。 | 將此視為匯出差異;預覽會保留完整解析值。 |
| SVG 看起來擁擠或極寬 | 欄寬受到限制,且各列使用固定高度。 | 以最終尺寸檢查檔案,並視需要縮短標籤或減少來源欄位數量。 |
| 標記顯示成可見字元 | 儲存格內容會視為純文字。 | 不需要進行安全性修正,因為看似指令碼的標記並非作用中的標記。 |
盡可能先從簡短且具代表性的樣本開始。小型摘錄較容易讓你找出造成欄位位移、值遺失或列寬不一致的記錄或欄位,再處理完整資料集。
在 Table Chart CSV Table Maker 中修正結果
- 保留可編輯的來源 CSV。 將來源轉換成以逗號分隔的 UTF-8 文字,其中第一列是標題列,後接資料列。第一筆記錄會提供欄位標題,因此請將該列與要顯示為內容本文的記錄分開。
- 確認資料符合支援的限制。 此工具可接受 2 至 10 欄,以及 1 至 50 列資料。輸入總量限於 20,000 個 JavaScript 字元,每個儲存格最多可包含 120 個 Unicode 字元。
- 修正 CSV 引號。 當儲存格包含逗號或換行符號時,請以雙引號括住完整儲存格,並使用兩個雙引號表示引號欄位中的字面引號。引號欄位必須以引號開頭,而且結尾引號後只能接逗號或換行符號。例如,"Ada, A." 會保持在同一欄,而 "Said ""hello""" 會變成 Said "hello"。支援 CRLF 與 LF 換行符號。
- 檢查標題與列寬。 每個標題都必須包含文字,而且每個後續列的儲存格數量都必須與標題完全相同。不要新增分隔符讓寬窄不一的列看起來對齊;請改為修正原始記錄。
- 選擇 Generate table chart。 如果格式有誤的輸入遭到拒絕,請檢查所列出的格式問題,並返回來源 CSV。此工具不會猜測遺漏的儲存格、多餘的逗號或損壞的引號應位於何處。
- 將 HTML 預覽與來源比對。 檢查標題、列順序,拼字、值、列數與欄數。請逐一比對每個儲存格,不要只檢查前幾筆記錄,因為預覽會顯示完整解析值,也是確認 CSV 已正確解讀的主要依據。
- 下載並檢查轉義後的 SVG。 只有在預覽與來源一致後才能下載檔案。以預定的顯示尺寸開啟 SVG,並在發布前檢查過長、過寬或緊湊的儲存格。
如需更多有效引號用法範例,請參閱 CSV 儲存格中處理逗號與字面引號指南。
瞭解預覽與 SVG 的差異
預覽與來源相符後,任何剩餘差異都可能是預定的匯出行為。HTML 預覽與 SVG 圖片並非完全相同的呈現方式,即使兩者都來自同一個已解析表格。
| 面向 | HTML 預覽 | 下載的 SVG |
|---|---|---|
| 儲存格文字 | 保留完整的解析儲存格。 | 顯示值會在超過 30 個 Unicode 字元後遭縮短。 |
| 結構 | 使用真正的 HTML 表格元素,因此標題與儲存格仍可選取。 | 使用 SVG 矩形與文字。 |
| 主要用途 | 確認解析值與列對齊情況。 | 提供獨立且可縮放的表格圖片。 |
| 編輯行為 | 作為視覺確認,而非試算表。 | 作為靜態圖片,不含可編輯的儲存格或試算表控制項。 |
預覽不提供公式、排序、合併儲存格、篩選、樞紐分析操作、推斷類型、隱藏欄位或自動總計。每個值都維持為純文字。因此,此工具不會將日期、貨幣標籤、識別碼或數字轉換成猜測的資料類型。
文字也會視為內容,而非作用中的標記。看似指令碼的字串會顯示為可見文字,而 SVG 中的字串會經過 XML 轉義。建立圖片時,無效的 XML 控制字元會遭到取代。如果預覽值包含非預期的內容,請檢查對應的來源儲存格,不要預期產生器會重新解讀它。
以最終尺寸檢查下載的 SVG
匯出內容是獨立的 SVG,包含明確的寬度、高度、viewBox、image role、無障礙標籤、系統樣式的 Arial 文字,以及固定色彩。它可以在瀏覽器、簡報編輯器、設計應用程式或支援向量圖形的文件工作流程中開啟,實際情況取決於該程式的 SVG 支援程度。
- 將拼字與列對齊情況和原始 CSV 比較。
- 找出在 30 個字元顯示上限遭截斷的圖片標籤。
- 檢查極寬的欄位是否需要水平捲動。
- 測試緊湊文字在最終嵌入尺寸下是否仍可閱讀。
- 因為 SVG 使用固定色彩,請在目標位置檢查色彩對比。
- 檢查最終實體尺寸,不要只根據大型預覽判斷。
此圖片不保證具備印刷無障礙性。如果目標程式對 SVG 的處理方式不同,請直接開啟下載的檔案,進行另一項檢查。請將來源 CSV 保留為可編輯記錄,因為關閉分頁後,頁面產生的內容都不會保留。
判斷表格圖表是否為合適的輸出
當標籤與值的確切文字比繪製趨勢更重要時,表格圖表最有用。它可以呈現計分卡、排程、功能比較、小型目錄、價目表、活動摘要、研究快照或社群圖像,而不會賦予值任何意義。
如果結果看起來有誤,是因為你預期看到趨勢,問題可能在圖表類型而非 CSV。長條圖或圓餅圖可能能更快速傳達數值大小,而甘特圖可能更適合呈現具有開始與結束日期的任務。此工具不會從資料推斷合適的視覺化方式。你可以先比較表格、圖表與甘特圖方法,再變更來源格式。
執行最終正確性檢查
發布前,請確認以下各項:
- 原始 CSV 仍可使用,並作為權威的可編輯檔案。
- 來源具有一列有效的標題列,且各列寬度一致。
- 包含逗號或換行符號的儲存格已正確加上引號。
- 列數與欄數均落在支援範圍內。
- 預覽中的每個儲存格都與來源相符。
- 任何較短的 SVG 標籤,都應理解為有文件記載的 30 個字元圖片上限。
- 最終 SVG 在發布尺寸下仍可閱讀且對齊。
如果來源與預覽相符,就已確認解析階段無誤。如果只有下載的素材看起來有誤,請檢查截斷、尺寸、欄位密度與目標呈現方式,不要變更底層值。需要修正來源時,請在 CSV 中進行修正、重新產生、再次比對每個預覽儲存格,然後下載新的 SVG。