Next.js(React)をざっくり始める

こんにちは！いまだにreturnの綴りが怪しいフロントエンドエンジニアです。今回はNext.jsの概念をざっくりとまとめたいと思います。(Reactと重複する内容有／今回は概念だけですので、詳しい書き方については書いていません。)

### その前にまず私の状況
今までVue.jsしかやったことがなく、React系を始めて1か月経ったところです。そのためかなり知識が未熟なところがあります。[他のブログ／本／動画](#おまけ)などを参考にし、補助的にこちらを見て頂ければと思います。

そのような状況で今回記事を書いた理由は、
　・「とりあえず書き始めたい！」という人向けの記事が少ないように感じたため
　・TypeScriptのNext.jsの資料が少ない
というところです。

サイトパフォーマンス等一旦気にせず、とりあえず始めたいという人向けになるべく分かりやすく説明したいと思います。

# 目次
[1.基本的な概念](#1-基本的な概念)
[2.ページについて](#2-ページについて)
[3.拡張子について](#3-拡張子について)
[4.use/memoで囲む](#4-use/memoで囲む)
[5.型について](#5-型について)
[6.APIについて](#6-APIについて)
[7.まとめ](#7-まとめ)
[8.おまけ](#8-おまけ)

# 1. 基本的な概念
### ■ファイルの中身
大体1ファイルの中身はこのような構成です。拡張子については後ほど説明します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2365717/d3619cd7-2f88-a2d9-428b-1104aec4d1b9.png)

### ■コンポーネントについて
Nextは「とにかく部品を作って、それをページに埋めていく！」という考えのもと作っていきます。(ここで言う「ページ」は実際にサイトとして見せる用のファイルの事)
例えば、ボタンを3つ使いたいページを作る際に。。。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2365717/1bc484a9-7ebf-0359-cba2-60090d09b72b.png)

<hr/>
そのため、部品(コンポーネントファイル等)を1つ作成して、それを使いたい度に呼び出してページに埋めていきます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2365717/37f86922-cc72-f15f-6efb-5ab4b27fe09d.png)
<hr/>

### ■コンポーネント以外の部品達
「部品」はコンポーネントの他にも色々あります。
　・コンポーネント：HTMLにて埋め込む部品(ボタン／フォーム／ヘッダー等々…)
　・カスタムhook：色々なところで使いたいメソッド
　・プロバイダー：色々なところで使いたい値
　・タイプ：型をまとめておく　　等々…
それぞれのファイルの置き場所はこのような感じです。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2365717/0d3b0737-6677-0f45-1623-086023cfab6f.png)
hooksフォルダを作成して、その中にカスタムhookファイルを作成するイメージ
※ちなみにカスタムhookのカスタムは、Nextに元々用意されているhookがあるので、自分で作成したhookの事をカスタムhookと呼んでいます。

### ■コンポーネントの作り方
細かいところは後ほど説明していきます。一旦コンポーネントの書き方のみ紹介です。

```react:コンポーネント
//Buttonというコンポーネント
//export const コンポーネント名:型(()=>{ページの内容})
export const Button: FC = memo(() => {
//これを埋め込んだ際に返すHTML(このHTMLが表示される)
return ( <><button>ボタン</button></> ); }); 
```

```HTML:ページ
<!--埋め込みたいところにこれを書けば埋め込める-->
 <Button/>
```

という事でこのように色々な部品を埋め込んで1ページを作成していくイメージになります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2365717/2e36272f-b415-8e18-1154-c93c787d35cf.png)

<hr/>

### ■コンポーネントに値を渡す：Props/Children
しかしここでこのような事に気が付きませんでしょうか。。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2365717/163d4734-be48-af02-ca72-97a7e8235273.png)

このような問題を解決するために、Propsという概念が存在します。
Propsは一旦コンポーネント内の値を「仮」にしておいて、ページで使う際に入れる値を決定出来るシステムです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2365717/5cabf146-2451-87f8-3520-01b03576b2a4.png)

```react:コンポーネント
//最初に受け取るPropsの型を宣言
export type Props = {
  label: string;
};

//propsを使用する際には()の中にpropsを入れる
export const Button: FC<Props> = memo((props) => {
//Propsで受け取る値を宣言
  const { label } = props;

//これを埋め込んだ際に返すHTML(このHTMLが表示される)
//ここのlabel部分に渡された値が入る
  return ( <><button>{label}</button></> ); }); 
```

```HTML:ページ
<!--ボタンコンポーネントのラベルに「検索」を渡す-->
 <Button label="検索" />
```

同じようにChildrenという概念も存在します。
これは挟んで値を渡してあげるやり方です。渡す値が大きい範囲の際はこちら利用すると良いかも。

```react:コンポーネント
//ここの書き方は固定
type Props = {
  children: ReactNode;
};

//propsを使用する際には()の中にpropsを入れる
export const Button: FC<Props> = memo((props) => {
//Propsで受け取る値を宣言
  const { children } = props;

  return ( <><button>{children}</button></> ); }); 
```

```HTML:ページ
<!--ボタンコンポーネントのchildrenに「検索」を渡す-->
<!--挟んだ値が渡される-->
 <Button>検索</Button>
```

### 1のまとめ
・Nextは部品を作成してページに埋めていく
・コンポーネント:HTML/hooks:メソッド/providers:値/types:型
・コンポーネントはProps/Childrenで値を渡せる


# 2. ページについて
先程「ページはサイト表示用ファイル」と述べましたが、超厳密にいうと表示しているのは「ページを埋めたレイアウトコンポーネントを埋めた_app.jsx」です。ここを理解するのもなかなか難しい。。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2365717/8b493082-3e70-680b-c24e-fb6882b3c34c.png)

それぞれの書き方も見ていきたいと思います。

### ■ページファイル
コンポーネントは上でexportしてたけど、ページは下でexportする。

```react:ページ
//const ページ名 :型
const Page: NextPage = () => {
  return (
    <>ページの内容</>
  );
};

export default Page;
```
### ■レイアウトコンポーネント
Childrenのところにページファイルが入る

```react:layout.tsx
export const Layout: FC<Props> = memo((props) => {
const { children } = props;
  return (
    <>
          <Header/>　<!--ヘッダーコンポーネント-->
            <main>{children}</main>
          <Footer /> <!--フッターコンポーネント-->
      </>
  );
});
```
### ■_app.tsx
Headに書く事なければ初期のままでOK

```react:_app.tsx
function MyApp({ Component, pageProps }: AppProps) {
  return (
    <>
      <Head>
        <title>サイトのタイトル</title>
        <meta name="description" content="Generated by create next app" />
        <link rel="icon" href="/image/favicon.ico" />
      </Head>
          <Component {...pageProps} />
    </>
  );
}

export default MyApp;
```
### 2のまとめ
・全体に表示させたい内容はレイアウトコンポーネントにて
・全体の設定(Headタグ等)は_app.tsxにて
・コンポーネントは上でexport/ページは下でexport

# 3. 拡張子について
ファイルの拡張子なのですが、.ts(.js)と.tsx(.jsx)が存在します。
この違いは「そのファイルは、最後何でreturnしているか」です。

・値／メソッド等、TypeScript形式でreturn→.ts(カスタムhook等)

```typescript
 return num1;
```

・HTMLの形でreturn→.tsx(ページ／コンポーネント等)

```HTML
  return (<button>{label}</button>);
```
### 3のまとめ
・「そのファイルは、最後何でreturnしているか」でファイルの拡張子を決める
・HTML → .tsx
・値／メソッド → .ts

# 4. use/memoで囲む
Nextでは以下のuse/memoを使って、変数等を囲む必要があります。
それぞれの理由を説明すると長くなるのでここでは置いておきます。

| 囲む対象                                           | 使うもの    | 
| :------------------------------------------------: | :---------: | 
| メソッド外で宣言している変数                        | useState    | 
| 関数                                               | useCallback | 
| コンポーネント                                     | memo        | 
| (※使いたいときのみ)関数：値の変更→発動　　　　　　　 | useEffect   | 

囲む／囲まないを場合によって判断する必要がある様ですが、その判断基準が人によって割とまちまちなため、一旦は全てにつけて問題ないかと思います。とにかく、コンポーネントはmemo／変数はuseState／関数はuseCallbackで囲む！です。(useEffectは使いたいときのみ…)

### ■変数：useState

```typescript
//この先aaaの中身を初期値から書き換えない時
const [aaa] = useState("初期値")

//この先aaaの中身を書き替える予定の時
//後ろの値はset変数名の形にする
//letでなく、constでOK
const [aaa,setAaa] = useState("初期値");

//aaaの中身を書きかえる時
setAaa("書き換えたい内容")

///NG!
aaa = "書き換えたい内容"
```
メソッド外で宣言している変数にはuseState必要だけど、
とあるメソッド内でしか使っていない場合は不要

```typescript
//num1はuseState必要
const [num1,setNum1] = useState(0)

const aaa = useCallback(()=>{
//num2はこのメソッド内でしか使っていないのでuseStateいらない
 const num2 = 1;
 setNum1(num2);
},[num1,setNum1])
```

### ■関数：useCallback
後ろの[]には、処理に使っている値が入ります。
VScodeのESLintを使っていれば恐らく下線が引かれるので、クイックフィックスで直せます。。

```typescript
//囲まない場合
console.log("関数");
const aaa =()=>{console.log("関数")}

//囲む場合
useCallback()=>{console.log("関数");},[]);
const aaa = useCallback(()=>{console.log("関数");},[]);
```

### ■コンポーネント：memo
これを

```react
export const Button: FC = () => {
return ( <><button>ボタン</button></> ); };
```
memo()で囲んでこうする

```react:コンポーネント
export const Button: FC = memo(() => {
return ( <><button>ボタン</button></> ); }); 
```

### ■useEffect
[]の中の値が変更された際に発動する。
[]を空にするとmount時(このページが作られる際)に自動発動

```typescript
useEffect()=>{console.log("関数");},[num1]);
const aaa = useEffect(()=>{console.log("関数");},[num1]);
```

### 4のまとめ
・コンポーネントはmemo／変数はuseState／関数はuseCallbackで囲む！
・useEffectは値の中身が変更されたタイミングで発動／始めに自動発動させることが出来る

# 5. 型について
ここがNextの資料はTypeScriptで書かれているものが少なく、苦労した点です。。
ざっくり、覚えておくと良さそうな型を紹介します。

### ■ページファイル
NextPageをつける

```react
const AaaPage: NextPage = () => {}
```

### ■コンポーネントファイル
FCとVFCがあるようですが、私はFCを使用しています。

```typescript
//propsなし
export const Button: FC = memo(() => {})

//propsあり
export const Button: FC<Props> = memo((props) => {})
```

### ■useStateで型を設定する時

```typescript
const [aaa]=useState<string>("");
```
### ■propsで定義する際に役に立ちそうな型

```typescript
export type Props = {
  title: string; //ここに入れる型
};

  //メソッド
  method: () => void;
  //文字
  mozi: string;
  //数
  id: number;
  //true・false
  isOpen: boolean;
  //2種類のどちらかしか入らない時
  color: "赤" | "青"; 
  //onChange(ユーザが値を入力して、値の中身が変わったら発動する)
  onChange: ChangeEventHandler<HTMLInputElement>;
  //JSX(HTMLっぽい形を受け取る際)
  contents:ReactNode;

```

### ■APIでとってきた値に型を設定する

```typescript:type.ts
//types>type.tsで型の設定をしておく
export type Mailtype = {
  email: string;
};
```

```typescript:ページ
//APIで取得したデータ：dataの中の「メール」に型をつける
const data: Mailtype   = data.userMail;
```

# 6. APIについて
皆さんおなじみ(?)axiosやfetchで呼べるのですが、こちらもデータを取得の際は「APIを呼ぶタイミング」によって囲まなくてはいけません。ここについてはまだ私も勉強不足なので異なる点があればご教示ください。

|     | 呼ばれるタイミング | 用途       | 対象データ                                                                                       | 
| --- | :----------------- | ---------- | ------------------------------------------------------------------------------------------------ | 
| SSG | ビルド時           | 初期表示用 | まず更新する予定のないもの<br>あまり書き直さないもの<br>(ブログ等)                               | 
| SSR | サーバサイド       | 初期表示用 | ユーザの操作をDBに<br>反映させる可能性があるもの<br>(Twitterのタイムライン,<br>アカウント情報等) | 
| CSR | クライアントサイド | 再取得用   | データ取得をマメにする<br>必要があるもの<br>(Twitterのタイムライン等)                            | 
  
とにかくまずは
・静的なページ→SSG
・動的なページ(ユーザの操作をDBに反映する事が多い)→SSR+CSR
という使い分けで問題ないかな、と思います。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2365717/9a44e640-b932-9be5-0b2b-ecb02b21e73f.png)

