SVGをReactコンポーネントに変換する書き換え規則

公開ツールSVG to React JSX 変換器

目次
  1. 貼り付けるとアイコンは表示されるのに、コンソールが警告でいっぱいになる
  2. ツールを使わずに自分で変換する方法
  3. 間違えやすいポイント
  4. まとめ
  5. よくある質問

デザインツールやアイコンサイトでコピーしたSVGコードをReact・Next.jsコンポーネントの中にそのまま貼り付けると、アイコンは画面に表示されても、コンソールにはstroke-widthやclassといった属性に関する警告がずらりと表示されます。コードが間違っているわけではなく、JSXが属性名をHTML・XMLとは異なる規則(キャメルケース)で解釈するためです。この記事では、その違いをルールの表にまとめ、変換ツールが実際に何を変えるのかを、確認できる事実だけをもとに説明します。

まとめ ① JSXは属性名をキャメルケースで解釈するため、class→className、stroke-width→strokeWidthのように変更しないと警告は消えません。 ② 変換ツールは<svg>の開始タグの末尾に{...props}を追加し、呼び出し側でclassName・fill・width・heightを渡してスタイルを制御できるようにします。 ③ コンポーネント名は英数字以外の文字がすべて削除されるため、「ハート アイコン」ではなくHeartIconのような英字のパスカルケースで指定する必要があります。

貼り付けるとアイコンは表示されるのに、コンソールが警告でいっぱいになる

Figmaでアイコンをコピーしたり、アイコンサイトからSVGをダウンロードしたりして、.tsxファイルのreturnの中にそのまま貼り付ける場面を思い浮かべてみましょう。画面にはアイコンが正常に表示されます。問題はデベロッパーツールのコンソールです。

Reactの開発モードでは、こうしたときに概ね次のような警告が出力されます。

Warning: Invalid DOM property `stroke-width`. Did you mean `strokeWidth`?
Warning: Invalid DOM property `class`. Did you mean `className`?

つまりReactは「この属性名はJSXで使う名前ではない」と知らせると同時に、正しいキャメルケース名も提案してくれます。特にCSSクラスは、JSXではclassではなくclassNameで指定するのが標準です。class="icon-heart"をそのままにすると、警告とともに、スタイルが意図どおりに適用されない可能性があります。

これらの警告は1つずつ手作業で修正できます。ただし、1つのアイコンにpathが複数あり、属性が数十個あると、どれをキャメルケースにすべきか毎回目で探すのは手間です。ルール自体は単純なので、まずはそのルールから整理します。

ツールを使わずに自分で変換する方法

この変換はすべて手作業で行えます。手順は次のとおりです。

ステップ1:コンポーネントで囲みます。 SVGマークアップを関数コンポーネントが返す(returnする)ように囲みます。関数名は必ず大文字で始める必要があります。JSXでは小文字で始まるタグをHTML要素、大文字で始まるタグをコンポーネントとして区別するためです。

ステップ2:ハイフンを含む属性をキャメルケースに変えます。 下の表の左側を右側に変えます。Reactがコンソールで「Did you mean …?」と提案する名前が、まさに右側の名前です。

変換前のSVG属性JSX(React)の属性
classclassName
stroke-widthstrokeWidth
stroke-linecapstrokeLinecap
stroke-linejoinstrokeLinejoin
stroke-miterlimitstrokeMiterlimit
stroke-dasharraystrokeDasharray
stroke-dashoffsetstrokeDashoffset
stroke-opacitystrokeOpacity
fill-rulefillRule
fill-opacityfillOpacity
clip-ruleclipRule
stop-colorstopColor
stop-opacitystopOpacity
font-familyfontFamily
font-sizefontSize
font-weightfontWeight
xmlns:xlinkxmlnsXlink
xlink:hrefxlinkHref

