ReactとViteで、SVGをコンポーネントとして読み込む方法
Vite の React プロジェクトで SVG ファイルを import すると、受け取れるのはコンポーネントではなく URL の文字列です。<BellIcon /> のように書いてアイコンの色を文字色に合わせたり、大きさを props で変えたりしたいときは、vite-plugin-svgr を入れて、import のパスの末尾に ?react を付けます。
私は npm create vite の react-ts テンプレートで作ったプロジェクトに、線で描いたベルのアイコンと、黒で塗った丸のバッジのアイコンを置き、型チェック、開発サーバー、ビルドの結果を確かめました。
検証環境は Ubuntu 24.04、Node.js 22.23.4、Chromium 153 です。使ったのは Vite 8.3.8、@vitejs/plugin-react 6.3.0、React 19.3.1、TypeScript 7.0.2、vite-plugin-svgr 5.2.0(中で使われる @svgr/core 8.1.0)です。表示の確認には Playwright 1.63.0 を使いました。Firefox と Safari、スクリーンリーダーでの読み上げ、?react を付けずに読み込む設定(include の変更)は試していません。
Vite のままでは SVG は URL として読み込まれる
Vite は、画像などのファイルを import すると、そのファイルの URL を返します。Vite の静的アセットの説明にあるとおりで、SVG も同じ扱いです。
import bellUrl from './icons/bell.svg'
// bellUrl は文字列。<img> の src に渡して使う
<img src={bellUrl} alt="通知" width={48} height={48} />
検証で使ったベルのアイコンは 259 バイトでした。ビルドすると dist/assets に SVG のファイルは出ず、JavaScript の中に data:image/svg+xml,%3csvg%20xmlns=... という data URL として埋め込まれていました。build.assetsInlineLimit の既定の 4096 バイト(4 KiB)より小さいファイルは、別のファイルにせず埋め込まれるためです。
<img> で表示した SVG は、ページの CSS から中の線や塗りを変えられません。アイコンの SVG に stroke="currentColor" と書いてあっても、親の color は届かず、黒のままでした(後に載せる画像の1段目)。
プラグインなしで ?react を付けるとどうなるか
vite-plugin-svgr を入れる前に ?react を付けて読み込むと、まず型チェックで止まります。
import BellIcon from './icons/bell.svg?react'
$ npx tsc -b
src/App.tsx(1,22): error TS2307: Cannot find module './icons/bell.svg?react' or its corresponding type declarations.
型チェックを飛ばして npx vite build だけを実行すると、ビルドは通りました。開発サーバーでページを開くと、画面には何も表示されず、ブラウザに次のエラーが出ました(data URL の途中は省略しています)。
Failed to execute 'createElement' on 'Document': The tag name provided ('data:image/svg+xml,%3csvg%20xmlns=...%3c/svg%3e') is not a valid name.
?react を解釈するものがないので、BellIcon には URL の文字列が入ります。React はそれをタグの名前として要素を作ろうとして、失敗しています。
vite-plugin-svgr を入れて設定する
vite-plugin-svgr は、SVG を React コンポーネントに変える SVGR を Vite から使うためのプラグインです。開発用の依存として入れます。
npm install -D vite-plugin-svgr
vite.config.ts の plugins に svgr() を足します。
import react from '@vitejs/plugin-react'
import { defineConfig } from 'vite'
import svgr from 'vite-plugin-svgr'
// https://vite.dev/config/
export default defineConfig({
plugins: [react(), svgr()],
})
これだけでは、TypeScript は ?react の付いたパスの型を知らないので、先ほどと同じ TS2307 が出たままでした。vite-plugin-svgr の README は、vite-env.d.ts に /// <reference types="vite-plugin-svgr/client" /> を書く方法を案内しています。
今回のテンプレートには vite-env.d.ts がなく、tsconfig.app.json の types に vite/client が書かれていました。Vite の説明によると、types を指定すると、そこに書いたものだけがグローバルな型として読み込まれます。そこで、同じ配列に vite-plugin-svgr/client を足しました。
"types": ["vite/client", "vite-plugin-svgr/client"],
これで npx tsc -b のエラーは消えました。vite-plugin-svgr/client の中身は、*.svg?react を、<svg> 要素の props(と title など)を受け取る関数コンポーネントとして宣言するものです。
大きさと色を props や CSS で変える
プラグインを入れた後は、?react を付けて読み込んだものを、ふつうのコンポーネントとして使えます。
import BellIcon from './icons/bell.svg?react'
<BellIcon />
<BellIcon width={48} height={48} />
<BellIcon className="icon" />
開発サーバーが返した変換後のコードを見ると、SVG ファイルの属性を並べた後ろに ...props が置かれていました。
const SvgBell = (props) => /* @__PURE__ */ _jsxs("svg", {
xmlns: "http://www.w3.org/2000/svg",
width: 24,
height: 24,
viewBox: "0 0 24 24",
fill: "none",
stroke: "currentColor",
...
...props,
children: [/* @__PURE__ */ _jsx("path", { d: "M6 16V11a6 6 0 0 1 12 0v5l2 2H4z" }), /* @__PURE__ */ _jsx("path", { d: "M10 21h4" })]
});
(strokeWidth などの行は省略しています。)
そのため、渡した props が SVG ファイルに書いてある値より優先されます。何も渡さない <BellIcon /> はファイルどおりの 24×24 ピクセル、width={48} height={48} を渡すと 48×48 ピクセルで表示されました。className を渡して CSS で width: 48px; height: 48px; を指定した場合も 48×48 ピクセルになり、width="24" の属性より CSS が優先されました。
色は、SVG の中で currentColor を使っていれば、親の color がそのまま届きます。親の要素に color: #d85878 を指定すると、ベルの線は同じピンクで描かれました。

