條形圖製作工具接受 2 到 30 列嚴格的「標籤,值」格式,並產生一張垂直條形圖,其類別標籤最多支援 24 個 UTF-16 碼元,其數值標記最多支援 40 個字元的一般十進位或科學記號表示,而匯出的 SVG 高度固定維持在 520 像素,並隨著新增列數而水平展開。旋轉的類別文字能讓像「Q3 顧客滿意度」這樣的長片語保持清晰可讀,而不會擠壓到相鄰的長條;y 軸使用 1、2、5 或 10 與 10 的冪次相乘的倍數作為上限刻度,使刻度在螢幕上和列印時都能清楚閱讀。五個等距的參考刻度顯示完整範圍,每根長條上的工具提示都會回報其原始數值,因此即使畫在基線上的長條仍能傳達其真實高度。由於同一段產生的 SVG 字串同時驅動可見的預覽和 Blob 下載,因此您儲存的檔案與您審閱過的標記完全一致。所有解析、縮放、跳脫與繪製動作都在當前的瀏覽器分頁中執行;不會上傳任何標籤、數值、標題或 SVG 標記。

bar chart maker large text
條形圖製作工具放大文字:保持清晰的長標籤

「放大文字」對條形圖製作工具而言究竟意味著什麼

尋找能處理放大文字之條形圖製作工具的使用者,通常是在解決三個相關問題之一:多字詞組成的類別標籤必須保持可讀、圖表將用於簡報、海報或列印講義且每個字都必須明顯放大,或是工具必須能消化大量貼上的資料集而不當機。條形圖製作工具將這三者視為同一個問題,為每個類別標籤提供最多 24 個 UTF-16 碼元,將長標籤旋轉以利閱讀,並讓 SVG 隨著新增列數而水平展開。圖表高度固定維持在 520 像素,讓各專案中長條的比例保持熟悉;較寬的輸出則在預覽區中水平捲動,而不是把 30 個標籤硬塞進行動裝置的寬度。類別欄位始終保持分隔,這在文字長度逐列不同的情況下格外重要。

列格式與各欄位長度限制

每個非空白的列必須剛好包含一個逗號,標籤在前,數值標記在後。解析器會忽略空白或僅含空白的行,並修剪標籤與數值前後的空白;只要任何一列格式錯誤,就會拒絕整個請求。它不會只保留前 30 列、跳過錯誤的列、替換為零,或是顯示部分圖表。標籤以 UTF-16 碼元計算,與瀏覽器計算 textarea 限制的方式相同,嚴格上限為 24 個碼元。數值標記以 40 字元為上限,可以使用一般十進位(如 12.5)或科學記號(如 1.2e10)。不支援引號欄位、引號內的逗號、額外的欄位、空標籤、輸入的單位、運算式、十六進位、Infinity 與 NaN。重複的標籤會依輸入順序保留為各自獨立的長條;工具不會進行彙總、排序或推測單位。

透過簡短的對照表,可以幫助您在貼上任何資料前,釐清哪些輸入會被接受、哪些會被拒絕。

輸入格式結果原因
只有一個逗號的 label,value接受嚴格的簡易 CSV 列格式
逗號後的值為空拒絕必須有數值標記
標籤中含有逗號拒絕每列僅允許一個逗號
科學記號表示的值 (1.2e10)接受支援一般十進位或 e/E 格式
負數、Infinity 或 NaN拒絕數值必須為非負有限十進位數
標籤超過 24 個 UTF-16 碼元拒絕嚴格的標籤長度上限,不進行截斷
31 列或以上的非空白列拒絕硬性上限為 30 列非空白資料
重複的標籤接受重複標籤依輸入順序保留為各自獨立

從放大文字標籤建立圖表

  1. 開啟條形圖製作工具,並以一般文字加入可選的標題。即使可見標題留白,仍會收到無障礙標籤「Bar chart」,讓螢幕閱讀器能描述此圖。
  2. 以嚴格的 label,value 格式貼上 2 到 30 列非空白資料,每列剛好一個逗號。每個標籤與數值的前後空白會自動修剪。
  3. 點擊產生。預覽會以類別標籤、y 軸上五個等距參考刻度、零基線,以及每根長條顯示原始數值的工具提示重新建立,因此畫在基線上的長條仍能傳達其真實高度。
  4. 確認基線位於零,並確認顯示的軸上限為四捨五入後的 1/2/5/10 整數域上限。
  5. 下載獨立的 SVG。它由用於繪製可見預覽的同一段字串建立,因此檔案與您審閱過的標記一致。

