@font-faceの書き方|woff2・woff・ttfの順番

Webフォントファイルをダウンロードしてサイトに適用するには、@font-faceルールを書く必要があります。ただ、srcの中にwoff2・woff・ttfをどの順番で並べればいいのか、font-familyにどうして引用符が必要なのか、ここでよく迷います。この順番と文法は、気まぐれに決まった慣習ではなく、ブラウザがCSSを読む仕組みそのものから出てきたルールです。その動作原理を、コードの構造を中心に一つずつ見ていきます。
まとめ ① srcのリストは、ブラウザが上から順に読み、対応している最初のフォーマットのところで止まるため、woff2 → woff → truetypeの順番が固定されます。 ② font-familyの名前は、空白や予約語との衝突を避けるために引用符で囲むのが安全です。 ③ font-display: swapは、フォントが読み込まれる前に代替フォントで先にテキストを表示し、読み込みが終わったら指定したフォントに切り替えます。
Webフォントを3つダウンロードしたあと、ここで手が止まります
フォントファイルをWeb用に変換してくれるサイトやダウンロードツールを使うと、たいてい.woff2、.woff、.ttfの3つが一緒に出てきます。ブラウザごとに対応フォーマットが違うため、どれか1つだけを入れるのではなく、3つすべてをCSSにつなぐ必要があります。
問題はここからです。検索して出てくるサンプルはどれもsrcの中の順番がばらばらで、中にはttfを一番上に置いているものもあります。順番を変えて書いてもブラウザはエラーを出さず、黙ってフォントを読み込むので、目で見て何が間違っているのかすぐには分かりません。
font-familyに引用符を付けるべきなのか、font-weightを実際のファイルと違う値にしてもいいのかも、同じように曖昧です。その結果はたいてい、「適用されたような気もするし、元のフォントのままのような気もする」という、はっきりしない画面として残ります。
ツールを使わずに@font-faceのコードを自分で書く方法
@font-faceルールは、フォント名を宣言し、その名前に紐づけるファイルのリスト(src)とウェイト・スタイルの情報を付ける構造です。基本の形は次のとおりです。
@font-face {
font-family: "Pretendard";
src: url("/fonts/pretendard.woff2") format("woff2"),
url("/fonts/pretendard.woff") format("woff"),
url("/fonts/pretendard.ttf") format("truetype");
font-weight: 400;
font-style: normal;
font-display: swap;
}
この構造の中で、順番と文法がなぜこうなっていなければならないのかを一つずつ見ていきます。
srcの順番がwoff2 → woff → truetypeに固定される理由
src属性には、カンマで区切ったurl()・format()のペアを複数並べられます。ブラウザはこのリストを上から順に読み、自分が対応している最初のフォーマットを見つけたら、そのファイルだけをダウンロードして残りは無視します。
つまり、並べた順番がそのまま優先順位になります。WOFF2は圧縮率が高くファイルサイズが最も小さく、WOFFはそれより古いものの対応範囲が広く、TTF(TrueType)は最も古いフォールバック用のフォーマットです。woff2を一番上に置けば、それに対応しているブラウザは最も軽いファイルを受け取り、対応していない環境だけが次の行に進んでwoffを、それもだめならttfを受け取ります。
順番を逆にしてttfを一番上に置くと、ttfもほとんどのブラウザが対応しているフォーマットなので、リストの最初の行でそのまま止まってしまいます。結果として、woff2に対応している最新ブラウザまで、より重いttfファイルを受け取ることになります。ブラウザから見ればエラーではなく、指定された順番にそのまま従っただけなので、コンソールに警告も出ません。
font-familyに引用符を付ける理由
font-familyの値は、CSSでは2通りの書き方ができます。引用符を付けずに識別子(identifier)として書くか、引用符で囲んだ文字列(string)として書くかです。
識別子として書く場合、空白を含む名前は複数の単語に分割されて解釈されるおそれがあり、数字で始まる名前やsans-serif・inheritのようなCSS予約語と重なる名前はパースエラーにつながることがあります。引用符で囲めば、そうした問題もなく、名前全体が1つの文字列として正確に渡ります。
ですから、フォント名にスペースがなくても引用符を付ける習慣が安全です。上の例で"Pretendard"を引用符で囲んでいるのもこのためです。
font-display: swapがレンダリングで実際にしていること
font-displayは、Webフォントファイルがまだダウンロードされていない短い時間に、ブラウザがテキストをどう表示するかを決めるプロパティです。swapを指定すると、ブラウザはフォントを待たずにすぐさま代替フォント(フォールバックフォント)でテキストを先に描画します。
そのあと指定したWebフォントの読み込みが終わると、すでに描画されたテキストをそのフォントに置き換えます。font-displayを指定しないと、ブラウザの既定の動作に従い、フォントが読み込まれるまでテキストが見えない待ち時間が生じることがありますが、swapはこの待ち時間を実質的になくし、テキストが常に先に見えるようにする値です。
ただし、フォールバックフォントと実際のフォントで文字の幅が違うと、切り替わる瞬間に改行や配置がわずかに動くのが分かります。テキストが遅れて現れるより、すぐ見えるほうがよいとき、swapを使います。
srcの順番、引用符、font-displayまで構造を理解しても、フォント名と3つのファイルパスを毎回手でそろえて書くのは面倒です。この工程は、私たちの無料ツールですぐに確認できます。
フォント名とファイルのパスを入力するだけで、順番が正しい@font-faceコードがリアルタイムに生成されます。サーバーへの送信はなく、ブラウザ内だけで処理されます。