塗りの色が固定された SVG は、replaceAttrValues で currentColor にする
コンポーネントにしても、SVG の中に fill="#000000" のように色が直接書いてあると、親の color を変えても色は変わりません。検証のバッジのアイコンは、親をピンクにしても、丸は黒のままでした。
SVG ファイルを1つずつ書き換える代わりに、SVGR の replaceAttrValues で、変換するときに値を置き換えられます。vite-plugin-svgr では svgrOptions に書きます。
svgr({
svgrOptions: {
replaceAttrValues: { '#000000': 'currentColor' },
},
}),
変換後のコードでは、丸の fill が "currentColor" に変わり、白のチェックの stroke: "#ffffff" はそのまま残りました。画面でも、丸だけが親の色のピンクになりました(上の画像の3段目)。
アイコンにアクセシブルな名前を付ける
ボタンの文字と並べる飾りのアイコンは、aria-hidden="true" を渡して読み上げの対象から外せます。アイコンだけで意味を伝えるときは、role="img" と aria-label を渡します。Chromium のアクセシビリティツリーでは、次のように見えていました。
- paragraph:
- button "通知"
- img "通知があります"
- img "通知"
3行目は title="通知" を渡したアイコンです。title も props の型に入っていますが、既定の設定では、<svg title="通知"> のように svg の属性として出力されました。Chromium のツリーでは img "通知" と出ましたが、SVG の <title> 要素にはなりません。<title> 要素で名前を付けたいときは、SVGR の titleProp を true にします。
svgr({
svgrOptions: {
titleProp: true,
},
}),
この設定で <BellIcon title="通知" /> と書くと、<svg ...><title>通知</title><path .../>...</svg> のように、<title> 要素が中に入りました。
ビルドすると、SVG はコンポーネントのコードとして JavaScript に入る
?react で読み込んだ SVG は、ビルドしても SVG のファイルとして dist/assets に出ません。JavaScript のファイルの中に、パスの d 属性の値(M6 16V11…)を含むコンポーネントのコードとして入っていました。
$ ls dist/assets
index-CPOT8Xb7.js
index-d7fNLeU5.css
vite preview でビルドしたものを開くと、アイコンは描画され、アクセシビリティツリーも開発サーバーのときと同じでした。ブラウザのエラーもありませんでした。同じ SVG を <img> 用の URL とコンポーネントの両方で読み込むこともでき、そのときは data URL とコンポーネントのコードの両方が JavaScript に入ります。