ステップ3:<?xml … ?>宣言とコメントを削除します。 SVGファイルの先頭にあるXML宣言と<!-- … -->コメントは、JSXの文法ではそのまま使えません。JSXのコメントは{/* … */}の形式なので、HTMLコメントを残しておくと構文エラーになります。そのため、いっそ削除しておくほうが安全です。

ステップ4:インラインのstyle文字列をオブジェクトに変えます。 style="color:red"のような文字列は、Reactではオブジェクト(style={{ color: "red" }})にする必要があります。ここは名前だけを変えるのではなく、形式そのものを変える必要がある部分です。

ステップ5:必要に応じて{...props}を付けます。 <svg>の開始タグの末尾に{...props}を入れると、このコンポーネントを使うときにclassName・fill・width・heightなどの値を渡し、外部からスタイルを制御できます。

核心となるルールは、ステップ2の表1つで完結します。ただし、pathが多い複雑なアイコンほど手作業では漏れやすく、そのたびにコンソールの警告を確認して修正する作業が繰り返されます。下記の「SVG to React JSX 変換器」に貼り付ければ、この工程を一度に確認できます。

SVG to React JSX 変換器

会員登録なしで、ブラウザ上でSVGを貼り付けてTypeScriptのReactコンポーネントに変換できます。入力がサーバーに送信されることはなく、画面内でそのまま処理されます。

間違えやすいポイント

変換せずにそのまま貼り付ける。 最もよくあるケースです。先ほど見たとおり、stroke-widthやclassといった属性がコンソール警告を引き起こし、キャメルケースに変えれば消えます。この変換ツールは、上の表の18個の属性を一度に変換します。

コンポーネント名のルール。 変換ツールは、名前に含まれる英数字以外の文字をすべて削除します(空白・ハイフン・アンダースコア・日本語の文字など)。また、先頭の文字を大文字に変換するわけでもありません。そのため、大文字で始まる英字のパスカルケースを自分で入力する必要があります。

入力した名前実際に生成される名前
HeartIconHeartIcon
heart-iconhearticon
my_icon 2myicon2
ハート アイコンIconComponent

「ハート アイコン」のように日本語と空白だけを入力すると、残る文字がないためIconComponentに置き換えられます。heart-iconのように小文字で始めると、ハイフンだけが除かれたhearticonになりますが、このように小文字で始まる名前は、JSXがコンポーネントではなくHTMLタグとして扱うため、レンダリング時に問題が発生します。そのため、HeartIconのように大文字で始める必要があります。

{...props}が付く位置。 変換ツールは、{...props}を<svg>の開始タグの最後に追加します。つまり、元の属性が先に来て、{...props}が後ろに続きます。JSXでは同じ名前が重複すると、後ろにある値が優先されます。そのため、<HeartIcon fill="red" />のように渡すと、元のfillの値は渡した値で上書きされます。反対に、何も渡さなければ元の属性がデフォルト値として残ります。

もう1点補足します。classNameを渡すと、元のclassから変換されたclassNameと結合されるのではなく、まるごと置き換えられます。元のクラスを維持したままクラスを追加したい場合は、渡すclassNameに元のクラスも一緒に記述する必要があります。

インラインのstyle文字列。 この変換ツールが変換するのは、上の表にある属性名までです。style="…"のような文字列はそのまま残ります。Reactはstyleに文字列ではなくオブジェクトを求めるため、インラインスタイルを含むSVGの場合は、その部分を自分でオブジェクトに変換する必要があります。

まとめ

  • JSXは属性名をキャメルケースで読み取ります。class→className、stroke-width→strokeWidth のように書き換えないと、コンソールに警告が出ます。
  • ルールは表1つで済みます。変換ツールはその18個のハイフン付き属性・XML属性をまとめてキャメルケースに変換します。
  • <svg> の開始タグの末尾に {...props} が付くため、呼び出し側から className・fill・width・height を渡してスタイルを制御できます。渡した値は元の記述を上書きします。
  • コンポーネント名には英数字だけが残り、先頭の大文字は自分で入れる必要があります。ハングルや空白だけを入れると IconComponent に置き換えられます。
  • <?xml?> 宣言とコメントはJSXでは使えないため削除されます。インラインの style 文字列は、別途オブジェクトに変換する必要があります。