実際にフォントが表示されない3つのミス
文法エラーもなくコードがそのまま動いているように見えてもフォントが適用されない場合、ほとんどは次の3つのどれかです。
| ミス | 何が起きるか |
|---|---|
| srcの順番を逆にする(ttfを一番上) | 最新ブラウザもリストの最初の行で止まり、より重いttfをそのまま受け取る |
| format()の名前が実際のファイル拡張子と違う | ブラウザがヒントだけを見てフォーマットを判断し、その行を飛ばすかファイルを読めない |
| font-weight・font-styleが実際のファイルと違う | 宣言したウェイト・スタイルでテキストを探すときにこのフォントがマッチせず、フォールバックフォントや合成ボールドが代わりに使われる |
format()の名前は、ブラウザがファイルを開く前にまず参照するヒントです。実際には.woff2ファイルなのにformat("woff")と書いておくと、ブラウザはこの行を対応していないフォーマットと判断して飛ばし、次の行に進むことがあります。ファイル自体は問題ないのに、コードのラベルが間違っているせいで読み込まれないケースです。
font-weightも同じです。ブラウザはファイルを開いて実際のウェイトを確かめるのではなく、CSSに書かれた数字をそのまま信じます。Boldファイルを置いておいてfont-weight: 400と宣言すると、font-weight: 700を要求するテキストにはこのフォントが紐づかず、フォールバックフォントやブラウザが勝手に合成したボールドが代わりに使われます。
まとめ
- srcの順番は慣習ではなく、ブラウザが対応している最初のフォーマットで止まる動作原理によってwoff2 → woff → truetypeに固定されます。
- font-familyは、空白や予約語との衝突を防ぐために引用符で囲むのが安全です。
- font-display: swapは、フォントの読み込みを待たずに代替フォントで先に見せてから置き換える方式です。
- format()の値は実際のファイル拡張子と、font-weight・font-styleは実際のファイルのウェイト・スタイルと正確に一致させないと、フォントが正しく紐づきません。
- この4つさえ守れば、専用のツールがなくても正確な@font-faceコードを自分で書けます。
フォント名とファイルのパスを入力するだけで、順番が正しい@font-faceコードがリアルタイムに生成されます。サーバーへの送信はなく、ブラウザ内だけで処理されます。
よくある質問
woff2ファイルを1つだけ置けばよいですか?
対応ブラウザを最新のものに絞るのであれば可能です。ただし古いブラウザまで考慮するなら、woffをフォールバックとして併記するのが安全です。ttfは、ごく古い環境までサポートする必要がある場合にだけ追加するフォーマットです。
format() の中の文字列はファイル名をそのまま書くのですか?
いいえ。format() にはCSS仕様で定められた値(woff2、woff、truetype、opentype など)を書きます。ただし、その値は実際のファイルのフォーマットと一致している必要があります。.ttf ファイルなら format("truetype")、.otf ファイルなら format("opentype") を使います。
ウェイトの異なるフォントファイルが複数ある場合はどう宣言しますか?
同じ font-family 名で、ウェイトの異なるファイルごとに @font-face ルールをそれぞれ個別に宣言します。Regular ファイルは font-weight: 400、Bold ファイルは font-weight: 700 と宣言しておけば、ブラウザは実際に使われた font-weight の値に合うルールを選んで適用します。
font-display には swap 以外の値もありますか?
auto、block、swap、fallback、optional の5つの値があります。block はフォントを短時間待ってからテキストを描画し、swap は待たずに代替フォントで先に描画してから差し替えます。テキストをできるだけ早く表示したいなら swap、フォントの読み込み後に表示が突然切り替わる様子自体を抑えたいなら block を検討します。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む