TypeScriptでGatsby.jsチュートリアル

2019年1月5日追記: Gatsby.jsがv1であることを明記。チュートリアルへのリンクが最新版(現時点ではv2)になっていたので、v1へのリンクに修正。

----

[React](https://reactjs.org/)ベースの静的サイトジェネレータ**[Gatsby.js (v1)](https://v1.gatsbyjs.org/)**のチュートリアルを、TypeScriptで動かしました。

https://v1.gatsbyjs.org/tutorial/

[TypeScript](https://www.typescriptlang.org/)はJavaScriptに静的型付けを追加した言語です。[Visual Studio Code](https://code.visualstudio.com/)などのエディタで補完が効くといった嬉しい事があります。

## 環境

- Windows 10 Pro Insider Preview Build 17074 (Windows Subsystem for Linux)
- Gatsby.js **v1.9.207**

### 準備

まずは[公式のチュートリアル](https://v1.gatsbyjs.org/tutorial/part-one/)に沿ってプロジェクトを構築します。

```
$ yarn add gatsby-cli
$ ./node_modules/.bin/gatsby new gatsby_ts
$ cd gatsby_ts
$ npm run develop
```

http://localhost:8000 にアクセスすると閲覧できます。

### gatsby-plugin-typescript

Gatsby.jsには公式のTypeScriptプラグインが提供されています。

https://www.gatsbyjs.org/packages/gatsby-plugin-typescript/

まずプラグインをインストールします。

```
$ yarn add gatsby-plugin-typescript typescript
```

`gatsby-config.js`に、プラグインを有効化する設定を追加します。

```js:gatsby-config.js
  plugins: [
    `gatsby-plugin-typescript`
  ];
```

`tsconfig.json`を追加します。

```json:tsconfig.json
{
  "compilerOptions": {
    "outDir": "./dist/",
    "sourceMap": true,
    "noImplicitAny": true,
    "module": "commonjs",
    "target": "esnext",
    "jsx": "react",
    "lib": ["dom", "es2015", "es2017"]
  },
  "include": ["./src/**/*"]
}
```

これで、`.tsx`拡張子のファイルをTypeScriptとしてコンパイルしてくれるようになります。

## Gatsby.js Tutorial

ここから実際にGatsby.jsのチュートリアルを進めていきます。
なおJavaScriptとTypeScriptは共存できるので、今回はチュートリアル通りに進めてから部分的にTypeScriptにしていく事で違いを調べていきました。

### Part 1: Interactive page

https://v1.gatsbyjs.org/tutorial/part-one/#interactive-page

ReactのStateを使って動的なページを作るパートです。
React+TypeScriptでは、stateとpropsについては別途`interface`を宣言することで型情報を定義することができます。

`src/pages/counter.tsx`を下記のようにすることで、チュートリアルと同じようなカウンタを実現できます。

```tsx:src/pages/counter.tsx
import * as React from "react";

interface CounterState {
  count: number;
}

class Counter extends React.Component<any, CounterState> {
  constructor(args) {
    super(args)
    this.state = { count: 0 }
  }
  render() {
    return (
      <div>
        <h1>Counter</h1>
        <p>current count: {this.state.count}</p>
        <button onClick={() => this.setState({ count: this.state.count + 1 })}>plus
        </button>
        <button onClick={() => this.setState({ count: this.state.count - 1 })}>minus
        </button>
      </div>
    )
  }
}

export default Counter;
```

### Part 2: CSS Modules

https://v1.gatsbyjs.org/tutorial/part-two/#css-modules

コンポーネントを定義するパートです。

CSS ModulesでCSSファイルをimportするところで、CSSには型定義情報が無いためTypeScriptでは警告が出てしまいます。
解決方法はいくつかありますが、ここではimportの代わりにrequireで読み込んでいます。

```tsx:src/pages/about-css-modules.tsx
import * as React from "react";
import Container from "../components/container";

declare function require(x: string): any;
const styles = require('./about-css-modules.module.css');
console.log(styles);

const User = props =>
  <div className={styles.user}>
    <img src={props.avatar} className={styles.avatar} alt="" />
    <div className={styles.description}>
      <h2 className={styles.username}>
        {props.username}
      </h2>
      <p className={styles.excerpt}>
        {props.excerpt}
      </p>
    </div>
  </div>

export default () =>
  <Container>
    <h1>About CSS Modules</h1>
    <p>CSS Modules are cool</p>
    <User
      username="Jane Doe"
      avatar="https://s3.amazonaws.com/uifaces/faces/twitter/adellecharles/128.jpg"
      excerpt="I'm Jane Doe. Lorem ipsum dolor sit amet, consectetur adipisicing elit."
    />

    <User
      username="Bob Smith"
      avatar="https://s3.amazonaws.com/uifaces/faces/twitter/vladarbatov/128.jpg"
      excerpt="I'm Bob smith, a vertically aligned type of guy. Lorem ipsum dolor sit amet, consectetur adipisicing elit."
    />

  </Container>
```

```tsx:src/components/container.tsx
import * as React from "react";

export default ({ children }) => (
  <div style={{ margin: "3rem auto", maxWidth: 600 }}>{children}</div>
);
```

参考:
- [How to use CSS Modules with TypeScript and webpack – Artem Sapegin – Medium](https://medium.com/@sapegin/css-modules-with-typescript-and-webpack-6b221ebe5f10)
- [TypeScriptでNode\.jsのモジュールをrequireする \- Qiita](https://qiita.com/JunSuzukiJapan/items/134f3a2b342c4804b498)

### Part 3: Our first layout component

https://v1.gatsbyjs.org/tutorial/part-three/#our-first-layout-component

レイアウトテンプレートを作るパートです。
ここはTypeScriptにおいて特筆することはありません。

```tsx:src/layouts/index.tsx
import * as React from "react";
import Link from "gatsby-link";

const ListLink = props =>
  <li style={{ display: `inline-block`, marginRight: `1rem` }}>
    <Link to={props.to}>
      {props.children}
    </Link>
  </li>

export default ({ children }) => (
  <div style={{ margin: `0 auto`, maxWidth: 650, padding: `1.25rem 1rem` }}>
    <header style={{ marginBottom: `1.5rem` }}>
      <Link to="/" style={{ textShadow: `none`, backgroundImage: `none` }}>
        <h3 style={{ display: `inline` }}>MySweetSite</h3>
      </Link>
      <ul style={{ listStyle: `none`, float: `right` }}>
        <ListLink to="/">Home</ListLink>
        <ListLink to="/about/">About</ListLink>
        <ListLink to="/contact/">Contact</ListLink>
      </ul>
    </header>
    <h3>MySweetSite</h3>
    {children()}
  </div>
);
```

### Part 4: Programmatically creating pages from data

https://v1.gatsbyjs.org/tutorial/part-seven/

[GraphQL](http://graphql.org/)を使ってブログを作るパートです。

TypeScriptにおいて大きく異なるのは、GraphQLで取得するデータの`interface`を定義する所です。

```tsx:src/pages/index.tsx
import * as React from "react";
import g from "glamorous";
import Link from "gatsby-link";
import { rhythm } from "../utils/typography";

export default class extends React.Component<IndexPageProps, any> {
  constructor(props:IndexPageProps, state: any){
    super(props, state);
  }

  public render() {
    return (
      <div>
        <g.H1 display={"inline-block"} borderBottom={"1px solid"}>
          Amazing Pandas Eating Things
        </g.H1>
        <h4>{this.props.data.allMarkdownRemark.totalCount} Posts</h4>
        {this.props.data.allMarkdownRemark.edges.map(( atricle ) => (
          <div key={atricle.node.id}>
            <Link
              to={atricle.node.fields.slug}
              // チュートリアルではcss=だが、style=にしている。参考: https://github.com/gatsbyjs/gatsby/pull/3320
              style={{ textDecoratison: `none`, color: `inherit` }}
            >
              <g.H3 marginBottom={rhythm(1 / 4)}>
                {atricle.node.frontmatter.title}{" "}
                <g.Span color="#BBB">— {atricle.node.frontmatter.date}</g.Span>
              </g.H3>
              <p>{atricle.node.excerpt}</p>
            </Link>
          </div>
        ))}
      </div>
    );
  }
};

interface IndexPageProps {
  data: {
    allMarkdownRemark: {
      totalCount: number;
      edges: [
        {
          node: {
            id: string;
            frontmatter: {
              title: string;
              date: string;
            }
            fields: {
              slug: string;
            }
            excerpt: string;
          }
        }
      ]
    }
  };
}

// 本当はここも何とかしたい
declare function graphql(x: TemplateStringsArray): any;
export const query = graphql`
  query IndexQuery {
    allMarkdownRemark {
      totalCount
      edges {
        node {
          id
          frontmatter {
            title
            date(formatString: "DD MMMM, YYYY")
          }
          fields {
            slug
          }
          excerpt
        }
      }
    }
  }
`;
```

`interface`の定義は一見面倒ですが、こうすることでエディタ上で補完したり定義情報が確認できるようになります。
このあたりがTypeScriptの強みです。

![20180225_vscode.png](https://qiita-image-store.s3.amazonaws.com/0/50391/a868b19e-4154-028a-7a2e-bffbdb7009a8.png)

templatesも、同様にして下記のように定義できます。

```tsx:src/templates/blog-post.tsx
import * as React from "react";

export default class extends React.Component<BlogPostPageProps, any> {
  constructor(props:BlogPostPageProps, state: any){
    super(props, state);
  }

  public render() {
    const post = this.props.data.markdownRemark;
    return (
      <div>
        <h1>{post.frontmatter.title}</h1>
        <div dangerouslySetInnerHTML={{ __html: post.html }} />
      </div>
    );
  }
};

interface BlogPostPageProps {
  data: {
    markdownRemark: {
      html: string;
      frontmatter: {
        title: string;
      }
    }
  };
}

declare function graphql(x: TemplateStringsArray): any;
export const query = graphql`
  query BlogPostQuery($slug: String!) {
    markdownRemark(fields: { slug: { eq: $slug } }) {
      html
      frontmatter {
        title
      }
    }
  }
`;
```

`gatsby-node.js`での読み込むテンプレートファイル名を変更するのも忘れないようにしましょう。

```diff:gatsby-node.js
        result.data.allMarkdownRemark.edges.forEach(({ node }) => {
          createPage({
            path: node.fields.slug,
-           component: path.resolve(`./src/templates/blog-post.js`),
+           component: path.resolve(`./src/templates/blog-post.tsx`),
            context: {
              // Data passed to context is available in page queries as GraphQL variables.
              slug: node.fields.slug,
```

## まとめ

このように、TypeScriptでもGatsby.jsを動かすことができました。

大規模なサイトや複雑なデータ構造を扱う際にはTypeScriptの静的型付けが効果的だと思います。しかしGatsby.jsが想定しているような利用範囲内でTypeScriptと相性が良いかどうかは未知数です。簡単なサイトをさくっと作りたい場合はJavaScriptの方が生産性が高いのではないかと思われます。

### 参考

- [TypeScriptを使ってreactのチュートリアルを進めると捗るかなと思った\(実際捗る\) \- Qiita](https://qiita.com/m0a/items/d723259cdeebe382b5f6)
- [gatsby/index\.tsx at master · gatsbyjs/gatsby](https://github.com/gatsbyjs/gatsby/blob/master/examples/using-typescript/src/pages/index.tsx)