JSXは特別な文法ではなく、関数呼び出しに変換されているだけです。変換後の姿を見れば、書き方の決まりの理由が分かります。
これは深掘りです。本線の順路ではありません。 本線のコンポーネントの回で props とリフトアップまで進んだ人が、「JSX のこの決まりは、覚えるしかないのか」というところで手が止まったときに読む記事です。飛ばしても本線は進みます。
この記事のコマンドは、すべて Ubuntu Server の中で打ちます。 Windows の PowerShell ではありません。 プロンプトが
ユーザー名@ホスト名:~$になっていれば、Linux の中にいます。 本線で作った~/react-demo/には一切触りません。 この記事は~/reactlab/を新しく作り、最後に丸ごと消します。
本線のフレームワークの回で、こう書きました。
JSX は「関数呼び出しの、見やすい書き方」でしかありません。
あれは、読んで納得しただけでした。 自分は変換後のコードを一度も見ていません。見ていないので、className も htmlFor も key も、結局は暗記した項目として頭に残っていました。暗記した項目は、少し形が変わると使えません。実際、{tasks.length && <p>…</p>} と書いて画面に 0 が出たとき、自分は理由が分からず、0 を消すためだけに条件を書き足しました。
この記事は、JSX の決まりを覚え直す記事ではありません。 JSX を変換器にかけて、出てきた JavaScript を1行ずつ読む記事です。出てきたコードを読めば、以下が全部同じ1つの理由から出てくることが分かります。
| 見た目の決まり | 変換後を見ると |
|---|---|
class ではなく className | オブジェクトのキーとして書かれている。class は予約語 |
key は props に入らない | 第3引数として、props とは別の場所に渡っている |
{} に if が書けない | 変換前に構文エラーになる。React はまだ何もしていない |
0 だけ画面に出る | && が左の値をそのまま返す。0 は「描かない値」に含まれていない |
| 小文字のタグは部品にならない | 文字列 "mybutton" になる。大文字だけが変数参照になる |
この対応表を、自分の手で作ります。
対象レベル: 中級〜上級 / 区分: 発展
この記事でわかること
- JSX の変換には2種類(classic と automatic)あること。
React.createElementを見たことがあるのに、いま自分のコードにimport Reactが無い理由 keyは props ではないこと。props.keyは取れない理由が、変換後の引数の位置で説明できることifが書けないのは React の制限ではなく、変換前の構文エラーであること。式と文の違いが、そのまま JSX の書ける・書けないになっていること- 配列は返せるがオブジェクトは返せないこと。
false/null/undefinedは何も描かないのに0は描かれる理由 childrenも props の1つにすぎないこと。スプレッド{...props}が、ただのオブジェクトの展開であることdangerouslySetInnerHTMLの名前が異常に長いのは、打ちにくくして事故を減らすためだということ<div />と書いた時点では、まだ何も描かれていないこと。それはただのオブジェクトで、描くのは React の仕事だということ
この記事でやること
~/reactlabを新しく作る(本線の~/react-demoは触らない)npx esbuildに JSX を通して、変換後のコードを画面に出す。classic と automatic を見比べる<div className="a">こんにちは</div>の1行が、何の何になったかを対応表にするifを書いてわざと変換エラーを出す。式と文の境目を目で見る- ブラウザで「返せるもの・返せないもの」を1つずつ試す。オブジェクトを返してエラーを出し、
0が画面に出るところを再現する console.log(<div />)で、React 要素の中身を開く~/reactlabを消して、~/react-demoが無事なことを確かめる
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| トランスパイル | あるコードを、同じ意味の別のコードに書き換えること。 JSX → JavaScript がこれ |
| esbuild | Go で書かれた高速な変換器。 Vite の中で実際に動いている部品で、単体でも呼べる |
| classic 変換 / automatic 変換 | JSX の変換の2方式。前者は React.createElement を呼ぶので import React が必須。後者は react/jsx-runtime を自動で読み込むので不要 |
| 式(expression) | 値になるもの。 1 + 2、a ? b : c、関数呼び出し。{} の中に書けるのはこれだけ |
| 文(statement) | 動作の単位。 if、for、return。値にならないので {} の中に置けない |
| React 要素 | <div /> と書いたときに作られる、ただの JavaScript オブジェクト。 DOM ではない |
| Fragment | DOM には何も出さない、囲むためだけの入れ物。 <>...</> と書く |
| XSS | 他人が書いた文字列が、そのページの JavaScript として動いてしまう攻撃 |
「JSX は HTML に似せた構文です」という説明は、半分しか正しくありません。 似せたのは見た目だけで、中身は JavaScript のオブジェクトリテラルと関数呼び出しです。 似ているせいで、HTML の知識をそのまま持ち込むと必ず外れます。 この記事は、似ている部分を全部はがして、下の JavaScript を見るためのものです。
① 練習用のプロジェクトを作る
本線で作った ~/react-demo/ は、この記事では一切触りません。 壊すと本線に戻れなくなるためです。新しく ~/reactlab/ を作ります。
VMの中で打ちます。
react-demo
react-demo が見えていれば、正しい場所にいます。 ここに、もう1つ作ります。
--template react を付けているので、選択画面は出ません。 そのまま作られます。
Scaffolding project in /home/ユーザー名/reactlab...
Done. Now run:
cd reactlab
npm install
npm run dev
言われた通りに進めます。
added 152 packages, and audited 153 packages in 8s
数字は違って構いません。 npm の回でやった通り、node_modules/ はここで作られます。
この記事では、本線と別のポート(5174番)を使います。 ~/react-demo を起動したままでも、ぶつからないようにするためです。
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
5173/tcp ALLOW Anywhere
5174/tcp ALLOW Anywhere
5174/tcp の行が出れば準備完了です。開け忘れると、起動は成功しているのにブラウザは読み込み中のままになります。切り分けの順番はネットワークの回と同じです。
まだ起動しません。 ②〜④はブラウザを使わず、ターミナルだけで進みます。
② 変換後のコードを、実際に見る
ここが山場のひとつめです。
Vite は、JSX をそのままブラウザに渡してはいません。 渡す前に変換しています。変換をしているのは esbuild という部品で、ビルドツールの回で名前だけ出てきたものです。これは単体でも呼べます。
npm install を済ませたので、esbuild はもう node_modules/ の中にあります。 ネットから落とさずに呼べます。
0.25.0
数字は違って構いません。 npx は「node_modules/ の中にある実行ファイルを呼ぶ」コマンドです。
変換にかける1行を用意する
const el = <div className="a">こんにちは</div>;
<<'EOF'はヒアドキュメントといって、次にEOFだけの行が出るまでを、そのままファイルに書くという書き方です。'EOF'とクォートで囲んでいるので、中身の$や記号がシェルに解釈されません。
classic 変換 — React.createElement が出てくる
const el = /* @__PURE__ */ React.createElement("div", { className: "a" }, "こんにちは");
これが JSX の正体です。 1行の JSX が、1つの関数呼び出しになりました。
--charset=utf8を付けている理由: 付けないと esbuild は日本語を"\u3053\u3093\u306B\u3061\u306F"のような形に書き換えます(既定は ASCII だけで出力する設定のため)。壊れているわけではありませんが、読めないので付けています。
/* @__PURE__ */は「この呼び出しには副作用が無い」という印です。使われなければ削ってよい、と後段の道具に伝えるためのコメントで、意味には関係ありません。無視して構いません。
1行ずつ対応させる
元の JSX と 変換後 を、部品ごとに並べます。
| JSX で書いたもの | 変換後のどこ | 何になったか |
|---|---|---|
<div | "div" | 第1引数。ただの文字列 |
className="a" | { className: "a" } | 第2引数のオブジェクトのキーと値 |
>こんにちは< | "こんにちは" | 第3引数。子ども |
</div> | (消える) | 閉じタグは引数の切れ目でしかない |
ここで、本線で「覚えてください」と書いた2つが、理由込みで回収できます。
classではなくclassName— 属性はオブジェクトのキーとして書かれます。{ class: "a" }は、JavaScript の予約語をキーに使うことになります(オブジェクトのキーとしては実は書けるのですが、JSX の側がclassを予約語として扱わない保証をできないため、React は最初からclassNameを採用しました)。そして何より、props.classとして関数の中で受け取ったときに、変数名として使えません。forではなくhtmlFor— 同じ理由です。forはループの予約語なので、props.forを取り出して変数にできません。
覚えるべきは「className と htmlFor」ではありません。 「属性は、JavaScript のオブジェクトのキーになる」という1つの事実です。ここから両方が導けます。
automatic 変換 — いまの React が使っているのはこちら
React.createElement が出てきましたが、いま ~/react-demo/src/App.jsx の先頭に import React from "react" は書いていません。 本線で一度も書かなかったはずです。それでも動いていました。
変換方式が違うからです。
import { jsx } from "react/jsx-runtime";
const el = /* @__PURE__ */ jsx("div", { className: "a", children: "こんにちは" });
2つ変わりました。
importの行が、勝手に足されている。 だからimport Reactを自分で書かなくてよい- 子どもが第3引数ではなく、
childrenというキーに入った
Vite の React プラグインは、この automatic のほうを使っています。 検索して出てくる古い記事に React.createElement が出てくるのは、2020年より前は classic しか無かったからです。どちらも「関数呼び出しになる」という点は同じです。
[スクリーンショット: 01_esbuild変換結果.png] VM のターミナルで npx esbuild jsxlab/a.jsx --loader=jsx --jsx=automatic --charset=utf8 を実行し、import { jsx } from "react/jsx-runtime"; と jsx("div", { className: "a", children: "こんにちは" }) の2行が出ている画面を撮ってください。
子どもが複数あるときは jsxs になる
import { jsx, jsxs } from "react/jsx-runtime";
const el = /* @__PURE__ */ jsxs("ul", { className: "list", children: [
/* @__PURE__ */ jsx("li", { children: "あ" }),
/* @__PURE__ */ jsx("li", { children: "い" })
] });
jsx と jsxs の2つが出てきました。 末尾の s は children が配列(複数)のときに使われる版です。中身の意味は同じで、React 側が「配列かどうか」を毎回調べずに済むように分けてあるだけです。
そして、入れ子の JSX が、そのまま関数呼び出しの入れ子になっています。 <ul> の中に <li> を書くことは、jsxs(...) の引数に jsx(...) の結果を入れることと同じです。
key は props ではない
本線で tasks.map() に key を付けました。 あれが props に入らないことも、変換後を見れば分かります。
import { jsx } from "react/jsx-runtime";
const el = /* @__PURE__ */ jsx("li", { className: "row", children: "あ" }, "k1");
className は第2引数のオブジェクトの中に入りましたが、key だけ第3引数に出ています。
だから、コンポーネントの中で props.key を読んでも undefined です。 props のオブジェクトに入っていないからです。key は「React が並び替えを追跡するための札」であって、部品に渡すデータではありません。
もし ID を子コンポーネントの中でも使いたいなら、
keyとは別に渡す必要があります。<TaskItem key={t.id} id={t.id} />のように、2回書くのが正解です。重複に見えますが、行き先が違います。
③ {} の中に書けるのは「式」だけ
本線で「if は書けない、三項演算子は書ける」と書きました。 これも変換にかければ、React の制限ですらないことが分かります。
✘ [ERROR] Unexpected "if"
jsxlab/d.jsx:2:19:
2 │ const el = <p>{ if (n > 0) { "あり" } }</p>;
╵ ^
1 error
エラーの出どころに注目してください。 React ではなく esbuild が、変換の時点で止めています。ブラウザにすら届いていません。
{} の中は、関数の引数の中と同じ場所です。
jsx("p", { children: ここ });
ここ に if を書けるでしょうか。 書けません。f(if (a) { b }) という JavaScript は存在しません。引数に置けるのは「値になるもの」=式だけです。
三項演算子は式なので、置けます。
import { jsx } from "react/jsx-runtime";
const n = 1;
const el = /* @__PURE__ */ jsx("p", { children: n > 0 ? "あり" : "なし" });
children: の値として、そのまま入っています。
| 書けるもの(式) | 書けないもの(文) |
|---|---|
a + b / f(x) / obj.key | if (a) { ... } |
a ? b : c | for (...) { ... } |
a && b / a || b | const x = 1; |
arr.map(...) | return ... |
(() => { if (a) return b; })() ← 関数で包めば式になる | switch (...) { ... } |
最後の行が抜け道です。 どうしても
ifを書きたければ、その場で関数を作って呼ぶ(即時実行関数)と、全体が「関数呼び出し」という式になります。ただし読みにくいので、実際には JSX の外で先に計算します。 JavaScript の基本の回でやった「式と文」の区別が、ここで表示の書き方をそのまま決めています。
④ 返せるものと、返せないもの
ここが山場のふたつめです。 ここからブラウザを使います。
VITE v6.0.0 ready in 412 ms
➜ Local: http://localhost:5174/
➜ Network: http://192.168.226.50:5174/
ホストの Windows のブラウザで http://192.168.226.50:5174/(IPは自分の値に。分からなければ VM の中で ip a)を開き、React と Vite のロゴのページが出ることを確認します。
確認できたら、src/App.jsx を丸ごと置き換えます。 VS Code から編集して構いません。
function App() {
return (
<div style={{ padding: "24px", fontFamily: "sans-serif" }}>
<h1>返せるもの・返せないもの</h1>
<hr />
</div>
);
}
export default App;
保存すると、ブラウザが自動で切り替わります。 ここに1つずつ足していきます。
配列は返せる
コンポーネントは、JSX を1つ返すものだと思いがちですが、配列も返せます。
App の上に足します。
function ArrayOk() {
return [<p key="1">配列の1つ目</p>, <p key="2">配列の2つ目</p>];
}
App の <hr /> の下に <ArrayOk /> を置きます。2行そのまま出れば成功です。
なぜ返せるのか。 変換後を思い出すと、children には配列がそのまま入る(jsxs の例)からです。React にとって「子ども」は最初から配列を許す形です。
配列で返すなら
keyが要ります。 付けないとブラウザのコンソールにEach child in a list should have a unique "key" prop.という警告が出ます。赤いエラーではなく警告なので、画面は動いてしまいます。 F12 を開いていないと気づきません(開発者ツールの回)。
オブジェクトは返せない — わざとエラーを出す
function ObjectNg() {
return { title: "これは出ません" };
}
<ObjectNg /> を足して保存すると、画面が真っ白になり、エラーが出ます。
Objects are not valid as a React child (found: object with keys {title}).
If you meant to render a collection of children, use an array instead.
「オブジェクトは React の子どもとして正しくない」です。理由は、React が「これをどう文字にすればいいか」を決められないからです。
- 文字列・数値 → そのまま文字にする
- 配列 → 中身を1つずつ処理する
- React 要素(
jsx()の戻り値) → 描く { title: "..." }→ どうすればいい?
{} の中に生のオブジェクトを置いたときも、同じエラーになります。 実務でいちばん多いのは日付です。
<p>{new Date()}</p>
これはエラーになります。 Date はオブジェクトだからです。{new Date().toLocaleString()} と、自分で文字にしてから渡します。
確認できたら
<ObjectNg />の行と関数を消してください。 画面が真っ白のままだと、この先が見えません。
false / null / undefined は何も描かない。ただし 0 は描かれる
ここが、本線で自分が踏んだところです。
function Falsy() {
const items = [];
const name = null;
return (
<div>
<p>ここから下に4行分の「何か」があります</p>
<div>[{false}]</div>
<div>[{null}]</div>
<div>[{undefined}]</div>
<div>[{name && <span>名前あり</span>}]</div>
<div>[{items.length && <span>件数あり</span>}]</div>
</div>
);
}
<Falsy /> を足して保存し、ブラウザで見てください。
[]
[]
[]
[]
[0]
最後の1行だけ 0 が出ます。
理由は React ではなく && の仕様です。
| 式 | 返る値 | 画面 |
|---|---|---|
null && <span/> | null | 何も出ない |
false && <span/> | false | 何も出ない |
0 && <span/> | 0 | 0 と出る |
"" && <span/> | "" | 何も出ない(空文字は描いても見えない) |
&& は真偽値を返しません。 「左が偽なら左の値を、真なら右の値を」返します。 そして React は、false / null / undefined / true を「描かない値」として決め打ちしていますが、0 はそこに入っていません。 0 は立派な数値で、数値は描く対象だからです。
直し方は1つです。
<div>[{items.length > 0 && <span>件数あり</span>}]</div>
> 0 を付けて、左を必ず真偽値にします。 Boolean(items.length) && ... でも、三項演算子 items.length ? <span/> : null でも構いません。「&& の左に数値を置かない」が守る型です。
[スクリーンショット: 02_0だけ表示される.png] ホストのブラウザで Falsy の結果が出ている状態を撮ってください。[] が4つ並び、最後だけ [0] になっているところが写るようにしてください。
Fragment が要る理由
ArrayOk を、配列ではなく普通に書き直そうとすると詰まります。
function Two() {
return (
<p>1つ目</p>
<p>2つ目</p>
);
}
これは変換の時点で落ちます。 理由は、変換後を想像すれば分かります。
return jsx("p", {...}) jsx("p", {...}); // 文法として成立しない
return は値を1つしか返せません。 関数呼び出しを2つ並べて置く文法は、JavaScript にありません。
囲めば1つになります。
function Two() {
return (
<>
<p>1つ目</p>
<p>2つ目</p>
</>
);
}
<>...</> が Fragment です。 変換後がどうなるか、確かめます。
import { Fragment, jsxs, jsx } from "react/jsx-runtime";
const el = /* @__PURE__ */ jsxs(Fragment, { children: [
/* @__PURE__ */ jsx("p", { children: "1つ目" }),
/* @__PURE__ */ jsx("p", { children: "2つ目" })
] });
Fragment という「印」が第1引数に入っただけです。"div" のような文字列ではないので、React はDOM 要素を作らず、中身だけを外に出します。
<div> で囲んでも動きますが、意味のない <div> が1つ増えます。 CSS の回でやった通り、<div> が1つ増えると Flexbox や Grid の子要素の数が変わり、レイアウトが崩れます。 Fragment は、それを避けるためのものです。
keyを付けたいときだけ、<>は使えません。<Fragment key={x}>...</Fragment>と、import { Fragment } from "react"して書きます。<>は省略記法なので、属性を書く場所がないからです。
⑤ コンポーネントは大文字で始める
本線で「小文字だと動かない」とだけ書きました。 何が起きているかを見ます。
import { jsx } from "react/jsx-runtime";
const el1 = /* @__PURE__ */ jsx("mybutton", {});
const el2 = /* @__PURE__ */ jsx(MyButton, {});
決定的な差です。
| 書き方 | 変換後の第1引数 | React から見ると |
|---|---|---|
<mybutton /> | "mybutton"(クォート付き=文字列) | HTML のタグ名として扱う |
<MyButton /> | MyButton(クォート無し=変数) | その関数を呼ぶ |
変換器は、頭文字が大文字かどうかだけを見て、文字列にするか変数にするかを決めています。 ファイル名でも、export の有無でも、import したかどうかでもありません。1文字目だけです。
ブラウザでも起こします。 src/App.jsx に足します。
function greeting() {
return <p>これは出ません</p>;
}
App の中に <greeting /> を置いて保存します。エラーは出ません。 そして画面にも何も出ません。
F12 でコンソールを開くと、警告だけが出ています。
Warning: <greeting /> is using incorrect casing.
Use PascalCase for React components, or lowercase for HTML elements.
これがいちばん怖い形です。 真っ白なエラー画面なら気づきます。警告は、開発者ツールを開いていなければ見えません。 ブラウザは <greeting> という知らないタグを無害な空要素として受け入れるので、画面は静かに欠けます。
<greeting />を書いてもgreeting()は一度も呼ばれません。 中の<p>は存在しないので、「なぜか表示されない」ではなく「そもそも実行されていない」が正しい理解です。
確認できたら <greeting /> と関数を消します。
⑥ props の正体は、ただのオブジェクト
本線で「props は親から子への一方通行」と書きました。 変換後を見ると、props は「関数呼び出しの第2引数のオブジェクト」そのものだと分かります。
import { jsx } from "react/jsx-runtime";
const rest = { id: 1, done: false };
const el = /* @__PURE__ */ jsx(TaskItem, { title: "買い物", ...rest, onDone: f, children: "本文" });
3つ確認できます。
title="買い物"は、ただのキーと値{...rest}は、ただのスプレッド構文。JSX 固有の記法ではなく、オブジェクトを展開する JavaScript の書き方がそのまま出ている- タグに挟んだ「本文」は、
childrenというキーに入っている。childrenも props の1つでしかない
だから、この2つはまったく同じ意味になります。
<Box children="こんにちは" />
<Box>こんにちは</Box>
後者は前者の書きやすい形というだけです。children が特別な仕組みではなく、ただの決まった名前のキーだと分かると、props.children を条件で出し分けたり、配列として数えたりできるようになります。
スプレッドの順番には意味があります。 上の出力で title → ...rest → onDone の順に並んでいる通り、後に書いたキーが勝ちます。
<Box color="red" {...props} /> {/* props に color があれば、そちらが勝つ */}
<Box {...props} color="red" /> {/* 必ず red になる */}
「既定値として使いたいなら先に、上書きしたいなら後に」です。これはオブジェクトリテラルの規則そのもので、React の規則ではありません。
⑦ dangerouslySetInnerHTML の名前が長い理由
React では、文字列はすべて「文字として」描かれます。
src/App.jsx に足して確かめます。
function Escaped() {
const fromUser = "<b>太字にしたい</b>";
return <p>{fromUser}</p>;
}
画面には、太字ではなく <b>太字にしたい</b> という文字列がそのまま出ます。
これは React の親切ではなく、防御です。 DOM 操作の回で innerHTML を使いました。あれは渡された文字列を HTML として解釈します。 つまり、掲示板の投稿欄に <img src=x onerror="..."> と書かれたら、それが実行されます。 これが XSS です。
React は、{} に入れた文字列を必ずエスケープします。 何も考えずに書いても、既定で安全になります。
それでも HTML として入れたいとき(自分が書いた Markdown を変換した結果など)は、専用の props を使います。
function Raw() {
const html = "<b>これは太字になります</b>";
return <div dangerouslySetInnerHTML={{ __html: html }} />;
}
この名前と形は、わざとです。
| わざとやっていること | 狙い |
|---|---|
dangerously(危険なことに)から始まる長い名前 | 打つときに必ず一度読む。 レビューで検索して見つけられる |
文字列ではなく {{ __html: ... }} というオブジェクトを渡させる | うっかり変数を渡せない。 1段余計な手間で、意図を明示させる |
アンダースコア2つの __html | 通常のコードでは書かない見た目にして、目立たせる |
「安全に使う方法」はありません。 あるのは、入れる文字列を自分が完全に管理しているかだけです。他人が入力したものを、ここに渡してはいけません。 どうしても必要なら、渡す前にサニタイズ(危険なタグを除去する処理)を通します。
この話の続きは本線にあります。 XSS が「何ができてしまうのか」と、サーバー側とヘッダ側でどう塞ぐかは、セキュリティ点検の回と防御ヘッダの回で扱っています。フロント側でエスケープしているから安全、にはなりません。
⑧ <div /> は、まだ何も描いていない
最後です。 JSX が関数呼び出しなら、その戻り値は何なのかを見ます。
src/App.jsx の App 関数の中の、return の前に1行足します。
function App() {
console.log(<div className="a">こんにちは</div>);
return (
<div style={{ padding: "24px", fontFamily: "sans-serif" }}>
<h1>返せるもの・返せないもの</h1>
<hr />
</div>
);
}
ホストのブラウザで F12 を押し、Console タブを見ます。三角形をクリックして開いてください。
{$$typeof: Symbol(react.transitional.element), type: 'div', key: null, props: {…}, …}
$$typeof: Symbol(react.transitional.element)
type: "div"
key: null
props:
className: "a"
children: "こんにちは"
Symbol(...) の中身は React のバージョンで変わります(Symbol(react.element) と出ることもあります)。気にしなくて構いません。
読むべきはこれです。
| キー | 中身 | 意味 |
|---|---|---|
type | "div" | 何を作るか。 文字列なら HTML、関数ならコンポーネント |
props | { className, children } | 渡されたもの全部 |
key | null | props の外にある(②で見た第3引数) |
$$typeof | Symbol | 「これは本物の React 要素だ」という印 |
DOM はどこにもありません。 document.createElement も呼ばれていません。<div /> と書いてできたのは、「div を作ってほしい」という注文書だけです。
描くのは React の仕事です。 main.jsx にある createRoot(...).render(<App />) が、この注文書のツリーを受け取って、初めて本物の DOM を作ります。 更新のときは、前回の注文書と新しい注文書を比べて、違うところだけ本物の DOM に当てます。 これが本線のフレームワークの回で出てきた仮想DOMの実体です。
$$typeofに Symbol が使われている理由も、防御です。 Symbol は JSON に変換できません。 つまり、外部から送られてきた JSON を、そのまま React 要素だと偽って描かせることができません。 サーバーから受け取ったデータを{}にそのまま入れてしまう事故を、型の側で潰しています。
[スクリーンショット: 03_React要素の中身.png] ホストのブラウザで F12 のコンソールを開き、console.log(<div />) の結果が展開されて type: "div" と props が見えている状態を撮ってください。
つまずいたところ
変換後のコードを見ようとして、いきなり npx esbuild を打って失敗しました。 ~/reactlab を作る前、ホームディレクトリで打ったためです。
Need to install the following packages:
esbuild@0.25.0
Ok to proceed? (y)
ネットから落とそうとしています。 npx は、まず node_modules/ を探し、無ければダウンロードするという順で動きます。プロジェクトの中で打てば、既にあるものが使われます。 落としても動きはしますが、Vite が実際に使っているものと同じバージョンを見たいので、プロジェクトの中で打つべきでした。
次に、--jsx=automatic を付けずに見て、混乱しました。 出てきたのが React.createElement だったので、「自分のプロジェクトにも import React が要るのでは」と思い、App.jsx の先頭に足しました。動きはしましたが、不要でした。 esbuild の既定が classic で、Vite の React プラグインが automatic を指定している、というだけの違いです。同じ道具でも、呼び出し方が違えば出力が変わります。
0 の件は、本線を書いた時点では「そういうもの」で流していました。 深掘りで && の戻り値を確かめて、0 が特別扱いされているのではなく、false・null・undefined のほうが特別扱いされている、と向きが逆だったことに気づきました。React が描かない値のリストに 0 が入っていないだけです。
オブジェクトを返すエラーで、画面が真っ白になって焦りました。 ファイルを元に戻しても白いままだったのですが、ブラウザを再読み込みしたら戻りました。 描画中に落ちると、HMR(保存して自動反映する仕組み)では復帰しないことがあります。真っ白になったら、まずリロードです。
Fragment に key を付けようとして詰まりました。 <> key={x}> のような書き方を探しましたが、存在しません。 <> は属性を書く場所が無い省略記法なので、import { Fragment } from "react" して <Fragment key={x}> と書きます。 変換後に Fragment という変数が第1引数に入っているのを見て、これは他のコンポーネントと同じ扱いなのだと納得しました。
後片づけ
この記事で作ったものを、全部消します。 本線の ~/react-demo/ が無傷であることも確かめます。
まず、開発サーバーを止めます。 起動しているターミナルで Ctrl+C です。
何も出なければ止まっています。 プロセスとサービスの回でやった通り、「止めたつもり」を確かめる手段を持っておきます。
ファイアウォールを閉じます。
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
5173/tcp ALLOW Anywhere
5174/tcp の行が消えていれば片づきました。 5173/tcp は本線で使うので残します。
練習用プロジェクトを消します。
react-demo
react-demo だけが残っていれば正解です。 rm -rf は戻せないので、打つ前にパスを声に出して読んでください。 ~/react-demo と ~/reactlab は、先頭6文字が同じです。
最後に、本線が壊れていないことを確かめます。
本線のタスクリストがブラウザで動けば、何も壊していません。 確認したら Ctrl+C で止めます。
まとめ
- JSX は構文糖衣で、変換器が関数呼び出しに書き換えている。 見るのは
npx esbuild ファイル.jsx --loader=jsx。説明を読むより速い - 変換方式は2つある。
React.createElementを呼ぶ classic と、react/jsx-runtimeを自動で読み込む automatic。Vite は automatic なのでimport Reactが要らない --charset=utf8を付けないと、日本語が\u30xx表記になる。 壊れているわけではない- 属性は、第2引数のオブジェクトのキーになる。 だから
class→className、for→htmlFor。2つを暗記するのではなく、1つの事実から導く keyだけは第3引数に出る。 props に入らないので、props.keyはundefined。子でも ID が要るなら別の名前でもう1回渡す{}の中に書けるのは式だけ。ifは変換の時点で構文エラーになり、React には届かない。三項演算子と&&を使うのは、それが式だから- 返せるのは、文字列・数値・React 要素・配列・
null。 オブジェクトは返せない(Objects are not valid as a React child)。new Date()をそのまま置く事故が多い false/null/undefined/trueは描かれない。0は描かれる。&&は真偽値ではなく左の値をそのまま返すため。&&の左に数値を置かないreturnが1つしか返せないから Fragment が要る。<>は変換後にFragmentという印が第1引数に入るだけ。keyを付けたいときは<Fragment>と書く- 大文字か小文字かだけで、変換後が「文字列」か「変数」かに分かれる。 小文字はエラーにならず、静かに何も出ない。関数はそもそも呼ばれていない
- props はただのオブジェクト。
childrenもその1つのキー。{...props}はスプレッド構文そのもので、後に書いたキーが勝つ dangerouslySetInnerHTMLは、名前と形をわざと面倒にして事故を減らしている。 他人の入力を渡さない<div />はまだ何も描いていない。 できるのは{ type, props, key }を持つ注文書のオブジェクトだけで、描くのは React
参考リンク
- roadmap.sh — React
- React 公式 — JSX でマークアップを書く
- React 公式 — 波括弧で JSX に JavaScript を含める
- React 公式 — 条件付きレンダー
- React 公式 — リストのレンダー
- React 公式 — createElement
- React 公式 — Fragment
- React 公式 — 共通のコンポーネント(dangerouslySetInnerHTML を含む)
- React 公式ブログ — 新しい JSX 変換の導入
- esbuild — JSX の扱い
- esbuild — JSX 関連のオプション
- Vite 公式ガイド
- OWASP — クロスサイトスクリプティング
次に読む
この記事は 【深掘り】React の 1 / 24 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- JSXは関数呼び出しに変換される
- 式しか書けない / 描かれる値と描かれない値
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント