
## TL;DR

このページでは、TypeScript の強力な機能である「ユニオン型」について、解説していきますね。一言で言うと、ユニオン型とは異なる型を持つ値を一つの変数が取り扱えるようにするための方法です。

| 開発環境   | バージョン |
| :--------- | :--------- |
| Next.js    | 13.4.4     |
| TypeScript | 5.0.4      |
| Emotion    | 11.11.0    |
| React      | 18.2.0     |

### ユニオン型とは？

TypeScript のユニオン型とは、複数の型を一つの変数が取り扱えるようにする機能であり、これにより柔軟なプログラミングが可能になります。型の異なる複数の値を一つの変数で管理できるという考え方が、ユニオン型の根底にあります。例えば、以下のようなコードが考えられます。

```tsx
type StringOrNumber = string | number

let unionVar: StringOrNumber

unionVar = 'Hello World'
console.log(unionVar) // "Hello World"

unionVar = 123
console.log(unionVar) // 123
```

上記の例では、`StringOrNumber` というユニオン型を定義しています。この型は、`string` または `number` のどちらかの型を取ることができます。そのため、`unionVar` という変数は、文字列でも、数値でも問題なく代入でき、その時点での値の型がその後の振る舞いを決定します。

これがユニオン型の基本的な使い方です。しかし、実際の開発ではもう少し複雑なケースが多いです。例えば、オブジェクトのプロパティが特定の型の場合に他のプロパティの型が変わるといった状況もあります。

### ユニオン型とリテラル型の組み合わせ

TypeScript の力強さは、それ自体の型システムだけでなく、その型がどのように組み合わされるかにも由来しています。例えば、ユニオン型とリテラル型を組み合わせることで、特定の文字列または数値のセットのみを受け入れる型を作成できます。

以下に、リテラル型とユニオン型を組み合わせた例を示します。この例では、'red'、'green'、'blue'のいずれかの値のみを受け入れる`Color`型を作成しています。

```tsx
type Color = 'red' | 'green' | 'blue'

const setColor = (color: Color) => {
  console.log(`The color is ${color}`)
}
```

この`setColor`関数は、`Color`型の値、つまり`'red'`、`'green'`、`'blue'`のいずれかを引数として受け取ります。それ以外の値を受け取ろうとすると、TypeScript はエラーを出してくれます。これは、コードの保守性を高め、エラーを事前に防ぐ一助となります。

### ユニオン型と型ガード

TypeScript では、「型ガード」という考え方があります。型ガードは、あるスコープ内で変数の型を確認する機能で、ユニオン型と組み合わせると非常に強力なツールになります。

以下に、ユニオン型と型ガードを組み合わせた例を示します。この例では、`formatInput`関数は`string`型か`number`型の値を受け入れ、それぞれ異なる処理を行います。

```tsx
type InputType = string | number

const formatInput = (input: InputType) => {
  if (typeof input === 'string') {
    return input.toUpperCase()
  } else {
    return input.toFixed(2)
  }
}
```

この`formatInput`関数では、引数`input`が文字列か数値かを`typeof`演算子を使用してチェックしています。これにより、同一の関数内で型に応じた異なる処理を行うことができます。このような型チェックを「型ガード」と呼びます。

### 複数のコンポーネントをまとめて型定義する

まずは、React コンポーネントにおけるユニオン型の使用例です。以下の例では、複数のコンポーネントをまとめて型定義し、一つのコンポーネントとして扱うことができます。

```tsx
import React, { ReactNode } from 'react'

// コンポーネントの型を定義
type ButtonProps = {
  variant: 'button'
  onClick: () => void
  children: ReactNode
}

type LinkProps = {
  variant: 'link'
  href: string
  children: ReactNode
}

// これらをユニオン型でまとめる
type ButtonOrLinkProps = ButtonProps | LinkProps

// コンポーネントの定義
const ButtonOrLink = (props: ButtonOrLinkProps): JSX.Element => {
  if (props.variant === 'button') {
    // ButtonPropsとして扱う
    return <button onClick={props.onClick}>{props.children}</button>
  } else {
    // LinkPropsとして扱う
    return <a href={props.href}>{props.children}</a>
  }
}

export default ButtonOrLink
```

このコードでは、`ButtonOrLinkProps` というユニオン型が `ButtonProps` と `LinkProps` を組み合わせたものとして定義されています。これにより、`ButtonOrLink` コンポーネントは `button` プロパティと `link` プロパティの両方を持つことができ、それぞれ違った振る舞いをします。

### Redux の Action をユニオン型で扱う

さらに、Redux のアクションの型をユニオン型で管理する例も見てみましょう。

```tsx
// actions/index.ts

// 各アクションの型を定義
type AddTodoAction = {
  type: 'ADD_TODO'
  payload: { id: number; text: string }
}

type ToggleTodoAction = {
  type: 'TOGGLE_TODO'
  payload: { id: number }
}

// ユニオン型でまとめる
type Action = AddTodoAction | ToggleTodoAction

// reducerの定義
function todoReducer(state = [], action: Action) {
  switch (action.type) {
    case 'ADD_TODO':
      return [...state, action.payload]
    case 'TOGGLE_TODO':
      return state.map((todo) => (todo.id === action.payload.id ? { ...todo, completed: !todo.completed } : todo))
    default:
      return state
  }
}
```

このコードでは、`Action` というユニオン型が `AddTodoAction` と `ToggleTodoAction` を組み合わせたものとして定義されています。これにより、`todoReducer` は `ADD_TODO` アクションと `TOGGLE_TODO` アクションの両方を管理することができ、それぞれ違った振る舞いをします。

これらの例を通じて、TypeScript のユニオン型はプログラムの柔軟性と安全性を高める強力なツールであることが理解いただけると幸いです。

### Next.js で、ユニオン型を活用

それでは、Next.js のコード内でユニオン型をどのように活用できるのかについて、具体的なソースコードを通じて説明していきましょう。

まず、ユニオン型を利用して、異なるタイプの通知を表現する `Notification` コンポーネントを作成します。

```tsx
// components/Notification.tsx

import React from 'react'

type NotificationProps = {
  message: string
  type: 'success' | 'error' | 'info'
}

const Notification = ({ message, type }: NotificationProps) => {
  let backgroundColor
  switch (type) {
    case 'success':
      backgroundColor = 'green'
      break
    case 'error':
      backgroundColor = 'red'
      break
    case 'info':
    default:
      backgroundColor = 'blue'
  }

  return <div style={{ backgroundColor }}>{message}</div>
}

export default Notification
```

上記の `NotificationProps` 型では、`type` プロパティが `'success'`、`'error'`、`'info'` のいずれかの値を持つことを示しています。これは文字列のユニオン型を用いて表現されています。

次に、この `Notification` コンポーネントを呼び出す方法を見てみましょう。

```tsx
// pages/index.tsx

import React from 'react'
import Notification from '../components/Notification'

const Home = () => {
  return (
    <div>
      <Notification message="操作が成功しました！" type="success" />
      <Notification message="エラーが発生しました！" type="error" />
      <Notification message="新しい機能が追加されました！" type="info" />
    </div>
  )
}

export default Home
```

### ユニオン型を活用した型の絞り込み

さらに、TypeScript のユニオン型を活用すると、より堅牢なコードを書くことができます。以下に、複数の型のユニオン型を絞り込むための型ガードを使用した例を示します。

```tsx
// utils/typeGuards.ts

type User = {
  name: string
  age: number
}

type Admin = {
  name: string
  privileges: string[]
}

type UnknownEmployee = User | Admin

function printEmployeeInformation(emp: UnknownEmployee) {
  console.log('Name: ' + emp.name)
  if ('privileges' in emp) {
    console.log('Privileges: ' + emp.privileges.join(', '))
  }
  if ('age' in emp) {
    console.log('Age: ' + emp.age)
  }
}

printEmployeeInformation({ name: 'Hiroshi', age: 20 })
printEmployeeInformation({ name: 'Riko', privileges: ['create-server'] })
```

このコードでは、`UnknownEmployee` 型は `User` 型と `Admin` 型のユニオン型です。この型の変数を引数として受け取る `printEmployeeInformation` 関数では、`in` 演算子を使用して、引数が `User` 型か `Admin` 型かを判定し、それに応じて異なる処理を行っています。