SVG to React JSX 変換器

会員登録なしで、ブラウザ上でSVGを貼り付けてTypeScriptのReactコンポーネントに変換できます。入力がサーバーに送信されることはなく、画面内でそのまま処理されます。

よくある質問

SVGをReactにそのまま貼り付けると、なぜ警告が出るのですか?

JSXは属性名を、HTMLやXMLのようなハイフン区切りではなくキャメルケース(例: strokeWidth)で読み取るからです。Reactの開発モードでは stroke-width のような属性に出会うと、「Did you mean strokeWidth?」という形で正しい名前を提案してくれます。名前をキャメルケースに変えるだけで警告は消えます。

コンポーネント名にハングルや空白を入れても大丈夫ですか?

入れると、その文字はすべて削除されます。変換ツールは名前に含まれる英字と数字だけを残すため、「ハート アイコン」のようにハングルと空白だけを入れると残る文字がなくなり、IconComponent に置き換えられます。HeartIcon のように大文字で始まる英字のパスカルケースで指定するのが安全です。

変換したコンポーネントで色やサイズを変えるにはどうすればいいですか?

変換されたコンポーネントは <svg> の開始タグに {...props} が付いているので、使うときに値を渡すだけです。たとえば <HeartIcon fill="red" width={48} className="my-icon" /> のように渡すと、その値が元の属性を上書きします。{...props} がタグの末尾にあるため、渡した値が元の記述より後ろに置かれるからです。

貼り付けるSVGにコメントやXML宣言があっても大丈夫ですか?

問題ありません。変換ツールが <?xml … ?> 宣言と <!-- … --> コメントを自動で削除します。この2つはJSXの文法ではそのまま置けず(コメントは {/* … */} の形にする必要があります)、残しておくとエラーになるため、変換の過程で取り除かれます。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. テキストを2進数に変換する仕組み|UTF-8とバイト数入力した文字がUTF-8でどう0と1になるかを、英字1・ハングル3・絵文字4バイトの理由とともに解説。8桁の2進数・2桁の16進数の規則や復元が失敗する条件も、無料ツールで確認できます。
  2. テキスト比較の読み方|緑・赤・灰色の意味と仕組み2つのテキストを比較すると、追加は緑、削除は赤、そのままは灰色で表示されます。共通する行を先に探すLCSの仕組みと、1文字直しただけで行全体が削除・追加に見える理由まで、結果の読み方を整理しました。
  3. Excel CSVの文字化けを直す|CP949・UTF-8で復元エクセルで韓国語のCSVが「뷁뷁」や「���」になるのはなぜかをエンコーディングの仕組みから解説。CP949・EUC-KR・UTF-8・BOMの違いと、元の文字に戻す手順をまとめています。
  4. 改行を削除してテキストを1行にまとめる方法PDFやWebからコピーした文章に混ざる改行を、スペース1つに置き換えて1行にまとめる方法を解説。N文字ごとの改行挿入やword-wrapの違い、置換文字の選び方の注意点まで例で確認できます。
  5. テキストの文字数を揃える|パディングの計算と動作複数行のテキストを同じ文字数に揃えるとき、左・右・両側のどこに詰めるか、文字数の数え方、超えた行の扱いを例で確認します。表計算ソフトで使う式も紹介します。
  6. テキスト反転のやり方|文字・単語・行の違いを比較入力した文章を文字・単語・行の3つの単位で反転した結果を例で比較します。絵文字やハングルが崩れない理由(Unicodeのコードポイント処理)と、文字単位と単語単位を混同しがちな点も解説します。

関連ツール