使用するバージョン
next : 11.0.1
react : 17.0.2

プロジェクトの作成

プロジェクトを作成するディレクトリで下記を実行。
npmの場合はyarnをnpxに置き換えてください。

$ yarn create next-app --typescript

プロジェクト名を聞かれるので入力してエンター。

? What is your project named? › my-app

新しいディレクトリが作られているのでカレントにしましょう。

$ cd my-app

これで準備完了

下記を実行することでローカルサーバーが起動します。

$ yarn dev

ブラウザでhttp://localhost:3000にアクセスして「Welcome to Next.js!」が表示されることを確認してください。

ページの編集

最初に表示されたページを編集してみましょう。
pages/index.tsxを下記のようにしてみましょう。

pages/index.tsx

  1. import Head from 'next/head'
  2.  
  3. export default function Home() {
  4. return (
  5. <div>
  6. <Head>
  7. <title>ホームページタイトル</title>
  8. <meta name="description" content="ホームページ概要" />
  9. </Head>
  10. <h1>ホームページタイトル</h1>
  11. </div>
  12. )
  13. }

こんなところにって感じですが、Headで囲むことで、ページのheadタグ内の要素を追加することができます。

ブラウザを更新して内容が変わっているこをと確認してください。

ページの追加

新しくページを追加してみましょう。
先ほどのindex.tsxと同階層にabout.tsxというファイルを作成します。

pages/about.tsx

  1. import Head from 'next/head'
  2.  
  3. export default function About() {
  4. return (
  5. <div>
  6. <Head>
  7. <title>自己紹介タイトル</title>
  8. <meta name="description" content="自己紹介概要" />
  9. </Head>
  10. <h1>自己紹介タイトル</h1>
  11. </div>
  12. )
  13. }

ブラウザでhttp://localhost:3000/aboutにアクセスしてファイルの情報が表示されることを確認してください。
このようにNext.jsではpagesディレクトリにファイルを配置するだけで表示することができます。

ページのリンク

リンクは通常のhtmlと同様にaタグを使用することができますが、Linkコンポーネントを使用することで高速で画面遷移できたりとかその他にも色々メリットがあります。

pages/index.tsx

  1. import Head from 'next/head'
  2. import Link from 'next/link'
  3. import styles from '../styles/Home.module.css'
  4.  
  5. export default function Home() {
  6. return (
  7. <div className="wrap">
  8. <Head>
  9. <title>Next.js使ってみた</title>
  10. <meta name="description" content="Next.jsのテストです。" />
  11. </Head>
  12. <nav>
  13. <ul>
  14. <li><Link href="/">Home</Link></li>
  15. <li><Link href="/about">About</Link></li>
  16. </ul>
  17. </nav>
  18. <h1>Next.js使ってみた</h1>
  19. </div>
  20. )
  21. }

レイアウトコンポーネント

先ほどナビゲーションを作りましたが、こいうのはすべてのページに共通のものを入れることが多いと思います。
共通で使用できるようにレイアウト用のコンポーネントを作ってみましょう。

components/layout.tsx

  1. import Head from 'next/head'
  2. import Link from 'next/link'
  3.  
  4. type Props = {
  5. children?: React.ReactNode
  6. title?: string
  7. description?: string
  8. }
  9.  
  10. export default function Layout({ children, title, description }: Props) {
  11. const pageTitle = title || 'ホームページタイトル'
  12. return (
  13. <div className="wrap">
  14. <Head>
  15. <title>{ pageTitle }</title>
  16. <meta name="description" content={ description || 'ホームページ概要' } />
  17. </Head>
  18. <header>
  19. <h1>{ pageTitle }</h1>
  20. </header>
  21. <nav>
  22. <ul>
  23. <li><Link href="/">Home</Link></li>
  24. <li><Link href="/about">About</Link></li>
  25. </ul>
  26. </nav>
  27. <main>{ children }</main>
  28. <footer>&copy; Next.js Demo</footer>
  29. </div>
  30. )
  31. }

このレイアウトコンポーネントをindex.tsxで使用します。

components/layout.tsx

  1. import Link from 'next/link'
  2. import Layout from '../components/layout'
  3. import styles from '../styles/Home.module.css'
  4.  
  5. export default function Home() {
  6. return (
  7. <Layout
  8. title="ホームページタイトル"
  9. description="ホームページ概要"
  10. >
  11. <p>ホームページコンテンツ</p>
  12. </Layout>
  13. )
  14. }

スタイルについて

スタイルは最初からstylesディレクトリにCSSファイルが入っています。
styles/globals.cssは自動的に読み込まれるのですべてのページに反映したいスタイルなどに使用します。
ページ専用のスタイルを使用したい場合はstyles/Home.module.cssのようなファイルを作成します。

例えば文字を赤くするスタイルを作ったとすると。

styles/Home.module.css

  1. .colorRed {
  2. color: red;
  3. }

インポートして使用することでファイル間のクラス名のバッティングを回避することができます。

pages/index.tsx

  1. import styles from '../styles/Home.module.css'
  2. // ...
  3. <p className={styles.colorRed}>ホームページコンテンツ</p>

静的HTMLに書き出す

ざっと使い方がわかったので最後にビルドしてみましょう。
最終的にどのような運用をするかによって変わってくると思いますが、今回は静的なHTMLに書き出してみます。

package.jsonbuild部分を次のように書き換えます。

package.json

  1. "scripts": {
  2. // ...
  3. "build": "next build && next export",
  4. },

次に下記コマンドを実行

$ yarn build

outというディレクトリが作成され、その中にHTMLファイルとかが入っています。

outというディレクトリ名を変更することもできます。
next export-oオプションを追加しましょう。

package.json

  1. "scripts": {
  2. // ...
  3. "build": "next build && next export -o dist",
  4. },