Next.js と TypeScript を使用し、ユニオン型の魅力とその使い方を実例を交えて詳しく解説します。

Next.js と TypeScript で、ユニオン型の使い方を学ぶ

この記事ではJavaScriptの基礎の解説を包括的にまとめたチートシート形式で提供します。

初心者に分かりやすい！JavaScript 入門チートシート


## TL;DR

このページでは、JavaScript の `some()` メソッドの活用方法について解説します。一言で言うと、`some()` メソッドは配列の要素が一つでも指定した条件を満たすかをチェックするためのメソッドです。

| 開発環境   | バージョン |
| :--------- | :--------- |
| Next.js    | 13.4.4     |
| TypeScript | 5.0.4      |
| Emotion    | 11.11.0    |
| React      | 18.2.0     |

### some() メソッドとは？

まず始めに `some()` メソッドについて詳しく解説します。このメソッドは JavaScript の配列メソッドで、配列のいずれかの要素が指定した条件を満たすかどうかを確認します。戻り値は boolean 型（`true` または `false`）で、条件を満たす要素が一つでも存在すれば `true` を、一つもなければ `false` を返します。

次に、その基本的な使い方について見てみましょう。

```tsx
const array = [1, 2, 3, 4, 5]

const isAnyNumberGreaterThan3 = array.some((num) => num > 3) // true
```

上記のコードでは、配列 `array` の中に 3 より大きい数字が一つでも含まれているかどうかを確認しています。配列内の数字 `4` と `5` がこの条件を満たすため、`some()` メソッドは `true` を返します。

some()メソッドは、配列の要素が特定の条件を満たすかどうかを確認するために使用されますが、その使い方は多岐にわたります。

### 複数の条件を満たす要素が含まれているか確認する

複数の条件を満たす要素が配列内に含まれているかを確認するためにも使用することができます。以下に例を示します。

```tsx
type Item = {
  id: number
  name: string
}

const array: Item[] = [
  { id: 1, name: 'Apple' },
  { id: 2, name: 'Banana' },
  { id: 3, name: 'Cherry' },
]

const hasBanana = array.some((value) => value.id === 2 && value.name === 'Banana') // true
```

上記の例では、id が 2 で名前が Banana である要素が配列に含まれているかどうかを確認しています。

some()メソッドの使い方は以上のように非常に幅広く、JavaScript でのプログラミングにおいて役立つ機能を提供しています。

### Next.js で、some() メソッドを実装

それでは、Next.js と TypeScript を使って、`some()` メソッドを具体的にどのように活用するのかを見ていきましょう。以下のコードは、Next.js での `pages/index.tsx` ファイルを示しています。

```tsx
// pages/index.tsx
import { useState } from 'react'

type Todo = {
  id: number
  text: string
  completed: boolean
}

const IndexPage = () => {
  const [todos, setTodos] = useState<Todo[]>([
    { id: 1, text: 'Buy milk', completed: false },
    { id: 2, text: 'Study TypeScript', completed: false },
  ])

  const hasIncompleteTodos = todos.some((todo) => !todo.completed)

  return (
    <div>
      <h1>Todo List</h1>
      {todos.map((todo) => (
        <div key={todo.id}>
          <p>{todo.text}</p>
        </div>
      ))}
      {hasIncompleteTodos && <p>You have incomplete todos!</p>}
    </div>
  )
}

export default IndexPage
```

このファイルは、Todo リストを表示する基本的なコンポーネントを定義しています。`Todo` という型を定義し、それに基づく `todos` ステートを作成しています。そして、`some()` メソッドを使って未完了の Todo が一つでもあるかどうかをチェックし、未完了の Todo がある場合にはメッセージを表示します。

### 具体的な利用シーン

`some()` メソッドは配列の要素が特定の条件を満たすかどうかをチェックするのに非常に便利です。それでは具体的な利用シーンを考えてみましょう。

```tsx
// components/Alert.tsx
type Props = {
  users: { name: string; isOnline: boolean }[]
}

const Alert = ({ users }: Props) => {
  const isAnyUserOnline = users.some((user) => user.isOnline)

  return <div>{isAnyUserOnline ? <p>Some of your friends are online.</p> : <p>No one is online right now.</p>}</div>
}

export default Alert
```

上記の `Alert` コンポーネントでは、`users` プロパティを受け取り、その中のユーザーが一人でもオンラインかどうかを `some()` メソッドでチェックしています。そして、その結果に基づいて異なるメッセージを表示します。

### パフォーマンスの観点から

最後に、`some()` メソッドの利点としてパフォーマンスの観点を挙げられます。

```tsx
// utils/anyGreaterThan.ts
type Data = {
  values: number[]
}

const anyGreaterThan = ({ values }: Data, target: number): boolean => {
  return values.some((value) => value > target)
}

export default anyGreaterThan
```

ここでは、大きな数値の配列から一つでも特定の値より大きいものがあるかどうかを確認しています。`some()` メソッドは、一つでも条件を満たす要素を見つけた時点で検索を停止するので、大きな配列に対しても効率的に動作します。

以上、`some()` メソッドの活用方法とその便利さについて詳しく見てきました。このメソッドを活用すれば、JavaScript で配列の一部の要素が特定の条件を満たすかどうかを簡単にチェックできます。Next.js や TypeScript の開発においても有効に活用できますので、ぜひ覚えておいてください。


some() メソッドとは何か、どのように使うのかについて Next.js と TypeScript を用いて解説します。初心者でも理解できるような形で紐解いていきます。

Next.js と TypeScript で、some() メソッドを活用する


## TL;DR

このページでは、"オプショナルチェーン（?.）"の実装方法について解説しますね。一言でいうとオプショナルチェーンとは、あるオブジェクトが undefined または null の場合でもエラーを発生させずに undefined を返すための便利な機能です。

| 開発環境   | バージョン |
| :--------- | :--------- |
| Next.js    | 13.4.4     |
| TypeScript | 5.0.4      |
| Emotion    | 11.11.0    |
| React      | 18.2.0     |

### オプショナルチェーンとは？

JavaScript と TypeScript の世界では、一部のオブジェクトが undefined または null になる可能性があります。これは頻繁に発生する場面で、例えば API からのレスポンスが想定した形式ではなかったり、ユーザー入力が想定外だったりすると起こり得ます。そのため、開発者は常に null チェックや undefined チェックを行わなければなりません。

しかし、そのようなチェックが多くなると、コードは読みにくく、保守しにくくなります。ここでオプショナルチェーンの出番です。オプショナルチェーンを使えば、安全にプロパティにアクセスし、その値が存在しない場合はただちに undefined を返すことができます。

```tsx
let user = {
  name: 'Taro',
  address: {
    zip: '123-4567',
    prefecture: 'Tokyo',
    city: null,
  },
}

console.log(user?.address?.city) // null
console.log(user?.address?.street?.name) // undefined
```

ここでは、`user.address.city` の値は `null` で、`user.address.street.name` は存在しないプロパティにアクセスしようとしていますが、エラーを出すことなく `undefined` を返します。

### Next.js で、オプショナルチェーンを活用

Next.js のコンテクストでは、オプショナルチェーンはデータの取り扱いを大いに簡略化します。以下にその一例を示します。

`/components/UserProfile.tsx`

```tsx
import { useEffect, useState } from 'react'

type User = {
  id: number
  name: string
  address?: {
    zip: string
    prefecture: string
    city?: string
  }
}

const UserProfile = () => {
  const [user, setUser] = useState<User | null>(null)

  useEffect(() => {
    fetchUser().then((user) => setUser(user))
  }, [])

  return (
    <div>
      <p>{user?.name}</p>
      <p>{user?.address?.zip}</p>
      <p>{user?.address?.city}</p>
    </div>
  )
}

async function fetchUser(): Promise<User> {
  // ここで実際のAPIリクエストを行います。
}

export default UserProfile
```

このコンポーネントでは、API から取得したユーザー情報を表示しています。しかし、すべてのユーザーが address や city を持っているわけではありません。オプショナルチェーンを使用することで、それらのプロパティが存在しない場合でもエラーを発生させずに安全にコードを実行することができます。

