SVG viewBoxとは?アイコンサイズが合わない原因

目次
アイコンライブラリからダウンロードした SVG をボタンに入れてサイズを大きくしたのに、絵はそのままだったり、片隅だけが拡大されて切り取られて見えたりした経験があるでしょう。この現象は CSS の書き間違いではなく、SVG コード内の viewBox の値と width・height 属性がそれぞれ別の役割を担っているために起こります。viewBox の 4 つの数字を読めるようになるだけで、コードを見ただけで原因をすぐに特定できます。
まとめ ① SVG のサイズは、画面に表示される width・height と、図形の座標を収める viewBox の 2 つで別々に決まります。 ② viewBox がないと、ブラウザは width・height の値を座標単位としてそのまま使うため、サイズを大きくしても絵は大きくならず、切り取られたように見えます。 ③ viewBox の 4 つの数字(minX minY width height)を確認すれば、切り取り・余白・移動のどれが原因なのかを切り分けられます。
問題: サイズを大きくしたのに絵が大きくならない理由
アイコンセットから 24×24 サイズの SVG ファイルをダウンロードして、ボタンの中に入れたとします。style="width:64px;height:64px" で大きくしたのにアイコンの形は大きくならず、左上の片隅だけが拡大されたように見えたり、右側や下側が丸ごと切り落とされたりします。
逆に、絵のまわりに理由のない余白ができることもあります。どちらの症状も、CSS をいくらいじっても解決しません。原因が CSS ではなく SVG コードの内部にあるからです。
原因: width・height と viewBox はそれぞれ別の値を決めています
SVG タグには、サイズに関わる値が 2 か所に分かれています。1 つは width・height 属性(または CSS)で、SVG が画面上で占める物理的なサイズを決めます。もう 1 つは viewBox 属性で、その中の circle・rect・path といった図形がどの座標系の上に描かれるかを決めます。
viewBox があれば、ブラウザはこの座標系を物理的なサイズに合わせて自動的に拡大・縮小します。写真を額縁のサイズに合わせて自動でリサイズして収めるのと似ています。そのため width・height の値を変えると、絵全体が比率どおりに大きくも小さくもなります。
問題は viewBox がまったくない場合です。このときブラウザには図形の座標をリサイズする基準がないため、width・height 属性の値を座標単位そのものとして使います。その状態で CSS によって物理的なサイズだけを大きくすると、キャンバス(見える窓)だけが広がり、中の図形は元の座標のままなので、片側に小さく固まって見えたり、切り取られたように見えたりします。
確認方法: コードだけから原因を突き止める
専用のツールがなくても、コードを見るだけで原因は判別できます。
- SVG コードを開き、
<svg ...>タグを探します。 viewBox="..."属性がまったくないなら、それが原因です。既存の width・height 属性の値をそのまま持ってきて、viewBox="0 0 幅 高さ"の形で追加すれば解決します。- viewBox はあるものの、3 番目の数字(幅)や 4 番目の数字(高さ)が実際の図形のサイズより小さいと、絵の一部が切り取られます。
- viewBox の先頭 2 つの数字(minX、minY)が 0 でないと、その分だけ図形が移動して見えます。図形を動かしたのではなく、見える領域(窓)を動かしているのです。
無料ツールで確認する。 この関係を目で確かめたいときは、SVG コードを貼り付けて viewBox の 4 つの数字を 1 つずつ変えてみてください。結果はリアルタイムプレビューにすぐ反映されるので、どの数字が切り取りを生み、どの数字が移動を生むのかを直接比べられます。
無料・登録不要・ブラウザ内だけで処理(サーバー送信なし)

よくつまずくポイント
| 症状 | 原因 |
|---|---|
| サイズを大きくしても絵が大きくならず、片側だけが見える | viewBox 属性そのものが存在しない |
| 絵のまわりに意図しない余白ができる | viewBox の比率と width・height の比率が異なるため、縮小して配置される |
| 絵の一部が切り取られて見える | viewBox の 3・4 番目の数字(幅・高さ)が実際の図形より小さい |
| 絵の位置がおかしくずれて見える | viewBox の 1・2 番目の数字(minX・minY)が 0 ではない |
まとめ
SVG のサイズに関する問題は、ほとんどの場合 viewBox の 4 つの数字のどれかで説明できます。width・height は画面上で見える物理的なサイズだけを決め、図形がその中でどう配置されるかは viewBox が決めます。
この 2 つを同じものだと勘違いすると、原因を CSS の中だけで探して時間を無駄にしてしまいます。コードの中で viewBox の有無と 4 つの数字をまず確認する習慣をつけておけば、アイコンが切り取られたりずれたりする問題のほとんどを素早く絞り込めます。
無料・登録不要・ブラウザ内だけで処理(サーバー送信なし)
よくある質問
viewBox の 4 つの数字はそれぞれ何を意味しますか?
順番に minX、minY、width、height です。先頭の 2 つの数字は、座標系の中で見える領域が始まる地点(左上の基準点)で、後ろの 2 つの数字はその地点からどれだけ広い範囲を見せるかを決めます。図形そのものの座標(circle の cx・cy など)はこの値とは関係なく固定されていて、viewBox はそのうちどの部分をどの倍率で切り取って見せるかだけを決めます。
width・height 属性を削除して viewBox だけ残してもいいですか?
はい、実際に多くのアイコンライブラリがこの方法を使っています。width・height 属性がない場合、SVG は親要素や CSS が指定するサイズをそのまま埋め、図形どうしの比率は viewBox が保ちます。レスポンシブにアイコンサイズを自由に変えたいときによく使われる構成です。
viewBox がない SVG はどう直せばいいですか?
もっとも簡単な方法は、既存の width・height 属性の値をそのまま持ってきて viewBox="0 0 width値 height値" の形で追加することです。たとえば width="24" height="24" であれば viewBox="0 0 24 24" を追加します。そのあと width・height を CSS で変えても、図形の比率を保ったままサイズが調整されます。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む