※追記
Next.jsと(使った事ないので曖昧ですが)Nuxt.jsにはこの概念が存在しており、React,Vueは全てCSRの認識です。

# 7. まとめ
### 1.ページと部品
Nextは部品を作成してページに埋めていく
・コンポーネント:HTML
・hooks:メソッド
・providers:値
・types:型
コンポーネントはProps/Childrenで値を渡せる

### 2.出力ページの構成
・全体に表示させたい内容はレイアウトコンポーネント
・全体の設定(Headタグ等)は_app.tsx
・コンポーネントは上でexport
・ページは下でexport

### 3.拡張子
「そのファイルは、最後何でreturnしているか」でファイルの拡張子を決める
・値、メソッド → ts
・HTML → tsx  

### 4.囲めルール
・コンポーネントはmemo
・変数はuseState
・関数はuseCallbackで囲む！

### 5.型について
特になし。

### 6.DBからデータの取得
APIからデータを取得する方法はタイミングによって書き方が異なる。
・SSG→静的なページの初期表示用(早い)
・SSR→動的なページ初期表示用(遅い)
・CSR→動的なページ　リアルタイム更新用(遅い)

今後追加したい項目：
・onChange/onClick等イベントハンドラーについて
・mapで回す

#### ここまで記事をお読みいただきありがとうございました！