### オプショナルチェーンと Nullish Coalescing

オプショナルチェーンの強力なパートナーとして、「Nullish Coalescing（??）」があります。これは、左側の値が null または undefined の場合に、右側の値を返す演算子です。これにより、値が存在しない場合のデフォルト値を簡単に指定することができます。

```tsx
const UserProfile = ({ user }: { user: User | null }) => (
  <div>
    <p>{user?.name ?? '名前がありません'}</p>
    <p>{user?.address?.zip ?? '郵便番号がありません'}</p>
    <p>{user?.address?.city ?? '市区町村がありません'}</p>
  </div>
)
```

ここでは、ユーザーの名前、郵便番号、市区町村が存在しない場合、代替のメッセージを表示しています。これにより、アプリケーションはユーザーフレンドリーでありながらも、安全にデータを操作することができます。

### TypeScript でのオプショナルチェーンの型推論

TypeScript の威力を最大限に引き出すためには、適切な型定義が欠かせません。オプショナルチェーンと組み合わせることで、より安全で予測可能なコードを書くことが可能になります。

```tsx
type User = {
  id: number
  name: string
  address?: {
    zip: string
    prefecture: string
    city?: string
  }
}

const UserProfile = ({ user }: { user: User | null }) => (
  <div>
    <p>{user?.name}</p>
    <p>{user?.address?.zip}</p>
    <p>{user?.address?.city}</p>
  </div>
)
```

この例では、User 型の `address` フィールドがオプショナルであり、さらにその中の `city` フィールドもオプショナルであることを示しています。これにより、TypeScript はこのフィールドが存在しない可能性があることを認識し、それに対応するコード（オプショナルチェーン）を書くように促します。

以上、オプショナルチェーンを利用した Next.js と TypeScript のコード実装について詳しく解説しました。この特性を使うことで、存在しない可能性のあるプロパティに安全にアクセスし、より堅牢なアプリケーションを構築することができます。さらに、Nullish Coalescing と組み合わせることで、デフォルト値を簡単に指定できます。


Next.js と TypeScript を使って、安全性と可読性を高めるオプショナルチェーンの考え方と実装方法を解説します。

Next.js と TypeScript で、オプショナルチェーン（?.）を活用する


## TL;DR

このページでは、スクロール時のイベント実行について詳しく解説しますね。一言でいうとスクロール時のイベント実行とは、ユーザーがページをスクロールするときに特定の処理を実行することです。例えば、ページの一部を見えるようにする、あるいはページの上に戻るボタンを表示するなどの処理を考えてみてください。

| 開発環境   | バージョン |
| :--------- | :--------- |
| Next.js    | 13.4.4     |
| TypeScript | 5.0.4      |
| Emotion    | 11.11.0    |
| React      | 18.2.0     |

### スクロール時のイベント実行

スクロール時のイベント実行とは、ユーザーがウェブページをスクロールするときに特定の処理を実行する考え方のことを指します。スクロールに反応して何らかのアクションを実行することで、ユーザー体験を向上させたり、ユーザーに情報をより効率的に提供したりすることができます。

具体的な例としては、次のようなシナリオを考えてみてください。

- ユーザーがページを下にスクロールするとナビゲーションバーが消え、上にスクロールすると再び表示される。
- ユーザーがページを下にスクロールすると「ページトップに戻る」ボタンが表示される。

これらの挙動は、ウェブサイトのインターフェースをユーザーが期待するように動作させるために重要です。それでは、基本的なスクロールイベントリスナーを設定する方法を見てみましょう。

```tsx
// components/ScrollListener.tsx

// useEffect を React からインポート
import { useEffect } from 'react'

// ScrollListener という関数コンポーネントを作成
const ScrollListener = () => {
  // useEffect フックを使用。
  // このフックは、コンポーネントのマウント後、アンマウント前、
  // および更新後に実行される処理を記述するためのもの
  useEffect(() => {
    // handleScroll 関数を定義。
    // この関数は window（ブラウザウィンドウ）のスクロール位置を取得し、
    // それをコンソールに出力する
    const handleScroll = () => {
      console.log(window.scrollY)
      // window.scrollY は、現在のスクロール位置をピクセル単位で表す
    }

    // window（ブラウザウィンドウ）のスクロールイベントに対して、
    // handleScroll 関数をイベントリスナーとして登録
    window.addEventListener('scroll', handleScroll)

    // useEffect の cleanup 処理。
    // コンポーネントがアンマウントされる（ページから削除される）ときに実行される
    // ここでは、window のスクロールイベントリスナーを削除している。
    // これにより、コンポーネントが存在しない場合でも
    // handleScroll 関数が実行されないようにする
    return () => {
      window.removeEventListener('scroll', handleScroll)
    }
  }, []) // useEffect の依存配列。
  // ここが空の配列（[]）なので、
  // この useEffect フック内の処理は
  // コンポーネントの初回マウント時とアンマウント時のみに実行される

  // ScrollListener コンポーネントの表示部分。
  // ここではシンプルな div 要素を表示している
  return <div>Scroll Listener</div>
}

// ScrollListener コンポーネントを
// export（他のファイルからインポート可能にする）
export default ScrollListener
```

このコードは、スクロールイベントを検知してコンソールに現在のスクロール位置を出力します。`useEffect` フック内でスクロールイベントリスナーを設定して、スクロール時に `handleScroll` 関数が実行されるようにしています。そして、コンポーネントのアンマウント時にイベントリスナーを削除することで、メモリリークを防ぎます。

### Next.js で、スクロール時のイベントを実装

では、具体的なシナリオを見ていきましょう。ここでは、ページをスクロールすると「ページトップに戻る」ボタンが表示され、そのボタンをクリックするとページのトップに戻るという機能を実装します。

まずは、そのボタンのコンポーネントを作成します。

```tsx
// components/ScrollToTopButton.tsx

// useState, useEffect を React からインポート
import { useState, useEffect } from 'react'

// Props の型定義。showAfter はスクロール量
type Props = {
  showAfter: number // スクロール量後にボタン表示
}

// ScrollToTopButton 関数コンポーネントの定義
const ScrollToTopButton = ({ showAfter }: Props) => {
  // isShown という state を定義。初期状態は false（非表示）
  const [isShown, setIsShown] = useState(false)

  // useEffect フックを使用
  useEffect(() => {
    // handleScroll 関数を定義。スクロール量をチェック
    const handleScroll = () => {
      // スクロール量が showAfter 以上なら表示
      if (window.scrollY >= showAfter) {
        setIsShown(true)
      } else {
        setIsShown(false) // それ以外は非表示
      }
    }

    // スクロールイベントに対し handleScroll を登録
    window.addEventListener('scroll', handleScroll)

    // cleanup 処理。コンポーネントアンマウント時に実行
    return () => {
      // スクロールイベントリスナーを削除
      window.removeEventListener('scroll', handleScroll)
    }
  }, [showAfter]) // showAfter の変更時に再実行

  // handleClick 関数を定義。ページトップへスムーズにスクロール
  const handleClick = () => {
    window.scrollTo({ top: 0, behavior: 'smooth' })
  }

  // isShown が false の場合、null を返し何も表示しない
  if (!isShown) return null

  // isShown が true の場合、ボタンを表示
  return <button onClick={handleClick}>Scroll to top</button>
}

// ScrollToTopButton コンポーネントをエクスポート
export default ScrollToTopButton
```

### Emotion でスタイル付けを行う

次に、Emotion を使ってスタイルを付けてみましょう。Emotion は JavaScript 内に CSS を書くことができる CSS-in-JS ライブラリで、スタイルの再利用やコンポーネントベースのスタイリングを容易にします。