旋轉標籤、工具提示與可展開的 SVG

擠進狹窄視窗的垂直條形圖,會讓「Annual Subscribers」或「Top Referral Source」等多字標籤與相鄰的標籤重疊。為避免這種情況,條形圖製作工具會旋轉類別標籤,讓每行文字各自佔有自己的位置,而不是爭奪水平空間。當您加入超出舒適合度的更多列時,圖表會在預覽區內水平展開並可捲動;絕不會將標籤壓縮進行動裝置的寬度。每根接受的長條都會顯示回報其原始數值的工具提示,這代表即使畫在基線上的長條仍能傳達其真實高度。軸標籤最多使用六位有效數字或科學記號表示,上限會四捨五入為 1、2、5 或 10 與 10 的冪次相乘的有限倍數。其結果是一張可預期的整數域圖表,閱讀清晰,但並不保證重現特定的 D3 刻度選擇;如需關於選擇刻度的一般指引,請參閱選擇刻度與標籤的條形圖最佳實務。

當線性縮放讓長條消失時

極值範圍下的線性比例可能小於 SVG 座標精度。如果您貼上 0.0001 和 1e12 這類數值,較小的長條會畫在基線上,即使解析器已接受它。工具提示仍會回報其真實數值,圖表也不會虛構一條最小高度的長條,因為這樣會破壞既定的線性刻度。全為零的資料集使用明確的 0 到 1 參考範圍,將所有長條高度保持在基線上的零,並顯示一則全為零的註記——這是為了避免除以零所做的明確決定,而不是推測您的資料缺失。支援從 1e-300 到 1e300 的非零數值;會下溢為零的詞法非零輸入,以及超過最大值的輸入會被拒絕。當極小的類別必須在比其大數百個數量級的值旁仍然可見時,請改用對數或分別分組的圖表;條形圖製作工具是為線性比較而打造,而非對數壓縮。

無障礙功能、XML 跳脫與獨立 SVG

每個使用者字串(包括標籤、標題、工具提示與無障礙文字)在進入 SVG 之前都會進行 XML 跳脫。& 符號會成為實體參考,角括號會變成 < 與 >,引號與撇號也會進行實體編碼。XML 不允許的控制字元與未配對的代理項會被取代為 U+FFFD,因此格式錯誤的貼上內容無法將標記注入匯出的檔案中。數值座標僅來自已驗證的有限值,並四捨五入至小數點後三位以供標記使用。輸出使用 W3C SVG 命名空間,以及如W3C SVG 2 規格中記載的標準 rect、line、text、g 與 title 元素。即使可見的標題欄位留白,仍會始終存在一個無障礙的 title 元素。由於線性刻度的行為遵循D3 線性刻度參考中 1/2/5/10 整數域的方式,當您比較連續的匯出檔案時,圖表會保持可預期。

常見的長標籤情境

當類別標籤很長時,會出現三種反覆出現的模式。像「January 2025 Sales」或「Q3 Customer Satisfaction」這類時間序列標籤,在 24 字元的上限內可舒適地容納,並為可讀性而旋轉。像「Top Referral Source」或「Highest Bounce Rate Page」這類多字描述性標籤,在同樣的 24 個 UTF-16 碼元上限下也會為可讀性而旋轉,與其他所有標籤相同。像「SKU-9381-AB」或「REGION-NE-01」這類代碼與識別碼,因為較短而無需旋轉即可保持清晰。如果標籤超過 24 個碼元,產生作業會以明確的原因失敗;解析器絕不會為了符合限制而截斷。如果您有超過 30 個類別,產生作業會以精確的非空白列數失敗,工具絕不會靜默地只保留前 30 個。負的零會在繪製前正規化為零,如此資料中的排版瑕疵不會影響圖表。編輯標題或資料會立即清除先前的預覽、狀態與下載連結,以避免過時的 Blob URL。

延伸閱讀:讚美產生器放大文字:讓詞語醒目呈現。