# 字型

有一些特殊的全域設定可以更改圖表上的所有字型。這些選項位於 Chart.defaults.font 中。全域字型設定僅在設定中沒有包含更具體的選項時才會生效。

例如,在這個圖表中,文字的字型大小將為 16px,圖例中的標籤除外。

Chart.defaults.font.size = 16;
let chart = new Chart(ctx, {
    type: 'line',
    data: data,
    options: {
        plugins: {
            legend: {
                labels: {
                    // This more specific font property overrides the global property
                    font: {
                        size: 14
                    }
                }
            }
        }
    }
});
名稱 類型 預設值 描述
family 字串 "'Helvetica Neue', 'Helvetica', 'Arial', sans-serif" 所有文字的預設字型系列,遵循 CSS font-family 選項。
size 數字 12 文字的預設字型大小(以像素為單位)。不適用於 radialLinear 刻度點標籤。
style 字串 'normal' 預設字型樣式。不適用於工具提示標題或頁尾。不適用於圖表標題。遵循 CSS font-style 選項(即 normal、italic、oblique、initial、inherit)。
weight normal | bold | lighter | bolder | number 未定義 預設字型粗細(粗體)。(請參閱 MDN (在新視窗開啟))。
lineHeight number|string 1.2 單行文字的高度(請參閱 MDN (在新視窗開啟))。

# 遺失的字型

如果為圖表指定的字型在系統上不存在,瀏覽器將不會在設定時套用該字型。如果您注意到圖表中出現奇怪的字型,請檢查您套用的字型是否存在於您的系統上。請參閱 issue 3318 (在新視窗開啟) 以取得更多詳細資訊。

# 載入字型

如果字型未被快取且需要載入,則使用該字型的圖表需要在字型載入後更新。這可以使用 Font Loading APIs (在新視窗開啟) 來完成。請參閱 issue 8020 (在新視窗開啟) 以取得更多詳細資訊。

最後更新: 2024/5/17, 下午 12:33:38