```tsx
// components/ScrollToTopButton.tsx

// css を @emotion/react からインポート
import { css } from '@emotion/react'
// useState, useEffect を React からインポート
import { useState, useEffect } from 'react'

// Props の型定義。showAfter はスクロール量
type Props = {
  showAfter: number // スクロール量後にボタン表示
}

// ScrollToTopButton 関数コンポーネントの定義
const ScrollToTopButton = ({ showAfter }: Props) => {
  // isShown という state を定義。初期状態は false（非表示）
  const [isShown, setIsShown] = useState(false)

  // useEffect フックを使用
  useEffect(() => {
    // handleScroll 関数を定義。スクロール量をチェック
    const handleScroll = () => {
      // スクロール量が showAfter 以上なら表示
      if (window.scrollY >= showAfter) {
        setIsShown(true)
      } else {
        setIsShown(false) // それ以外は非表示
      }
    }

    // スクロールイベントに対し handleScroll を登録
    window.addEventListener('scroll', handleScroll)

    // cleanup 処理。コンポーネントアンマウント時に実行
    return () => {
      // スクロールイベントリスナーを削除
      window.removeEventListener('scroll', handleScroll)
    }
  }, [showAfter]) // showAfter の変更時に再実行

  // handleClick 関数を定義。ページトップへスムーズにスクロール
  const handleClick = () => {
    window.scrollTo({ top: 0, behavior: 'smooth' })
  }

  // isShown が false の場合、null を返し何も表示しない
  if (!isShown) return null

  // isShown が true の場合、ボタンを表示
  // css props により buttonStyle を適用
  return (
    <button onClick={handleClick} css={buttonStyle}>
      Scroll to top
    </button>
  )
}

// buttonStyle の定義。css prop によるスタイル付け
const buttonStyle = css`
  position: fixed;
  bottom: 20px;
  right: 20px;
  padding: 10px 20px;
  border: none;
  border-radius: 4px;
  background: #333;
  color: #fff;
  cursor: pointer;
`

// ScrollToTopButton コンポーネントをエクスポート
export default ScrollToTopButton
```

ここでは、ボタンコンポーネントに CSS を適用しています。Emotion は `css` 関数とテンプレートリテラルを使用して CSS を定義し、その定義をコンポーネントに適用します。この方法で、ボタンが右下の位置に固定され、適切なスタイリングが施されます。

### 呼び出し側のコード

最後に、このボタンコンポーネントをページから呼び出してみましょう。

```tsx
// pages/index.tsx

import ScrollToTopButton from '../components/ScrollToTopButton'

const HomePage = () => {
  return (
    <div>
      {/* Other components... */}
      <ScrollToTopButton showAfter={300} />
    </div>
  )
}

export default HomePage
```

このように、`ScrollToTopButton` コンポーネントは `showAfter` プロパティを受け取り、その値に基づいて表示・非表示を切り替えます。

以上が Next.js と TypeScript を使ったスクロールイベントの実装です。このような実装を通して、ユーザーがページの特定の部分にスクロールしたときに特定の動作を行うといったインタラクティブな体験を提供できます。さらに、イベントリスナーの追加と削除を適切に行うことで、パフォーマンスの問題を防ぐこともできます。


この記事では、Next.jsとTypeScriptを使って、スクロール時のイベントをどのように実装するのか詳しく解説します。

Next.js と TypeScript で、スクロール後「上に戻る」ボタンを実装


## TL;DR

このページでは、スクロールの途中でメニューを固定する実装方法について解説しますね。ウェブページをスクロールしても特定のメニューだけは常に画面上部に表示され続ける機能を Next.js と TypeScript で実装します。

| 開発環境   | バージョン |
| :--------- | :--------- |
| Next.js    | 13.4.4     |
| TypeScript | 5.0.4      |
| Emotion    | 11.11.0    |
| React      | 18.2.0     |

### スクロールの途中でメニューを固定する

ウェブサイトを利用していると、特定の位置までスクロールした時点でメニューバーやヘッダーが画面上部に固定され、その後スクロールしても画面上部に表示され続けるという現象を目にすることがあるでしょう。これはユーザー体験を高めるための一つの手法であり、ユーザーがいつでもナビゲーションメニューにアクセスできるようにすることで、サイトの利用がよりスムーズになります。

では、基本的な実装方法について解説します。

```tsx
import { useState, useEffect } from 'react'

// Props型定義。固定化するスクロール位置を示すthresholdを受け取る。
type Props = {
  threshold: number
}

const StickyMenu = ({ threshold }: Props) => {
  // isStickyというstateを定義。デフォルトはfalse（非固定状態）
  const [isSticky, setIsSticky] = useState(false)

  useEffect(() => {
    // スクロールイベントのハンドラー定義。
    // スクロール位置がthresholdを超えるとisStickyをtrueに設定
    const handleScroll = () => {
      const currentScrollY = window.scrollY // 現在のスクロール位置を取得
      setIsSticky(currentScrollY > threshold) // 現在位置が閾値を超えていればisStickyをtrueに
    }

    // スクロールイベントにhandleScrollを登録
    window.addEventListener('scroll', handleScroll)

    // コンポーネントアンマウント時にイベントリスナーを削除
    return () => {
      window.removeEventListener('scroll', handleScroll)
    }
  }, [threshold]) // thresholdが変更されたらuseEffectを再実行

  // isStickyがtrueならpositionをfixedにし、
  // そうでなければrelativeに設定
  return <div style={{ position: isSticky ? 'fixed' : 'relative' }}>{/* Menu content */}</div>
}
```

ここでは、`StickyMenu`というコンポーネントを作成しています。このコンポーネントは`threshold`というプロッパティを受け取り、この値を基準にしてスクロール位置を判断します。

`threshold`よりもスクロール位置が下だった場合、`isSticky`を`true`に設定します。そして、`isSticky`が`true`の時はメニューの位置を`fixed`に設定し、それ以外の時は`relative`に設定します。これにより、特定のスクロール位置を超えたらメニューが固定されるようになります。

### Next.js で、「スクロールの途中でメニューを固定する」を実装

次に、この`StickyMenu`コンポーネントを Next.js のプロジェクトで使ってみましょう。

pages/index.tsx

```tsx
import { StickyMenu } from '../components/StickyMenu' // StickyMenuコンポーネントのインポート

// IndexPageというReactコンポーネントの定義
const IndexPage = () => (
  <>
    {/* StickyMenuコンポーネントの利用。スクロール位置が200を超えた時にメニューを固定化 */}
    <StickyMenu threshold={200}>
      {/* メニューアイテムのリスト */}
      <ul>
        <li>
          <a href="#section1">Section 1</a>
        </li>
        <li>
          <a href="#section2">Section 2</a>
        </li>
      </ul>
    </StickyMenu>
  </>
)

// IndexPageコンポーネントをエクスポート
export default IndexPage
```

この例では、`StickyMenu`をインポートし、その子要素としてメニュー項目を配置しています。また、`threshold`プロパティに 200 を指定していますので、200px スクロールした時点でメニューが画面上部に固定されます。

### メニューのスタイルを追加

次に、メニューにスタイルを追加しましょう。ここでは Emotion を使って CSS-in-JS のスタイリングを行います。

```tsx
/** @jsxImportSource @emotion/react */
// @emotion/reactとcssをインポート
import { css } from '@emotion/react'
import { useState, useEffect } from 'react' // ReactのuseState, useEffectをインポート

type Props = {
  threshold: number // thresholdプロパティを定義
}

// StickyMenuというコンポーネントの定義
const StickyMenu = ({ threshold }: Props) => {
  // isStickyというstateを定義、初期値はfalse
  const [isSticky, setIsSticky] = useState(false)

  // useEffectフックを使用。
  // スクロール位置がthresholdを超えたときにisStickyをtrueにする
  useEffect(() => {
    const handleScroll = () => {
      const currentScrollY = window.scrollY // 現在のスクロール位置を取得
      setIsSticky(currentScrollY > threshold) // スクロール位置がthresholdを超えているかチェック
    }

    // スクロールイベントリスナーを設定
    window.addEventListener('scroll', handleScroll)
    // コンポーネントアンマウント時にイベントリスナーを削除
    return () => {
      window.removeEventListener('scroll', handleScroll)
    }
  }, [threshold]) // thresholdが変更されたときにeffectを再実行

  // メニューのスタイルを定義。isStickyの値に基づいてスタイルを切り替え
  const menuStyle = css`
    position: ${isSticky ? 'fixed' : 'relative'};
    top: 0;
    width: 100%;
    background: white;
    box-shadow: ${isSticky ? '0 2px 4px rgba(0, 0, 0, 0.2)' : 'none'};
  `

  // コンポーネントをレンダリング。スタイルはmenuStyleを適用
  return <div css={menuStyle}>{/* Menu content */}</div>
}
```

