React未経験なので公式チュートリアルから学んでみる Part2（JSXでマークアップを記述）

## はじめに
前回の記事は以下から
[React未経験なので公式チュートリアルから学んでみる Part1](https://qiita.com/course_k/items/4df3f0a1bfb8f36da55f)

引き続き、私が学んだことをまとめていきます。
前回はReactについての大まかな部分について触れました。
今回はJSXについてもう少し深く掘り下げて確認します。

[REACTを学ぶ-JSX でマークアップを記述する](https://ja.react.dev/learn/writing-markup-with-jsx)
の内容がベースになっています。

## JSXとは
### JSXの概要
まず初めに理解しておきたいのは、**ReactとJSXは別物**であるということです。

JSXはJavaScriptを拡張したもので、XMLのような構文でマークアップを記述できます。
一方、ReactはUIを表示するためのJavaScriptのライブラリであり、両者は異なるものです。

次にJSXは**JavaScriptオブジェクト**であるということです。
見かけ上はHTMLですが、その中身はオブジェクトです。

これら2点について順にみていきます。

### JSXを理解する
冒頭でJSXはJavaScriptの拡張であり、Reactとは異なると言いましたが、拡張であるとはどういうことでしょうか。
JSXの中身から考えていきましょう。

#### JSXを使わない書き方
ReactとJSXは別物であるので、JSXを使わずにReactを記載することが可能です。

試しにやってみます。App.jsを編集していきましょう。
（App.jsについては初回記事の[こちら](https://qiita.com/course_k/items/4df3f0a1bfb8f36da55f#%E3%81%BE%E3%81%9A%E3%81%AF%E6%9B%B8%E3%81%84%E3%81%A6%E3%81%BF%E3%82%8B)を参照してください）

reactから`createElement`をimportし、App関数の中身を書き換えます。
`createElement`関数の第1引数にhtmlのタグを、第2は使用しないのでnull、第3引数にタグに設定する中身を設定します。

```react:App.js
import logo from './logo.svg';
import './App.css';
import { createElement } from 'react';

function App() {
  return createElement('h1', null, 'Helllo World!');
}

export default App;
```
JSXを使用していませんが、「Hello World!」が出力されます。
<img width='90%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/686d5288-c767-eab7-b4d5-ec6e5066aa44.png' >
Reactで用意している`createElement`関数が引数から画面表示に必要なオブジェクトを生成し、返却しているため、JSXなしでも画面描画ができるのです。

ただ、今回は`<h1>`タグのみでしたが、htmlの要素が増えてくると、この関数で表現するのは少し大変そうです。
JSXの方が簡潔に書けますし、なによりhtmlの記載とほぼ変わらないので直感的にもわかりやすいかと思います。

JSXで先ほどと同じ挙動を実現するには以下のようになります。
```react:App.js（関数のみ抜粋）
function App() {
  return (
    <h1>Hello World!</h1>
  );
}

export default App;
```

では、一見するとただのhtmlで、関数などの処理は見えないのに、なぜJSXの記載方法で結果が正しく表示されるのでしょうか。

その中身について次に確認します。

#### JSXの変換
先ほどの問いの答えは単純で、JSXの記載は裏でJavaScriptの構文に変換されているためです。
その変換に使われているのがBabelと呼ばれるものです。

Babelの変換については以下のサイトをみてください。
[Babel-Try it out](https://babeljs.io/repl)
このサイトではBabelを使った変換結果がどうなるかを確認できます。

今回はこちらのJSXを変換してみましょう。
`<h1>Hello World!</h1>`

変換の際、左下の「OPTIONS」の「React Runtime」が「Classic」になっていることを確認してください。
<img width='90%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/3ad75bbd-5584-fba8-152e-65641aacc528.png'>
JSXを左側に入力すると、変換結果が右側に表示されます。
`React.createElement`が使われていることがわかります。
先ほどJSXを使わずに書いたときに使った関数とまったく同じです。

つまり、内部ではJSXにおいても、Reactが用意している`createElement`のような関数を呼ぶ形に変換されているということです。
このようにJSXはあくまでも便利に書くための書き方であり、これがJavaScriptを拡張したもの、ということになります。

※Reactの17からは上記の変換は使われていないようです。
参考：[Zen - React17におけるJSXの新しい変換を理解する
](https://zenn.dev/uhyo/articles/react17-new-jsx-transform)Babelのサイトで新しい変換方法で試す場合、「React Runtime」を「Automatic」にすると、どのような形か確認することができます。

### オブジェクトとしてのJSX
次に、JSXがオブジェクトであることを確認してみましょう。
先ほどと同じようにApp.jsを編集します。

JSXを変数に格納し、その変数をreturnしています。
また、変数の型と、変数自身をコンソール出力するようにしています。
```react
import logo from './logo.svg';
import './App.css';

function App() {
  const obj = (<h1>Hello World!</h1>);
  console.log(typeof(obj));
  console.log(obj);
  return obj;
}

export default App;
```
画面には「Hello World!」が出力されると思いますが、画面ではなく開発者モードからコンソールを確認してみましょう。
`typeof`の出力結果は「object」と出力され、objの中身が出力されています。
<img width='90%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/dc72441a-2660-da3f-30d9-dc11b8ec940b.png' />
`key`や`props`、`ref`、`type`などのキーを持っていることがわかります。
このことから、JSXがオブジェクトであることが確認できます。

ここで注目すべきは`props`と`type`です。
`type`には「h1」
`props`には「children: 'Hello World!'」が設定されています。

つまりJSXとして渡している
`<h1>Hello World!</h1>`
が、内部の処理で上記のようなオブジェクトに変換されている、ということがわかります。

なお、何の説明もなく
`const obj = (<h1>Hello World!</h1>);`
と記載していましたが、JSXはオブジェクトであるので問題なく変数に格納できます。
この変数`obj`を返却することで、return文にJSXを書くのと同じ挙動になります。

## JSXを使う
JSXがどのようなものか、は理解できたかと思います。
では、実際にJSXを使ってマークアップを記述できるようになりましょう。

そのためには3つのルールを押さえておく必要があります。
### 1. ルートタグは1つ
以下のようなhtmlのタグがあったとします。（bodyタグ内のみ抜粋）
通常のhtmlであれば、問題なく画面表示ができます。
※正しく動くことは以下のサイトから確認できます。
[liveweave](https://liveweave.com/)
```html:例1
<h1>title1</h1>
<h2>title3</h2>
<h3>title3</h3>
```

これをJSXで記載してみましょう。
App.jsに転記します。
```react:App.js
import logo from './logo.svg';
import './App.css';

function App() {
  return (
    <h1>title1</h1>
    <h2>title3</h2>
    <h3>title3</h3>
  );
}

export default App;
```

結果はエラーになるはずです。
<img width='90%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/b1e9863a-dc35-be41-5250-9a3a1a9b770a.png'>
エラーメッセージから分かる通り、隣り合うタグはタグで囲まれている必要があります。
つまり、トップとなるルートのタグは1つしか許容されません。

先ほどのApp.jsを修正するのならば、
```react:App.js(関数のみ抜粋)
function App() {
  return (
    <div>
      <h1>title1</h1>
      <h2>title3</h2>
      <h3>title3</h3>
    </div>
  );
}
```
となります。
ルートタグを`<div>`タグの1つのみとし、小要素として他のタグを設定しています。

しかし、これだと余計な`<div>`タグが増えてしまうのがやっかいです。
<img width='80%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/3b65caf0-ce83-6126-e308-34107a3bc4d0.png'>
※`<div id="root">`はApp.jsではない別のファイルで設定されているものです。

そこで、以下のように書くこともできます。
```react:App.js(関数のみ抜粋)
function App() {
  return (
    <>
      <h1>title1</h1>
      <h2>title3</h2>
      <h3>title3</h3>
    </>
  );
}
```
開発者モードから確認すると、空のタグ`<>...</>`は出力されていないことが確認できます。
<img width='90%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/21155659-acf0-c234-e121-251c13edca4d.png'>

これはフラグメントと呼ばれるものです。
`<fragment>...</fragment>`と書くこともできますが、一般的には省略して空のタグで書くようです。
フラグメントを使えば、htmlの中身に影響を与えることなく、複数の要素をまとめることができます。

### 2. 必ずタグは閉じる
htmlのタグの中には、終了タグを省略できるケースがあります。
```html:例2
<ul>
    <li>apple
    <li>banana
    <li>cherry
</ul>
<input type='text'>
```
`<li>`タグは終了タグの`</li>`を省略できます。
また`<input>`タグはそもそも終了タグが存在しません。

これらをJSXに記載してみましょう。
```react:App.js（関数のみ抜粋:liタグ）
function App() {
  return (
    <ul>
        <li>apple
        <li>banana
        <li>cherry
    </ul>
    );
}
```

```react:App.js（関数のみ抜粋:inputタグ）
function App() {
  return (
    <input type='text'>
      );
}
```
結果はいずれもエラーになります。

`<li>`タグでのエラー
<img width='80%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/257c4fce-e475-a53b-4ea2-898203c24285.png'>
`<input>`タグでのエラー
<img width='80%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/5f17bc47-dd41-1caf-1633-2c98c92d8430.png'>
JSXの方がhtmlよりも厳密であるので、必ずタグは明示的に閉じるようにしましょう。
```react:App.js(関数のみ抜粋)
function App() {
  return (
    <>
      <ul>
        <li>apple</li>
        <li>banana</li>
        <li>cherry</li>
      </ul>
      <input type='text' />
    </>
  );
}
```
`<input>`タグのような、そもそも終了タグがないものについては、末尾にスラッシュを入れることで閉じたことになります。
※htmlでも、スラッシュを末尾に入れてかまいません。正しく表示できます。

きちんとタグを閉じれば、以下の通り画面描画されます。
<img width='80%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/6fd15a22-2608-4a9d-d8ad-a4bd023fd431.png'>


### 3. 属性はキャメルケースで
htmlのタグにはidやclassなどの一般的な属性、またonclickなどのイベントハンドラー属性があります。
```html:例3
<input id="input_form" class="required">
<button onclick="(()=>alert('clicked'))();">click me!</button>
```

いったん上記のままJSXとして書いてみます。
```react:App.js（関数のみ抜粋）
function App() {
  return (
    <>
      <input id="input_form" class="required" />
      <button onclick="(()=>alert('clicked'))();">click me!</button>
    </>
  );
}
```

一見、何のエラーもないように見えます。
<img width='90%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/2001e06b-e7dd-f802-65d8-9dc6ace39111.png'>
開発者モードのコンソールを確認してみましょう
<img width='90%' src='https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/251137/4ba8c841-bbe6-4611-c2a0-33800ea9b803.png'>
class、onclickともにエラーとなっていることがわかります。

まず、classについてはJavaScriptではclassが予約語になっており、classを使うことができません。
JSXはJavaScriptオブジェクトであり、オブジェクトに変換される過程で、属性がキーとして設定されます。
予約語はキーには使うことができないため、エラーになっています。

class属性を設定したい場合は、代わりにclassNameを使います。

また、onclick属性もエラーになっています。
これは、reactでの属性の多くがキャメルケースで用意されているためです。
よって、先ほど確認したclassNameも含め、属性についてはすべてキャメルケースで記載するようにしましょう。

正しく記載すると以下のようになります。
```react:App.js（関数のみ抜粋）
function App() {
  return (
    <>      
      <input id="input_form" className="required" />
      <button onClick={() => alert('clicked')}>click me!</button>
    </>
  );
}
```
※onClickの中身が先ほどの例と少し変わっています。こちらの記法については次回以降で説明します。

## まとめ
JSXの中身の詳細、およびJSXでマークアップを記載するためのルールを確認しました。
これで、簡単なWebサイトの見た目くらいであれば作ることができるでしょう。

ただ、これだけではまだまだReactの機能を理解しきれていません。
次回はJSXの中でJavaScriptの変数を利用する方法について確認します。
Part3は[こちら](https://qiita.com/course_k/items/ed4d2c15854b03a98de6)
（次回の記事は鋭意作成中です。）

## 参考にしたサイト
* [REACTを学ぶ-JSX でマークアップを記述する](https://ja.react.dev/learn/writing-markup-with-jsx)
* [kinsta - Reactで使用するJSXの基本をわかりやすく解説](https://kinsta.com/jp/knowledgebase/what-is-jsx/)
* [Zen - React17におけるJSXの新しい変換を理解する](https://zenn.dev/uhyo/articles/react17-new-jsx-transform)
* [【2023年最新】React(v18)完全入門ガイド｜Hooks、Next.js、Redux、TypeScript](https://www.udemy.com/course/react-complete-guide/)