# 8. おまけ
Next.js/Reactを勉強するにあたり読んだ資料達
### ■本

https://www.amazon.co.jp/%E3%83%A2%E3%83%80%E3%83%B3JavaScript%E3%81%AE%E5%9F%BA%E6%9C%AC%E3%81%8B%E3%82%89%E5%A7%8B%E3%82%81%E3%82%8B-React%E5%AE%9F%E8%B7%B5%E3%81%AE%E6%95%99%E7%A7%91%E6%9B%B8-%EF%BC%88%E6%9C%80%E6%96%B0ReactHooks%E5%AF%BE%E5%BF%9C%EF%BC%89-%E3%81%98%E3%82%83%E3%81%91%E3%81%87%EF%BC%88%E5%B2%A1%E7%94%B0-%E6%8B%93%E5%B7%B3%EF%BC%89-ebook/dp/B09BV2HGN3

https://www.amazon.co.jp/React-js%EF%BC%86Next-js%E8%B6%85%E5%85%A5%E9%96%80-%E7%AC%AC2%E7%89%88-%E6%8E%8C%E7%94%B0%E6%B4%A5%E8%80%B6%E4%B9%83-ebook/dp/B08XBNGYVH/ref=sr_1_1?__mk_ja_JP=%E3%82%AB%E3%82%BF%E3%82%AB%E3%83%8A&crid=249RZW799PCNR&keywords=React+Next&qid=1643594101&sprefix=react+next%2Caps%2C219&sr=8-1

### ■Next.js公式チュートリアル

https://nextjs.org/learn/basics/create-nextjs-app

### ■YouTube

https://www.youtube.com/user/1492tiger

(さいごに：
色々教えてくれたお二人ありがとうございました！@suzu1997 @hiroki-yama-1118)