ここでは、`menuStyle`という変数を用意し、その中にスタイルを定義しています。`isSticky`が`true`の時は`position`を`fixed`にし、`top`を 0 にすることでメニューを画面上部に固定しています。また、`isSticky`が`true`の時だけ`box-shadow`を適用することで、固定されたメニューに影をつけています。

### メニュー項目のスクロール先を指定

最後に、各メニュー項目がクリックされた時に該当するセクションにスクロールするようにします。

```tsx
const StickyMenu = ({ threshold }: Props) => {
  // omitted...

  const handleItemClick = (event: React.MouseEvent<HTMLAnchorElement>) => {
    event.preventDefault()
    const targetId = event.currentTarget.getAttribute('href')
    const targetElement = document.querySelector(targetId)
    if (targetElement) {
      window.scrollTo({
        top: targetElement.getBoundingClientRect().top + window.pageYOffset - 100,
        behavior: 'smooth',
      })
    }
  }

  return (
    <div css={menuStyle}>
      <ul>
        <li>
          <a href="#section1" onClick={handleItemClick}>
            Section 1
          </a>
        </li>
        <li>
          <a href="#section2" onClick={handleItemClick}>
            Section 2
          </a>
        </li>
        {/* More menu items */}
      </ul>
    </div>
  )
}
```

ここでは、各`<a>`要素の`onClick`イベントに`handleItemClick`関数を設定しています。この関数は、クリックされた要素の`href`属性を取得し、それが指す要素にスクロールします。`window.scrollTo`メソッドを使ってスクロールを行い、`top`オプションに目標の要素の位置を指定しています。また、`-100`を追加してメニューの高さを考慮し、`behavior`オプションに`'smooth'`を指定することでスムーズなスクロールを実現しています。

以上のように、Next.js と TypeScript を使用することで、「スクロールの途中でメニューを固定する」機能を簡単かつ効率的に実装することができます。


この記事では、Next.js と TypeScript を使って、スクロールの途中でメニューを固定するという実装方法を分かりやすく解説します。

Next.js と TypeScript で、スクロールの途中でメニューを固定する方法


## TL;DR

このページでは、Next.js での認証の実装方法について解説します。認証はユーザーが誰であるかを確認するプロセスで、Next.js ではさまざまな認証パターンをサポートしています。それぞれのパターンは異なるユースケースに対応して設計されています。

> この記事は、Next.js の公式ドキュメンテーションを参考について解説しています。特に、[Authenticating](https://nextjs.org/docs/pages/building-your-application/routing/authenticating)のセクションを基に、その内容を理解しやすく解釈し直し、さらに詳細な説明を加えています。
>
> この記事は、Next.js の公式ドキュメンテーションの素晴らしい内容を尊重し、その知識を広めることを目指しています。そのため、この記事の内容は、公式ドキュメンテーションの内容をそのまま意訳するのではなく、それを基に私たち自身の理解と経験を元にした解釈と説明を加えています。
>
> もし、より詳細な情報や公式の説明を求める場合は、[Next.js の公式ドキュメンテーション](https://nextjs.org/docs)を直接ご覧いただくことを強く推奨します。この記事の解説はあくまで参考の一つであり、公式ドキュメンテーションには、より詳細な情報や最新の更新情報が含まれています。

| 開発環境   | バージョン           |
| :--------- | :------------------- |
| Next.js    | 13.4.4(Pages Router) |
| TypeScript | 5.0.4                |
| Emotion    | 11.11.0              |
| React      | 18.2.0               |

### 認証とは

認証は、ユーザーが誰であるかを確認するプロセスです。一方、認可はユーザーがアクセスできる内容を制御します。Next.js はさまざまな認証パターンをサポートしており、それぞれが異なるユースケースに対応するように設計されています。

### 認証パターン

認証パターンを選ぶときの最初のステップは、あなたがどのようにデータを取得したいかを理解することです。これを「データフェッチング戦略」と呼びます。それを理解したら、どの認証プロバイダ（認証を手助けしてくれるツールやサービス）がその戦略をサポートしているかを決められます。主なパターンは 2 つあります：

その 1：静的生成を使用してローディング状態をサーバーレンダリングし、その後クライアントサイドでユーザーデータを取得する。

これは、まずサーバーでページを作成し、そのページに「ローディング...」のようなメッセージを表示します。そして、そのページがユーザーのブラウザに表示された後で、JavaScript を使ってユーザーのデータを取得します。これは、ページがすぐに表示され、その後でデータが更新されるという流れになります。

その 2：ユーザーデータをサーバーサイドで取得し、認証されていないコンテンツのフラッシュを排除する。

これは、サーバーでページを作成するときに、すぐにユーザーデータを取得します。その結果、ページがユーザーのブラウザに表示されるときには、すでにすべてのデータが揃っています。これにより、「認証されていないコンテンツのフラッシュ」、つまり、一瞬だけログインしていないと思われる状態が表示されることを防ぐことができます。

### 静的生成されたページの認証

Next.js は、ページが特別なデータをすぐに必要としない場合、そのページは静的（あらかじめ作られている）だと自動的に判断します。これは、ページに `getServerSideProps` や `getInitialProps` という特別な関数がないことを意味します。その代わり、あなたのページは最初に「ローディング中...」のような状態を表示し、その後、ユーザーのブラウザでユーザーデータを取得します。

この方法の良い点は、ページが世界中のどこからでもすぐに取得でき、ページの表示が早くなることです。具体的には、ユーザーがページと対話できるまでの時間が短くなります。

例えば、プロフィールページを考えてみましょう。このページは最初に「ローディング中...」のような状態を表示します。そして、ユーザーデータの取得が完了すると、ユーザーの名前が表示されます。

```tsx
// pages/profile.js
import useUser from '../lib/useUser'
import Layout from '../components/Layout'

const Profile = () => {
  // クライアントサイドでユーザーを取得します
  const { user } = useUser({ redirectTo: '/login' })

  // サーバーでローディング状態をレンダリングします
  if (!user || user.isLoggedIn === false) {
    return <Layout>Loading...</Layout>
  }

  // ユーザーのリクエストが完了したら、ユーザーを表示します
  return (
    <Layout>
      <h1>Your Profile</h1>
      <pre>{JSON.stringify(user, null, 2)}</pre>
    </Layout>
  )
}

export default Profile
```

### サーバーレンダリングされたページの認証

ページから `getServerSideProps` という非同期関数をエクスポートすると、Next.js は各リクエストでこのページを `getServerSideProps` によって返されたデータを使用して事前レンダリングします。

```tsx
export async function getServerSideProps(context) {
  return {
    props: {}, // Will be passed to the page component as props
  }
}
```

プロフィールの例をサーバーサイドレンダリングを使用するように変更してみましょう。セッションがある場合、ユーザーをページのプロフィールコンポーネントのプロップとして返します。この例ではローディングスケルトンはありません。

```tsx
// pages/profile.js
import withSession from '../lib/session'
import Layout from '../components/Layout'

// サーバーサイドでユーザーデータを取得します
export const getServerSideProps = withSession(async function ({ req, res }) {
  // セッションからユーザーデータを取得します
  const { user } = req.session

  // ユーザーデータがない場合、ログインページにリダイレクトします
  if (!user) {
    return {
      redirect: {
        destination: '/login',
        permanent: false,
      },
    }
  }

  // ユーザーデータがある場合、そのデータをページのプロップとして返します
  return {
    props: { user },
  }
})

const Profile = ({ user }) => {
  // ユーザーデータを表示します。ローディング状態は必要ありません
  return (
    <Layout>
      <h1>Your Profile</h1>
      <pre>{JSON.stringify(user, null, 2)}</pre>
    </Layout>
  )
}

export default Profile
```

このパターンの利点は、リダイレクトする前に認証されていないコンテンツのフラッシュを防ぐことです。`getServerSideProps` でユーザーデータをフェッチすると、認証プロバイダへのリクエストが解決するまでレンダリングがブロックされることに注意してください。ボトルネックを作成し、TTFB（Time to First Byte、最初のバイトまでの時間）を増加させないように、認証ルックアップが高速であることを確認する必要があります。そうでなければ、静的生成を検討してください。

### 認証プロバイダ

Google、Facebook、GitHub などの組み込みプロバイダ、JWT、JWE、メール/パスワード、マジックリンクなどを含むフル機能の認証システムが必要な場合は、next-auth を使用します。

#### Next-Auth

Next-Auth は、Next.js のためのフル機能の認証ソリューションです。Google、Facebook、GitHub などの組み込みプロバイダ、JWT、JWE、メール/パスワード、マジックリンクなどをサポートしています。

Next-Auth は、どちらの認証パターンもサポートしています。つまり、静的生成を使用してクライアントサイドでユーザーデータをフェッチすることも、サーバーサイドでユーザーデータをフェッチして認証されていないコンテンツのフラッシュを排除することも可能です。

Next-Auth を使用すると、認証プロバイダへのリクエストが解決するまでレンダリングがブロックされることに注意してください。認証ルックアップが高速であることを確認する必要があります。そうでなければ、静的生成を検討してください。

以下に Next-Auth の基本的な実装例を示します。

```tsx
// pages/api/auth/[...nextauth].js
import NextAuth from 'next-auth'
import Providers from 'next-auth/providers'

export default NextAuth({
  // プロバイダの設定
  providers: [
    Providers.GitHub({
      clientId: process.env.GITHUB_ID,
      clientSecret: process.env.GITHUB_SECRET,
    }),
    // 他のプロバイダも追加可能
  ],

  // データベースの設定
  database: process.env.DATABASE_URL,

  // セッションの設定
  session: {
    jwt: true,
  },

  // JWTの設定
  jwt: {
    secret: process.env.JWT_SECRET,
  },
})
```

このコードは、`pages/api/auth/[...nextauth].js`というファイルに配置します。Next-Auth は、GitHub を認証プロバイダとして使用する設定を示しています。`clientId`と`clientSecret`は、GitHub の OAuth アプリケーションから取得します。

また、この設定では JWT（JSON Web Tokens）を使用してセッションを管理しています。これは、ユーザーの認証情報を安全に保存するための方法です。`jwt.secret`は、JWT を暗号化するための秘密鍵です。

データベースの設定では、`process.env.DATABASE_URL`を使用してデータベースへの接続を設定します。これは、あなたのデータベースへの接続文字列を環境変数から取得します。

この設定を使用すると、Next-Auth は`/api/auth/signin`、`/api/auth/signout`、`/api/auth/session`などの API ルートを自動的に作成します。これらのルートは、ユーザーの認証とセッション管理に使用されます。

#### 認証機能を含むディレクトリツリー

Next-Auth を組み込むときの基本的なディレクトリツリーは以下のようになります。ユーザープロフィールと CRUD（Create, Read, Update, Delete）操作を含む場合、それぞれの機能に対応するページや API エンドポイントを追加します。

```
.
├── pages
│   ├── api
│   │   ├── auth
│   │   │   └── [...nextauth].js  // Next-Authの設定ファイル
│   │   ├── user
│   │   │   ├── index.js          // ユーザー一覧（Read）
│   │   │   └── [id].js           // 特定のユーザーに対するCRUD操作
│   ├── profile
│   │   └── index.js              // ユーザープロフィールページ
│   ├── create.js                 // ユーザー作成（Create）ページ
│   ├── update.js                 // ユーザー更新（Update）ページ
│   └── delete.js                 // ユーザー削除（Delete）ページ
├── lib
│   └── session.js                // セッション管理用のライブラリ
├── components
│   ├── Layout.js                 // 共通レイアウトコンポーネント
│   └── UserProfile.js            // ユーザープロフィール表示コンポーネント
├── .env.local                    // 環境変数
├── package.json
└── next.config.js
```

この構成では、`/api/user`と`/api/user/[id]`のエンドポイントを使用してユーザーデータの CRUD 操作を行います。`/api/user`はユーザー一覧を取得するために使用し、`/api/user/[id]`は特定のユーザーに対する操作（取得、更新、削除）を行います。

また、ユーザープロフィールページは`/profile`に配置します。このページでは、ログイン中のユーザーのプロフィール情報を表示します。

ユーザーの作成、更新、削除の各操作に対応するページも提供します。これらのページでは、ユーザー情報の入力フォームと、それに対応する API へのリクエストを行う機能を提供します。

#### 環境変数

Next-Auth を使用する際には、環境変数を設定することが一般的です。環境変数は、アプリケーションの設定や秘密情報を管理するために使用されます。

Next-Auth では、以下のような情報を環境変数として設定することがあります。

1. 認証プロバイダのクライアント ID とクライアントシークレット: Next-Auth を使用して OAuth プロバイダ（Google、Facebook、GitHub など）で認証を行う場合、クライアント ID とクライアントシークレットを環境変数として設定します。これらの値は、プロバイダから取得します。

2. データベース URL: Next-Auth を使用してデータベースに接続する場合、データベースへの接続文字列を環境変数として設定します。

3. JWT の秘密鍵: Next-Auth を使用して JWT（JSON Web Tokens）を使用したセッション管理を行う場合、JWT を暗号化するための秘密鍵を環境変数として設定します。

これらの環境変数は、`.env.local`ファイルに保存することが一般的です。このファイルは、アプリケーションのルートディレクトリに配置します。Next.js は、デフォルトで`.env.local`ファイルから環境変数を読み込みます。

環境変数を使用することで、秘密情報をソースコードから分離し、セキュリティを向上させることができます。また、環境変数を使用することで、開発環境と本番環境で異なる設定を簡単に行うことができます。

Next-Auth の設定に関連する環境変数の一例を以下に示します。これらの値は`.env.local`ファイルに保存します。

```bash
# .env.local

# GitHub OAuthの設定
GITHUB_ID=your_github_client_id
GITHUB_SECRET=your_github_client_secret

# データベース接続文字列
DATABASE_URL=your_database_connection_string

# JWTの秘密鍵
JWT_SECRET=your_jwt_secret
```

上記の`your_github_client_id`、`your_github_client_secret`、`your_database_connection_string`、`your_jwt_secret`は、それぞれ実際の値に置き換えてください。

- `GITHUB_ID`と`GITHUB_SECRET`は、GitHub の OAuth アプリケーションから取得します。これらの値は GitHub で認証を行うために使用します。

- `DATABASE_URL`は、データベースへの接続文字列です。この値は、Next-Auth がデータベースに接続するために使用します。

- `JWT_SECRET`は、JWT（JSON Web Tokens）を暗号化するための秘密鍵です。この値は、Next-Auth が JWT を使用したセッション管理を行うために使用します。

なお、`.env.local`ファイルは公開リポジトリには含めないように注意してください。このファイルは`.gitignore`ファイルに追加し、Git の管理対象から除外します。

### Tips

Next-Auth を組み込む際には、以下のような Tips が役立つかもしれません。

1. 環境変数の管理: Next-Auth の設定には、クライアント ID、クライアントシークレット、データベース URL など、秘密情報を含む環境変数が多く使用されます。これらの情報は`.env.local`ファイルなどに保存し、公開されないように管理することが重要です。

2. セッション管理: Next-Auth は、JWT（JSON Web Tokens）を使用したセッション管理をサポートしています。これにより、ユーザーの認証情報を安全に保存することができます。ただし、JWT はデータ量が大きくなるとパフォーマンスに影響を与える可能性があるため、必要な情報のみを保存するように注意してください。

3. プロバイダの選択: Next-Auth は、多くの認証プロバイダ（Google、Facebook、GitHub など）をサポートしています。プロジェクトの要件に応じて、最適なプロバイダを選択してください。

4. エラーハンドリング: Next-Auth の API ルートは、認証に関連するエラーを返す可能性があります。これらのエラーを適切にハンドリングし、ユーザーに適切なフィードバックを提供することが重要です。


Next.js での認証の実装方法について解説します。静的生成とサーバーサイドレンダリングを用いた認証パターンと、それぞれの利点と使用例について詳しく説明します。

Next.js と TypeScript で、認証の実装方法を理解する


## TL;DR

このページでは、Rest パラメータの実装方法について解説しますね。一言でいうと Rest パラメータとは、JavaScript や TypeScript で関数に可変長の引数を渡すための特別な構文です。では、実際に使ってみましょう。

| 開発環境   | バージョン |
| :--------- | :--------- |
| Next.js    | 13.4.4     |
| TypeScript | 5.0.4      |
| Emotion    | 11.11.0    |
| React      | 18.2.0     |

### Rest パラメータ（残余引数）とは？

Rest パラメータは、JavaScript と TypeScript の関数で、引数の数が不確定な場合に使用します。Rest パラメータを使うと、複数の引数を配列としてまとめることができます。

Rest パラメータとは、関数に任意の数の引数を渡すことを可能にする JavaScript と TypeScript の特性を指します。

この特性は "残余引数" とも呼ばれ、3 つのドット（...）を引数名の前に付けることで利用できます。これにより、関数は可変数の引数を配列として受け取ることができます。

```tsx
const sampleFunction = (...args: number[]) => {
  /* ... */
}
```

この `sampleFunction` は、引数の数がいくつであっても処理できます。ここで、`args` は配列として扱われ、関数内部で配列のメソッドを利用することができます。

また、Rest パラメータ（残余引数）は引数リストの最後にしか置くことができず、一つの関数内では一度しか使うことができません。これらは、Rest パラメータを使用する際の重要なルールです。

以下は、基本的な Rest パラメータの使用方法です。

```tsx
const sum = (...numbers: number[]): number => {
  return numbers.reduce((prev, current) => prev + current, 0)
}

console.log(sum(1, 2, 3, 4)) // 10
```

上記の `sum` 関数は、`...numbers: number[]`という形で Rest パラメータを定義しています。この `...numbers`は、関数 `sum`に渡された任意の数の引数を`numbers`という配列にまとめてくれます。この関数は、`1`, `2`, `3`, `4`といった任意の数の引数を受け取り、それらをすべて足し合わせた結果を返します。

### Rest パラメータは関数の引数リストの最後に書く

Rest パラメータは関数の引数リストの最後にある必要があります。

Rest パラメータは、その位置から関数の最後までのすべての引数を配列にまとめる役割を持っています。そのため、Rest パラメータの後に他の引数を置くことはできません。以下のようなコードは無効です。

```tsx
// これは無効です。
const invalidFunction = (...args: number[], anotherArg: string) => {
  // do something
}
```

これを TypeScript で実行しようとすると、コンパイラは次のようなエラーメッセージを出力します：

```
A rest parameter must be last in a parameter list.
```

これは、「Rest パラメータはパラメータリストの最後でなければならない」という意味です。

### Rest パラメータについて理解する際に注意すべき点

Rest パラメータについて理解する際に注意すべき点としては以下の 2 つがあります。

1. Rest パラメータは引数リストの最後にしか配置できません。
2. Rest パラメータは一つの関数内で一度だけしか使用できません。

分かりやすい例を一つ挙げましょう。以下は、与えられた全ての数字を合計する関数を Rest パラメータを使って実装したものです。

```tsx
type NumericArray = number[]

const sum = (...numbers: NumericArray) => {
  let total = 0
  for (const num of numbers) {
    total += num
  }
  return total
}

console.log(sum(1, 2, 3, 4)) // 10を出力します。
```

この例では、`sum` 関数は任意の数の引数を取ることができます。これらの引数はすべて `numbers` 配列に格納され、それを用いて総和を求めています。

なお、Rest パラメータは TypeScript の特性であり、JavaScript や他の多くのプログラミング言語でも使われている特性です。これにより関数が可変長の引数を柔軟に扱うことができ、コードの再利用性と可読性を向上させることができます。

### Next.js で、Rest パラメータを実装

それでは Next.js と TypeScript を使って、Rest パラメータの実装例を見てみましょう。今回は、複数の CSS スタイルを結合する `mergeStyles`関数を作成します。

`components/mergeStyles.tsx`:

```tsx
import { css, SerializedStyles } from '@emotion/react'

type Styles = SerializedStyles | SerializedStyles[]

const mergeStyles = (...styles: Styles[]): SerializedStyles => {
  return css(styles.flat())
}

export default mergeStyles
```

この `mergeStyles`関数では、`...styles: Styles[]`という形で Rest パラメータを受け取ります。これにより、引数として複数のスタイルオブジェクトを受け取ることができます。そして、`styles.flat()`により、ネストされた配列もフラットにすることができます。

### Emotion での利用例

それでは、作成した `mergeStyles`関数を Emotion で利用してみましょう。Next.js のコンポーネントで、複数のスタイルを結合して適用する例を示します。

`components/MyComponent.tsx`:

```tsx
/** @jsxImportSource @emotion/react */
import { css } from '@emotion/react'
import mergeStyles from './mergeStyles'

type Props = {
  isActive: boolean
}

const MyComponent = ({ isActive }: Props) => {
  const activeStyle = css`
    color: blue;
  `

  const baseStyle = css`
    font-size: 16px;
  `

  return <div css={mergeStyles(baseStyle, isActive && activeStyle)}>Hello, World!</div>
}

export default MyComponent
```

このコンポーネントでは、`mergeStyles(baseStyle, isActive && activeStyle)`という形で、`mergeStyles`関数を利用しています。`isActive`が`true`の場合、`activeStyle`が適用され、`false`の場合は適用されません。これにより、動的にスタイルを結合することができます。

### API ルートの動的パラメータ

Next.js では、API ルートでも Rest パラメータを活用することができます。これにより、動的な URL パラメータを扱うことが可能になります。以下に、その例を示します。

`pages/api/user/[...username].ts`:

```tsx
import type { NextApiRequest, NextApiResponse } from 'next'

type Params = {
  username: string[]
}

type Data = {
  username: string
}

const handler = (req: NextApiRequest, res: NextApiResponse<Data>) => {
  const { username } = req.query as Params

  res.status(200).json({ username: username.join('/') })
}

export default handler
```

この API ルートでは、`[...username]`という形で Rest パラメータを定義しています。この形式を使うことで、`/api/user/john/doe`のような URL が全てこの API ルートにマッチします。そして、`username`パラメータは`['john', 'doe']`という配列として取得できます。


Next.js と TypeScript を使って、Rest パラメータを活用する方法を初学者にも理解できるよう解説します。

Next.js と TypeScript で、Rest パラメータ（残余引数）...を使う


## TL;DR

このページでは、「タイマーアプリを作る」方法について解説します。一言で言うと「タイマーアプリ」とは、特定の時間を設定し、その時間が経過したら通知するアプリのことです。

| 開発環境   | バージョン |
| :--------- | :--------- |
| Next.js    | 13.4.4     |
| TypeScript | 5.0.4      |
| Emotion    | 11.11.0    |
| React      | 18.2.0     |

### 「タイマーアプリ」コンポーネント

「タイマーアプリ」は、指定した時間が経過したら通知を出すというシンプルなアプリケーションです。ただし、そのシンプルさがユーザーにとって使いやすさを生むため、実装面では細部まで注意を払う必要があります。最も基本的な要素としては「時間の設定」「時間のカウントダウン」「時間経過の通知」の 3 つが挙げられます。

以下に、一番基本的なタイマーアプリの機能をもつコンポーネントを見ていきましょう。

```tsx
// ファイル名: components/BasicTimer.tsx
// ReactとReactのHooksであるuseStateをインポートしています
import React, { useState } from 'react'

// プロパティの型定義を行います。ここでは、初期カウントをnumber型で受け取るようにしています
type Props = {
  initialCount: number
}

// Functional Componentを定義します。Props型の初期カウントを受け取ります
const BasicTimer = ({ initialCount }: Props) => {
  // カウントの状態とその更新関数を定義します。初期値はPropsから受け取った初期カウントです
  const [count, setCount] = useState(initialCount)

  // tick関数を定義します。カウントが0より大きいとき、カウントを1減らします
  const tick = () => {
    if (count > 0) setCount((prevCount) => prevCount - 1)
  }

  // useEffect Hookを使って、コンポーネントのレンダリング後に実行する処理を設定します
  React.useEffect(() => {
    // 1秒ごとにtick関数を実行するタイマーを設定します
    const timerId = setInterval(() => {
      tick()
    }, 1000)

    // クリーンアップ関数を定義します。この関数はコンポーネントがアンマウントされたとき、
    // または依存配列が更新されたときに呼ばれます。
    // ここではタイマーをクリアします
    return () => clearInterval(timerId)
  }, [count]) // 依存配列にカウントを指定します。
  // これにより、カウントが変更されるたびにエフェクトが実行されます

  // カウントを表示するdiv要素をレンダリングします
  return <div>{count}</div>
}

// BasicTimerコンポーネントをエクスポートします。
// 他のファイルからimportして使うことができます
export default BasicTimer
```

このコンポーネントでは、React の`useState`と`useEffect`を使って、カウントダウンの機能を実装しています。`useState`は状態管理のためのもので、ここではタイマーのカウントを管理しています。`useEffect`は副作用を扱うためのもので、ここでは時間が経過するたびにカウントを減らしています。

このコードをより詳しく見ていきましょう。

まず、`useState`を使ってカウントの初期値を設定します。次に`tick`という関数を定義し、カウントが 0 より大きい場合はカウントを 1 減らすようにします。そして、`useEffect`を使って 1 秒ごとに`tick`関数を実行します。これにより、カウントダウンの機能が実現できます。また、`useEffect`のクリーンアップ関数でタイマーをクリアして、メモリリークを防ぎます。

以上が、タイマーアプリの基本的な仕組みとなります。しかし、現実のタイマーアプリではさらに多くの機能が必要となるでしょう。例えば、時間の設定、カウントダウンの一時停止、再開、リセットなどの機能が求められます。次のセクションでは、これらの機能を含むより実用的なタイマーアプリを Next.js と TypeScript で作成していきます。

### Next.js で、タイマーアプリを実装

さて、次にタイマーアプリの実装に移ります。ここでは、基本的なタイマー機能に加えて、「時間の設定」「カウントダウンの一時停止」「再開」「リセット」の各機能を実装していきます。

まずは、タイマーコンポーネントの全体のコードから見ていきましょう。

```tsx
// ファイル名: components/TimerApp.tsx
// ReactとReactのHooksであるuseStateをインポートします
import React, { useState } from 'react'

// プロパティの型定義を行います。初期カウントをnumber型で受け取ることができます
type Props = {
  initialCount: number
}

// TimerAppというFunctional Componentを定義します。Props型のinitialCountを受け取ります
const TimerApp = ({ initialCount }: Props) => {
  // カウントとその更新関数をuseState Hookで定義します。
  // 初期値はPropsから受け取った初期カウントです
  const [count, setCount] = useState(initialCount)
  // タイマーが動いているかどうかの状態とその更新関数をuseState Hookで定義します。
  // 初期値はfalseです
  const [isRunning, setIsRunning] = useState(false)

  // タイマーを開始する関数を定義します。isRunningの状態をtrueに更新します
  const start = () => setIsRunning(true)
  // タイマーを一時停止する関数を定義します。isRunningの状態をfalseに更新します
  const pause = () => setIsRunning(false)
  // タイマーをリセットする関数を定義します。カウントを初期カウントに戻し、
  // isRunningの状態をfalseに更新します
  const reset = () => {
    setCount(initialCount)
    setIsRunning(false)
  }

  // カウントダウンを実行する関数を定義します。
  // カウントが0より大きいとき、カウントを1減らします
  const tick = () => {
    if (count > 0) setCount((prevCount) => prevCount - 1)
  }

  // useEffect Hookを使って、コンポーネントのレンダリング後に実行する処理を設定します
  React.useEffect(() => {
    let timerId: NodeJS.Timeout | null = null

    // タイマーが動いていて、カウントが0より大きい場合、
    // 1秒ごとにtick関数を実行するタイマーを設定します
    if (isRunning && count > 0) {
      timerId = setInterval(() => {
        tick()
      }, 1000)
    }

    // クリーンアップ関数を定義します。
    // この関数はコンポーネントがアンマウントされたとき、
    // または依存配列が更新されたときに呼ばれます。ここではタイマーをクリアします
    return () => {
      if (timerId) clearInterval(timerId)
    }
  }, [isRunning, count])
  // 依存配列にisRunningとカウントを指定します。
  // これにより、いずれかが変更されるたびにエフェクトが実行されます

  // カウントと操作ボタンを表示するdiv要素をレンダリングします
  return (
    <div>
      <div>{count}</div> {/* 現在のカウントを表示します */}
      <button onClick={start}>Start</button> {/* Startボタン。クリックするとstart関数が実行されます */}
      <button onClick={pause}>Pause</button> {/* Pauseボタン。クリックするとpause関数が実行されます */}
      <button onClick={reset}>Reset</button> {/* Resetボタン。クリックするとreset関数が実行されます */}
    </div>
  )
}

// TimerAppコンポーネントをエクスポートします。他のファイルからimportして使うことができます
export default TimerApp
```

#### タイマーの制御

このコードでは、まず`useState`を使って`count`と`isRunning`の 2 つの状態を管理しています。

次に、タイマーの一時停止、再開、リセットを行うための`start`、`pause`、`reset`関数を定義しています。`start`関数はタイマーを開始するために、`isRunning`を`true`に設定します。`pause`関数はタイマーを一時停止するために、`isRunning`を`false`に設定します。そして、`reset`関数はカウントを初期値に戻し、タイマーを停止するために、`isRunning`を`false`に設定します。

#### カウントダウン処理

カウントダウンの処理は、`tick`関数と`useEffect`フックを使って行います。`tick`関数はカウントが 0 より大きい場合にカウントを 1 減らします。そして、`useEffect`フックを使って、タイマーが動作していてカウントが 0 より大きい場合に、1 秒ごとに`tick`関数を実行します。

#### コンポーネントのレンダリング

最後に、タイマーの値と、タイマーの開始、一時停止、リセットを行うボタンをレンダリングします。ボタンはそれぞれ`onClick`プロパティを使って、対応する関数を呼び出します。

以上がタイマーアプリの実装となります。ここまでで、タイマーアプリの基本的な機能を持つコンポーネントが完成しました。次にこのコンポーネントを呼び出す方法を見ていきましょう。

### タイマーアプリの呼び出し方法

次に、作成した`TimerApp`コンポーネントを呼び出す方法を見ていきます。`TimerApp`コンポーネントは`initialCount`というプロパティを受け取ります。このプロパティはタイマーの初期値として使われます。

```tsx
// ファイル名: pages/index.tsx
import React from 'react'
import TimerApp from '../components/TimerApp'

const IndexPage = () => {
  return (
    <div>
      <h1>Timer App</h1>
      <TimerApp initialCount={60} />
    </div>
  )
}

export default IndexPage
```

以上が、タイマーアプリの呼び出し方になります。ここでは、`TimerApp`コンポーネントに`60`という初期値を与え、1 分のタイマーを作成しています。

以上で、Next.js と TypeScript を使ったタイマーアプリの作成は完了です。これらのコードを活用して、自分だけのタイマーアプリを作成してみてください。


Next.js と TypeScript を駆使して、シンプルかつパワフルなタイマーアプリを開発する方法について解説します。

Next.js と TypeScript で、タイマーアプリを作る

WordPressのリスクやデメリットを理解し、よりセキュアで効率的なJamstackへの移行の必要性を説明します。

2023-07-07

Next.js と TypeScript で、ユニオン型の使い方を学ぶ

2023-07-05

初心者に分かりやすい！JavaScript 入門チートシート

2023-07-05

Next.js と TypeScript で、some() メソッドを活用する

2023-07-04

Next.js と TypeScript で、オプショナルチェーン（?.）を活用する

2023-07-04

Next.js と TypeScript で、スクロール後「上に戻る」ボタンを実装

2023-07-04

Next.js と TypeScript で、スクロールの途中でメニューを固定する方法

2023-07-03

Next.js と TypeScript で、認証の実装方法を理解する

2023-07-03

Next.js と TypeScript で、Rest パラメータ（残余引数）...を使う

2023-07-03

Next.js と TypeScript で、タイマーアプリを作る

2023-07-03

あなたの知らない WordPress のデメリットとリスク