<p><span style="color:#24292e">おはこんにちばんは。最近、</span>NextJS が出力したOpenAPI (Swagger)  によって記述された API 定義ファイルをもとに、Next.js でTypeScript の型や API クライアントを自動生成したいと思ったのですが、意外とまとまった資料がなかったのでその方法をご紹介します。今回は、openapi generator typescript-axios を元に利用します。<br><br>サンプルはこちら。（<a href="https://github.com/IshinoJun/nextjs-example-openapi-generator" target="_blank" rel="noopener noreferrer">フロント</a>、<a href="https://github.com/IshinoJun/nestjs-example-openapi-generator" target="_blank" rel="noopener noreferrer">バック</a>）<br></p><h2 id="hed900658dc">環境</h2><ul><li>Node.js v12.18.0</li><li>macOS Big Sur</li></ul><p><br></p><h2 id="hb40c68615d">NextJS でAPIを用意</h2><p>こちらに関しては、前回ご紹介した <a href="http://localhost:3000/blogs/nestjs-mikroorm-tutorial" target="_blank" rel="noopener noreferrer">NestJSにMikroORMの導入手順。CRUDのAPIを実装するまで。</a> で利用した<a href="https://github.com/IshinoJun/nestjs-mikroorm-example-app" target="_blank" rel="noopener noreferrer">リポジトリ</a>を修正していきます。<br></p><h3 id="h9133ad7bea">パッケージの導入</h3><p>APIの定義ファイルを出力する必要があるので、<code>Swagger</code> を導入します。</p><pre><code>yarn add @nestjs/swagger swagger-ui-express</code></pre><p><br>次に<code>main.ts</code>に以下の設定情報を追加します。</p><pre><code>./src/main.ts

async function bootstrap() {
  const app = await NestFactory.create(AppModule);

  const config = new DocumentBuilder()
    .setTitle('Example API')
    .setDescription('The Example API description')
    .setVersion('1.0')
    .build();

  const options: SwaggerDocumentOptions = {
    operationIdFactory: (_: string, methodKey: string) =&gt; methodKey,
  };

  const document = SwaggerModule.createDocument(app, config, options);
  SwaggerModule.setup('api', app, document);

  await app.listen(8080);
}</code></pre><p><br>OpenAPI Generatorは API クライアントを生成する際に OperationId を参照しています。一方で nestjs/swagger は OperationIdを<span style="color:#333333">「Controller名 + メソッド名」で出力します。</span><br>なので、 API クライアントでアクセスする際、呼び出しが<code>exampleApi.controller.method</code> となり少しくどくなります。そこで<code>exampleApi.method</code><span style="font-family: Monaco, Courier New, monospace">と</span><span style="color:#333333">するために以下を行なっています。</span></p><pre><code>const options: SwaggerDocumentOptions = {
  operationIdFactory: (_: string, methodKey: string) =&gt; methodKey,
};</code></pre><p><br>最後にコントローラー毎にインスタンスを区切るためにタグを以下のように追加しましょう。</p><pre><code>./src/example/example.controller.ts

@ApiTags('example')
export class ExampleController {
...</code></pre><p><br>これでNestJS側の最低限の設定は以上になります。<br></p><h2 id="h5d6dce4d37">Next.jsにopenapi generator typescript-axios を導入</h2><p>次にNext.js側の設定を行なっていきます。<br></p><h3 id="h702d09d558">プロジェクトを作成</h3><pre><code>yarn create next-app --typescript</code></pre><p><br></p><h3 id="hb15c49acba">パッケージを導入</h3><pre><code>yarn add -D openapitools/openapi-generator-cli

yarn add axios gulp</code></pre><p><br></p><h2 id="h872930db14">openapi generator typescript-axios の設定</h2><p>以下の設定ファイルを追加します。</p><pre><code>./openapiConfig.yml

withSeparateModelsAndApi: true
apiPackage: 'api'
modelPackage: 'dto'
modelPropertyNaming: 'camelCase'
supportsES6: true
withInterfaces: true</code></pre><p><br></p><ul><li>withSeparateModelsAndApi<ul><li>API と model を別々にしたかったので true にしています。</li></ul></li><li>apiPackage<ul><li>api が格納されるフォルダ名を api としたかったので api にしています。</li></ul></li><li>modelPackage<ul><li>model が格納されるフォルダ名を model としたかったので model にしています。</li></ul></li><li>modelPropertyNaming<ul><li>キャメルケースで出力したかったためです。</li></ul></li><li>supportsES6</li><li>withInterfaces<ul><li>使ってもいいかなっと思ったので追加しています。（雑）</li></ul></li></ul><h3 id="h74216feda6"><br>出力するコマンドを追加</h3><p>APIエンドポイントの TypeScript の型 と API クライアント 自動生成するコマンドを追加します。<br>openapi generator は <code>openapi-generator-cli generate -g typescript-axios -i &lt;OpenAPI定義ファイル&gt;&nbsp;-o &lt;出力先&gt;</code>のようなコマンドで出力します。ただ、OpenAPI定義ファイルの出力先が本番や開発環境で変わる可能性があるので、<code>gulp</code> を利用して環境変数から出力先を変えられるようにします。gulpの使い方については省略します。<br><br>以下のファイルを追加します。</p><pre><code>./gulpfile.ts
import * as cp from "child_process";

import { loadEnvConfig } from "@next/env";
import gulp from "gulp";

loadEnvConfig(process.env.PWD ?? "");

gulp.task("generate-example-client", (done) =&gt; {
  cp.spawnSync(
    "openapi-generator-cli",
    [
      "generate",
      "-g",
      "typescript-axios",
      "-i",
      `${process.env.API_JSON_URL ?? ""}`,
      "-o",
      "./openapi-generator/example-api",
      "-c",
      "./openapiConfig.yml",
    ],
    {
      stdio: [process.stdin, process.stdout, process.stderr],
      shell: true,
    }
  );
  done();
});</code></pre><p><br>環境変数には以下を追加します。</p><pre><code>./.env

API_JSON_URL=http://localhost:8080/api-json</code></pre><p><br>最後にコマンドを追加します。</p><pre><code>./package.json
"scripts": {
  "generate-example-client": "gulp generate-example-client"
},
....</code></pre><p><br></p><h3 id="h9d756a342d">openapi generator typescript-axios で出力</h3><p>先ほど追加したコマンドを実行します。</p><pre><code>yarn generate-example-client</code></pre><p><br>以下が出力されれば完了です。</p><pre><code>################################################################################
# Thanks for using OpenAPI Generator.&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; #
# Please consider donation to help us maintain this project 🙏&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;#
# https://opencollective.com/openapi_generator/donate&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; #
################################################################################
Finished 'generate-example-client' after 3.55 s</code></pre><p><br></p><h3 id="hd0b0994538">APIクライアント まとめるクラスを追加</h3><p>エンドポイント毎に設定を渡す必要があるので、集約するクラスを定義しておきます。basePathにはバックエンド側のURLを指定します。</p><pre><code>./clients/ExampleClient.ts

import { Configuration, ExampleApi } from "../openapi-generator/example-api";

export class ExampleClient {
  private config = new Configuration({
    basePath: process.env.NEXT_PUBLIC_API_BASE_URL || "/api",
  });

  public exampleApi = new ExampleApi(this.config);
}</code></pre><p><br></p><h3 id="h39017e0df9">インスタンスをどこでも扱えるようにする</h3><p>最後に <code>ExampleClient</code> をどこでも扱えるようにします。今回は <code>context</code> を利用します。ここでは細かい説明は行いません。<br></p><pre><code>./contexts/ExampleClientContext.ts

import React from "react";

import type { ExampleClient } from "../clients/ExampleClient";

export const ExampleClientContext = React.createContext&lt;
  ExampleClient | undefined
&gt;(undefined);</code></pre><p><br></p><pre><code>./pages/_app.tsx

const exampleClient = new ExampleClient();

function MyApp({ Component, pageProps }: AppProps) {
  return (
    &lt;ExampleClientContext.Provider value={exampleClient}&gt;
      &lt;Component {...pageProps} /&gt;
    &lt;/ExampleClientContext.Provider&gt;
  );
}</code></pre><p><br></p><pre><code>./hooks/useExampleClient.ts

import { useContext } from "react";

import type { ExampleClient } from "../clients/ExampleClient";
import { ExampleClientContext } from "../contexts";

export const useExampleClient = (): ExampleClient =&gt; {
  const exampleClient = useContext(ExampleClientContext);
  if (!exampleClient)
    throw new Error("useExampleClient must be inside a Provider with a value");

  return exampleClient;
};</code></pre><p><br>以下のようAPIをアクセスできるようになれば完了です。</p><pre><code>  useEffect(() =&gt; {
    void (async () =&gt; {
      console.log(await exampleClient.exampleApi.findAll());
    })();
  });</code></pre><p><br>これで終わりです。お疲れ様でした。<br></p><h2 id="h3bcda3e6b0">最後に</h2><p>OpenAPI Generator typescript-axios を使ってNext.js と NestJSを連携する方法をご紹介しました。TypeScript の型や API クライアントを自動生成されるので便利ですね。ただ、ドキュメントなどはあまり揃ってないので、利用するにはある程度の覚悟が必要かなっと思います。</p>

OpenAPI Generator を使ってNext.js と NestJSを連携する方法

NestJSにMikroORMの導入手順。CRUDのAPIを実装するまで。

<p>最近、自分のコードレビューがイケてないなーっと思うことがあったので、今後気をつけることをメモがてらにまとめようと思います。<br></p><h2 id="h411400a885">コードレビューを依頼するときに気をつけること</h2><p>単純にレビューを依頼しただけではスムーズに終わらないケースもあるので、以下のポイントを気をつけていきます。<br></p><h3 id="h0f0da1c3d8">最終的なコードと動作のチェックを2度する</h3><p>ケアレスミスや動作確認をしていれば気づける不具合の指摘は、レビュワーの負荷にもなるので、減らせるように気をつけていたいと思います。<br>特に私は1度ミスするタイプの生き物なので、時間を置いて2度確認することで見落としを減らしていきたいです。<br></p><h3 id="hfda16f269d">相手の立場に立ったPRの説明をする</h3><p>最近、「〇〇だから△△した理解で合っているよね？」っと聞かれるケースが何度かあったのですが、これは「どのように解決したのか」という観点の説明が浅いせいだなっと最近思うこの頃です。<br>相手の立場に立って、疑問を持たれない説明になっているか考えながら説明を書くように気をつけたいと思います。<br></p><h3 id="h25f6a3cea7">より見てほしいところはコメントをする</h3><p>コード量が多かったりするとレビュワーも見切れないケースがあるので、</p><ol><li>動作に不安がある箇所</li><li>もうちょっと上手く書けないか相談したい箇所</li></ol><p>など、より見て欲しいところはコメントで主張していきたいと思います。<br></p><h2 id="h2b1f87d3db">コードレビューをするときに気をつけること</h2><p>自分が思っていることと相手の受け取り方が全然違ったりするので、以下のポイントを気をつけていきます。<br></p><h3 id="h4758d631db">自分の意見を伝えた上で質問する</h3><p>「これは必要ですか？」のように質問だけで終わらせるのはちょっと冷たい印象で捉えられるのと、議論が進みにくいコメントだなっと最近思うこの頃です。<br>「自分だったらこうするけど、これは必要ですかね？」のように自分の意見を伝えた上で質問した方が議論が進みやすそうなので、気をつけていきます。<br></p><h3 id="hc57e36d66d">優先順位を伝える</h3><p>コメントの数が多いと、どのコメントから対応したらいいか困るケースが自身でありました。<br>なのでコメントは、修正が必須か推奨か、それともただ質問なのか明確に伝えることを気をつけていきます。<br></p><h3 id="h31d4b6e301">否定的な伝え方をしない</h3><p>「〇〇にしてください」のような伝え方は否定的に捉えられやすいです。「〇〇のようにすると良いかもですね」のように否定的な伝え方にならないように気をつけていきます。<br></p><h2 id="ha214098e44">まとめ</h2><p>レビューする側・される側に共通することは「相手の立場で考える」だと思います。この辺りを十二分に意識して、相手を敬いながら生きていきます！！！</p>

コードレビューで今後気をつけること

<p>おはこんばんは。最近、CodeceptJSでE2Eテストを書くことが増えたのですが、CodeceptJSでHandsontableの項目名セルをクリックするのに少し苦戦したので、対策についてご紹介しようと思います。<br></p><h2 id="hc69c85bcf9">背景</h2><p>CodeceptJSでは、<code>I.click(locator)</code>でlocatorに指定されたリンクやボタンのクリックを実行します。ただ、Handsontableの項目名セルを指定するとうまくクリックが実行されませんでした。<br><br>Handsontableの項目名セルが検知しているイベントとCodeceptJSが<code>I.click(locator)</code>で発火しているイベントが違うみたいです...恐らく...<br></p><h2 id="hb109fbdd18">対策</h2><p>今回はCodeceptJSのI.click(locator)は利用せず、mouseEventでmousedownを発火して対応するようにしました。<br><br>以下のように該当のセルにmousedownを発火するメソッドを定義します。</p><pre><code>e2e/configs/components/Handsontable.ts  

export = {
  /**
   * I.clickではHandsontableの項目セルがクリックされないので独自で定義している
   * @param row 該当セルの行
   * @param line 該当セルの列
   */
  clickCell: async function (row: number, line: number): Promise&lt;void&gt; {
    await I.executeScript(
      (row, line) =&gt; {
        const trElement = document.querySelectorAll(".ht_master table tr");
        if (trElement?.length &lt; row) return;
        const tdElement = trElement[row-1].childNodes;
        if (tdElement?.length &lt; line) return;
  		
        const mousedownEvent = new MouseEvent("mousedown", {
          bubbles: true,
          cancelable: true,
        });
        tdElement[line-1].dispatchEvent(mousedownEvent);
      },
      row,
      line
    );
  },
}</code></pre><p><br>そしてCodeceptJSで上記を呼び出せるように設定ファイルへ追記してあげます。</p><pre><code>codecept.conf.js

include: {
  Handsontable: "./e2e/configs/components/Handsontable.ts",		
}</code></pre><p><br></p><pre><code>steps.d.ts

type Handsontable = typeof import("./e2e/configs/components/Handsontable");
				
declare namespace CodeceptJS {		
  interface SupportObject {
    Handsontable: Handsontable;	
  }
}</code></pre><p><br>これでCodeceptJSで利用できるようになったので、以下のように呼び出してあげればOKです。お疲れ様でした。</p><pre><code>Scenario(
  "test",
  async ({ Handsontable }) =&gt; {
    await Handsontable.clickCell(1, 1);
  }
);</code></pre><p><br></p><h2 id="h1afe451c43">さいごに</h2><p>CodeceptJSでHandsontableのセルをクリックする方法をご紹介しました。CodeceptJSとHandsontableは闇があったりするので、ちょっと苦戦しますね。<br><span style="color:#24292e">今回の記事が誰かの参考になれば幸いです。</span></p>

CodeceptJSでHandsontableのセルをクリックする方法

<p>おはこんばんは。最近、Next.js（React）で<span style="color:#24292e">アイコンの</span>リサイズ<span style="color:#24292e">機能を実装してみたのですが、意外とまとまった記事が無かったので実装方法をご紹介しようと思います！</span><br><br><span style="color:#24292e">今回はこんな感じのを実装します。</span><a style="background-color:#ffffff" href="https://github.com/IshinoJun/next-icon-editor" target="_blank" rel="noopener noreferrer">サンプルはこちら。</a><br><br><img src="https://images.microcms-assets.io/assets/7758ea7c4c9e428cbf0a23d966011ccb/b8cddbc6a6ea40c2ad53a7905edd1408/5b1553b4096b9320849cd7c3f5b59568.gif" alt=""><br></p><h2 id="hfe5a8eaaf7"><span style="color:#24292e">実行環境</span></h2><ul><li>next 10.0.9</li><li>react 17.0.1</li><li>react-modal 3.12.1</li><li>react-avater 3.10.0</li><li>react-avater-editor 11.1.0</li><li>rc-slider 9.7.1</li><li>pica 6.1.1</li></ul><p><br></p><h2 id="h3397385dbf">機能説明</h2><p>今回の機能は主に以下となります。これを順に紹介していきます。<br></p><ol><li>アイコンの表示</li><li>画像のアップロード</li><li>アイコンのプレビュー表示</li><li>アイコンのサイズ・切り取り範囲の変更</li></ol><p><br></p><h2 id="h6ead2eb18d"><span style="color:#24292e">アイコンの表示</span></h2><p>まずは、最初の画面でアイコンを表示できるようにします。今回は<a href="https://github.com/sitebase/react-avatar" target="_blank" rel="noopener noreferrer"><code>react-avater</code></a>を利用します。画像が無い際のデフォルト表示や画像の円形表示をしてくれるお手軽ライブラリです。</p><pre><code>yarn add react-avatar</code></pre><p><br>次に表示用とプレビュー用のStateを定義します。このStateで画像を管理します。</p><pre><code>./page/index.tsx

const [icon, setIcon] = useState&lt;File | null&gt;(null);
const [previewIcon, setPreviewIcon] = useState&lt;File | null&gt;(null);</code></pre><p><br>そして以下みたいに利用すれば表示してくれます。ただ、まだ画像が無いので、デフォルト表示になるかと思います。</p><pre><code>./page/index.tsx

&lt;Avatar
　size='160'
　name="アイコン"
 round
 color="#ddd"
 alt="アイコン"
 src={icon ? URL.createObjectURL(icon) : ''}
/&gt;</code></pre><p><br></p><h2 id="h4ba79d7ad3">画像のアップロード</h2><p>では、早速画像のアップロードをできるようにします。今回はボタンを押されたら画像がアップロードされるようにします。<br><br>ページ上に表示されない input を以下のように定義し、ref を取得出来るようにします。</p><pre><code>./page/index.tsx

const iconInputRef = useRef&lt;HTMLInputElement | null&gt;(null);

&lt;input
  type="file"
  accept="image/*"
  style={{ display: 'none' }}
  ref={iconInputRef}
  onChange={handleChangePreviewIcon}
/&gt;</code></pre><p><br>先ほど、取得した inputのref がボタンのクリックイベントでクリックされるようにします。これで画像選択が可能になります。</p><pre><code>./page/index.tsx

const handleClickChangeIcon = useCallback(() =&gt; {
if (!iconInputRef || !iconInputRef.current) return;
iconInputRef.current.click();
}, []);

&lt;button
  type="button"
  onClick={handleClickChangeIcon}
&gt;</code></pre><p><br>最後にプレビューのStateを選択された画像を更新するようにします。<code>e.currentTarget.value = "''</code>をしているのは、同じ画像を連続で選択された際、イベントが実行されないので、valueをリセットして再実行可能とするためです。</p><pre><code>./page/index.tsx

const handleChangePreviewIcon = useCallback(
  (e: ChangeEvent&lt;HTMLInputElement&gt;) =&gt; {
    if (!e.target.files?.length) return;
    setPreviewIcon(e.target.files[0]);
    e.currentTarget.value = '';
  },
  [],
);</code></pre><p><br></p><h2 id="h0c81c97bfe">アイコンのプレビュー表示</h2><p>プレビューの表示では、<a href="https://github.com/reactjs/react-modal" target="_blank" rel="noopener noreferrer"><code>react-modal</code></a>を利用します。お手軽にモーダルが実装できるライブラリです。</p><pre><code>yarn add react-modal</code></pre><p><br><code>previewIcon</code>に値がセットされたらモーダルが開くようにしています。</p><pre><code>./components/IconEditor.tsx

&lt;Modal
  isOpen={!!previewIcon}
  onRequestClose={handleCloseIsOpen}
  ariaHideApp={false}
  overlayClassName={{
    base: styles.overlayBase,
    afterOpen: styles.overlayAfter,
    beforeClose: styles.overlayBefore,
  }}
  className={{
    base: styles.contentBase,
    afterOpen: styles.contentAfter,
    beforeClose: styles.contentBefore,
  }}
  closeTimeoutMS={500}
&gt;
  &lt;div className={styles.header}&gt;
  &lt;/div&gt;
&lt;/Modal&gt;</code></pre><p><br></p><h2 id="h6d0a8a7b52">アイコンのサイズ・切り取り範囲の変更</h2><p>画像のリサイズには<a href="https://github.com/mosch/react-avatar-editor" target="_blank" rel="noopener noreferrer"><code>react-avater-editor</code></a>と<a href="https://github.com/schrodinger/rc-slider" target="_blank" rel="noopener noreferrer"><code>rc-slider</code></a>を利用します。<br></p><pre><code>yarn add react-avater-editor rc-slider</code></pre><p><br><code>AvatarEditor</code>ではrefを渡すことでリサイズした画像データを取得出来ます。scaleで画像の拡大が可能です。その調整は<code>rc-slider</code>を用いて行います。</p><pre><code>./components/IconEditor.tsx

  const editorRef = useRef&lt;AvatarEditor | null&gt;(null);
 const [scale, setScale] = useState(1);

&lt;AvatarEditor
  ref={editorRef}
  image={previewIcon ? URL.createObjectURL(previewIcon) : ''}
  width={ICON_WIDTH}
  height={ICON_HEIGHT}
  borderRadius={100}
  color={[0, 0, 0, 0.6]}
  scale={scale}
  rotate={0}
/&gt;

&lt;Slider
  onChange={handleChangeScale}
  min={1}
  max={1.5}
  step={0.01}
  value={scale}
/&gt;</code></pre><p><br>ただ、<code>AvatarEditor</code>のwidthとheightがコンポーネントのサイズになるのですが、これが実際にリサイズされる画像の大きさになります。これを必ずしもそうしたくないケースがありますよね。そういった場合は、<a href="https://github.com/nodeca/pica" target="_blank" rel="noopener noreferrer"><code>pica</code></a>を利用します。</p><pre><code>yarn add pica</code></pre><p><br></p><pre><code>  const handleClickFileSave = useCallback(async () =&gt; {
    if (!editorRef.current) return;

    const img = editorRef.current.getImage();
    const canvas = editorRef.current.getImageScaledToCanvas();
    canvas.width = ICON_WIDTH;
    canvas.height = ICON_HEIGHT;
    const picaCanvas = await pica().resize(img, canvas, { alpha: true });

    picaCanvas.toBlob((blob) =&gt; {
      const nextFile = new File([blob], previewIcon.name, {
        type: previewIcon.type,
        lastModified: Date.now(),
      });
      onChangeIcon(nextFile);
      handleCloseIsOpen();
    });

  }, [previewIcon, onChangeIcon]);</code></pre><p><br>これで期待する画像にリサイズが出来ます。お疲れ様でした。<br></p><h2 id="h1afe451c43">さいごに</h2><p>今回は、Next.jsでアイコンのリサイズ機能を実装する方法をご紹介しました！Reactは色々とライブラリがあって便利ですね。今回の記事が誰かの参考になれば幸いです。</p>

Next.js（React）でアイコンのリサイズ機能をサクッと実装する方法

<p>おはこんばんは。最近、<span style="color:#24292e">&nbsp;Next.js × microCMS&nbsp;で自作したこのサイトにブログの</span>検索機能を実装してみました。<br><br>ブログでは、サイト内検索のフォームをよく見かけますよね。ただ、全文検索の機能等を実装する必要があり、意外と面倒だったりします。<br><br>そんな面倒なことも、<span style="color:#24292e">microCMS&nbsp;の</span>APIは全文検索機能を備えているので、簡単に実装出来てしまいます。今回はその全文検索機能を用いた<span style="color:#24292e">ブログの</span>検索機能の実装方法をご紹介します。<br></p><h2 id="hfe5a8eaaf7"><span style="color:#24292e">実行環境</span></h2><ul><li>Next.js 10.0.4</li><li>React 17.0.1</li></ul><p><br></p><h2 id="h786b965285">グローバルなStateの管理</h2><p>まずは、複数のドメインでキーワードを扱うことを想定し、グローバルなStateで管理するようにします。今回は、React Context を用いた方法でご紹介します。<br><br>createContext で以下のように Context を定義します。</p><pre><code>// context/searchContext.ts

import { createContext } from 'react';

interface SearchContextValue {
  search: string;
  setSearch: React.Dispatch&lt;React.SetStateAction&lt;string&gt;&gt;;
}

export const SearchContext = createContext&lt;SearchContextValue&gt;({
  search: '',
  setSearch: () =&gt; undefined,
});</code></pre><p><br>次に <code>_app.tsx</code> で Context を呼び出して、グローバルで管理するStateをセットします。</p><pre><code>// pages/_app.tsx

import React, { useState } from 'react';
import { AppProps } from 'next/app';

const MyApp = (props: AppProps): JSX.Element =&gt; {
  const { Component, pageProps } = props;
  const [search, setSearch] = useState&lt;string&gt;('');

  return (
    &lt;SearchContext.Provider value={{ search, setSearch }}&gt;
        &lt;Component {...pageProps} /&gt;
    &lt;/SearchContext.Provider&gt;
  );
};

export default MyApp;</code></pre><p><br>これでグローバルでStateを扱えるようになりました。<br></p><h2 id="h6cb2b333f2">検索用のコンポーネントを用意</h2><p>以下のように検索用のコンポーネントを用意します。今回は Material-UI を用いています。<br></p><pre><code>// components/SearchInput

import React, { useCallback, useContext } from 'react';
import { IconButton, InputBase } from '@material-ui/core';
import SearchIcon from '@material-ui/icons/Search';
import { useRouter } from 'next/router';
import style from './SearchInput.module.scss';
import SearchContext from '../../context/searchContext';

const SearchInput: React.FC = () =&gt; {
  const { search, setSearch } = useContext(SearchContext);
  const router = useRouter();

  const handleChangeKeyword = useCallback(
    (e: React.ChangeEvent&lt;HTMLInputElement | HTMLTextAreaElement&gt;) =&gt; {
      const { value } = e.currentTarget;
      setSearch(value);
    },
    [setSearch],
  );

  const handleClickSearchButton = useCallback(() =&gt; {
    void router.push(`/blogs/search/?keyword=${search}`);
  }, [search, router]);

  const handleKeyDownSearch = useCallback(
    (e: React.KeyboardEvent&lt;HTMLInputElement | HTMLTextAreaElement&gt;) =&gt; {
      if (e.key === 'Enter') {
        void router.push(`/blogs/search/?keyword=${search}`);
      }
    },
    [search, router],
  );

  return (
    &lt;div className={style.search}&gt;
      &lt;InputBase
        placeholder="Search…"
        inputProps={{ 'aria-label': 'search' }}
        className={style.searchInput}
        value={search}
        onChange={handleChangeKeyword}
        onKeyDown={handleKeyDownSearch}
      /&gt;
      &lt;IconButton
        className={style.searchIcon}
        onClick={handleClickSearchButton}
        aria-label="Search"
      &gt;
        &lt;SearchIcon /&gt;
      &lt;/IconButton&gt;
    &lt;/div&gt;
  );
};

export default SearchInput;</code></pre><p><br>先ほど、定義した Context で定義したグローバルなStateは以下のように <code>useContext</code> で呼び出しています。</p><pre><code>const { search, setSearch } = useContext(SearchContext);</code></pre><p><br><code>handleClickSearchButton</code>と<code>handleKeyDownSearch</code> で検索結果のページへ遷移するようにしています。<br><br>ポイントは、検索キーワードをURLクエリに入れていることです。Context で入れているから不要では？と思いますよね。<br><br>ただ、ブラウザをリロードすると Context のは値が消えてしまいます。なので、リロードされても検索結果が残るようにURLクエリにキーワードを入れています。<br></p><pre><code>void router.push(`/blogs/search/?keyword=${search}`);</code></pre><p><br></p><h2 id="hd9cc592a7d">ページ側の処理</h2><p>ページ側は先ほどセットしたURLクエリを元にブログの一覧を取得します。フロントから直接 <span style="color:#24292e">microCMS のAPIを叩いてしまうと、API keyが漏洩してしまうので、API Routerを叩くようにしています。</span><br></p><pre><code>const [blogsQuery, setBlogsQuery] = useState&lt;{ keyword:string } | null&gt;(null);

useEffect(() =&gt; {
  const urlQuery = router.query { keyword:string };

  if (!isEmpty(urlQuery)) setBlogsQuery(urlQuery);
}, [router.query]);

useEffect(() =&gt; {
  if (blogsQuery) {
    void (async (): Promise&lt;void&gt; =&gt; {
      try {
          const res = await fetch(`/api/blogs`, {
            body: JSON.stringify(blogsQuery),
          });
      } catch {
        return;
      }
    })();
  }
}, [blogsQuery]);</code></pre><p><br>一応、URLクエリがないページに遷移した際に検索キーワードが消えるように <code>_app.tsx</code> に以下の処理も入れておくと良いでしょう。<br></p><pre><code>// pages/_app.tsx

  useEffect(() =&gt; {
    const urlQuery = router.query { keyword:string };
    if (urlQuery &amp;&amp; urlQuery.keyword) {
      setSearch(urlQuery.keyword);
    } else {
      setSearch('');
    }
  }, [router]);</code></pre><p><br></p><h2 id="h9cb4759477">API Routerでブログ一覧を取得する</h2><p><span style="color:#24292e">以下のようにAPI Router を用いてサーバーサイド側から</span> <span style="color:#24292e">microCMS のAPIを叩くようにします。</span><br></p><pre><code>// pages/api/blogs/index.ts

import { NextApiResponse, NextApiRequest } from 'next';

const isBlogsQuery = (item: unknown): item is { keyword: string } =&gt; {
  const target = item as { keyword: string };
  return 'keyword' in target &amp;&amp; typeof target.keyword === 'string';
};

const getSearchBlogs = async (
  req: NextApiRequest,
  res: NextApiResponse,
): Promise&lt;void&gt; =&gt; {
  // クエリのチェック
  if (!isBlogsQuery(req.body)) {
    return res.status(404).end();
  }

  const key = {
    headers: { 'X-API-KEY': process.env.API_KEY ?? '' },
  };
  const blogs = await fetch(
    `https://your-service.microcms.io/api/v1/blogs?q=${encodeURI(
      req.body.keyword,
    )}`,
    key,
  )
    .then((res) =&gt; res.json())
    .catch(() =&gt; null);

  return  res.status(200).json(blogs);
};

export default getSearchBlogs;</code></pre><p><br><span style="color:#24292e">microCMS では</span><code>q</code>で全文検索が行えます。検索対象は「テキストフィールド」「テキストエリア」「リッチエディタ」となるので、必要なフィールドに対して検索してくれます。便利ですね。<br><br>日本語などのキーワードは<code>encodeURI</code>をしないといけなので、ご注意ください。<br></p><pre><code>`https://your-service.microcms.io/api/v1/blogs?q=${encodeURI(
      req.body.keyword,
    )}`</code></pre><p><br>これで検索されたキーワードに関連するブログが取得出来るようになったはずです。お疲れ様でした。<br></p><h2 id="h1afe451c43">さいごに</h2><p>今回は <span style="color:#24292e">microCMS&nbsp;の</span>APIは全文検索機能を用いて、<span style="color:#24292e">ブログの</span>サイト内検索を実装する方法をご紹介しました！誰かの参考になれば幸いです。</p>

Next.js × microCMSでブログの検索を実装してみた

<p><span style="color:#24292e">おはこんにちばんは。最近は </span>Node.js / TypeScript で使用出来る ORM のPrismaを触っています。<br>そこでハマった、<span style="color:#454545">一対多</span> や 多対多 のようなリレーションをしているテーブルのレコードの削除について、どのような対応したのかを紹介しようと思います。<br></p><h2 id="hfe5a8eaaf7">実行環境</h2><ul><li>Prisma 2.14.0</li></ul><p><br></p><h2 id="h68b09e605a">事象内容</h2><p>リレーションしているテーブルのレコードに対して、<a href="https://www.prisma.io/" target="_blank" rel="noopener noreferrer">Prisma</a> のDeleteを使うと以下のエラーが発生しました。</p><pre><code>The change you are trying to make would violate the required relation 'XXXX' between the 'XXXX' and 'XXXX' models.</code></pre><p><br>あれ？何か設定漏れてたかなっと思い色々調べた結果、カスケードの削除（<span style="color:#333333">参照先が無くなると同時に削除される</span>）が<a href="https://github.com/prisma/prisma/issues/2810" target="_blank" rel="noopener noreferrer">非対応</a>のようでした...<br>一応、ロードマップ上では対応するよう進んでいるようです。優先度高くないっぽいけど。<br>更に調べてみると、<a href="https://paljs.com/plugins/delete/" target="_blank" rel="noopener noreferrer">Pal.js</a> を使うと対応できるよっという<a href="https://github.com/prisma/prisma/issues/2057#issuecomment-718060880" target="_blank" rel="noopener noreferrer">コメント</a>があったので実際に試してみました。<br></p><h2 id="hc2e1b5db24">packageを追加</h2><p><a style="background-color:#ffffff" href="https://paljs.com/plugins/delete/" target="_blank" rel="noopener noreferrer">Pal.js</a> を追加していきます。（何故かgraphql入れないと動かんかった。闇）</p><pre><code>yarn add paljs/plugins graphql</code></pre><p><br></p><h2 id="ha7f8f59999">事前設定</h2><p>参照先のレコードをどう扱うか設定していきます。以下の二つが設定可能です。</p><ul><li><code>SET_NULL</code>：関連するレコードをに<code>null</code>に設定します。</li><li><code>CASCADE</code>：関連するレコードを削除します。</li></ul><p><br><code>/// @onDelete(CASCADE)</code>のように設定します。以下は適当な例です。</p><pre><code>schema.prisma

model User {
  id　Int　@id @default(autoincrement())
  /// @onDelete(CASCADE)
  userDetail UserDetail?
}

model UserDetail {
  id　Int　@id @default(autoincrement())
  user  User @relation(fields: [userId], references: [id])
  userId  Int 
  displayName String
}</code></pre><p><br></p><h2 id="h597fa8c079">削除処理</h2><p>以下のように<a style="background-color:#ffffff" href="https://paljs.com/plugins/delete/" target="_blank" rel="noopener noreferrer">Pal.js</a> のDelete処理を行えば、リレーションをしているテーブルのレコードも含めて削除できます。</p><pre><code>export const deleteUser = async (id: User['id']) =&gt; {
  const prismaDelete = new PrismaDelete(prisma)
  return await prismaDelete.onDelete({
    model: 'User',
    where: { id },
    deleteParent: true
  })
}</code></pre><p><br></p><h2 id="h3bcda3e6b0">最後に</h2><p>暫定対応をご紹介しましたが、<a href="https://www.prisma.io/" target="_blank" rel="noopener noreferrer">Prisma</a> が対応してくれると良いですね。同じようにハマった人の参考になれば幸いです。</p>

Prismaで参照先のレコード削除にハマった話

<p><span style="color:#24292e">おはこんにちばんは。今回は&nbsp;Next.js × microCMS&nbsp;で ページングを実装してみました。その手順を紹介しようと思います！</span><br></p><h2 id="hfe5a8eaaf7">実行環境</h2><ul><li>Next.js 10.0.4</li><li>React 17.0.0</li><li>Material-UI 4.11.2</li></ul><p><br></p><h2 id="h559ffd8095">一覧画面の実装</h2><p>まずは雑に一覧画面を実装します。今回はUIライブラリにMaterial-UIを利用しています。構成しては以下になります。<br><br>=============<br>pages/<br>　page/<br>　　[offset].tsx<br>=============<br></p><pre><code>src/pages/page/[offset].tsx

import { GetStaticPaths, GetStaticProps, NextPage } from 'next'
import React, { useCallback } from 'react'
import { useRouter } from 'next/router';
import { Pagination } from '@material-ui/lab';

const PAGE = 10 as const;

const DynamicPage: NextPage = () =&gt; {
  const router = useRouter();
  const offset = router.query.offset
    ? Number.parseInt(String(router.query.offset), 10)
    : 1;

  const handleChangePage = useCallback(
    (_: React.ChangeEvent&lt;unknown&gt;, page: number) =&gt; {
      void router.push(`/page/${page}`);  
    },
    [router],
  );
  
  return (
    &lt;div&gt;
      &lt;h1&gt;{router.query.offset}&lt;/h1&gt;
      &lt;Pagination
        count={PAGE}
        variant="outlined"
        shape="rounded"
        color="secondary"
        page={offset}
        onChange={handleChangePage}
      /&gt;
    &lt;/div&gt;
  )
}

export const getStaticPaths: GetStaticPaths = async () =&gt; {
  const paths = [...Array(PAGE)].map((_, index) =&gt; ({
    params: {
      offset: `${index + 1}`,
    },
  }))

  return { paths, fallback: false };
}

export const getStaticProps: GetStaticProps = async (context) =&gt; {
  return {
    props: {},
  }
}

export default DynamicPage;</code></pre><p><br>Material-UI の <a href="https://material-ui.com/api/pagination/" target="_blank" rel="noopener noreferrer">Pagination</a> を使っています。ハンドラーの第二引数に次の page が取れるのでそれを元に次のページに遷移させています。こんな感じになるはずです。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/3011efc1f05f61b9fafe77ea24f8726b.gif" alt=""><br></p><h2 id="h2ec9ff6b44"><span style="color:#24292e">microCMS&nbsp;で取得したコンテンツを利用</span></h2><p><br>microCMS で取得したコンテンツを元にページングしていきます。今回は1ページ 3つまでコンテンツを取得するようにしています。<br></p><pre><code>import { GetStaticPaths, GetStaticProps, NextPage } from 'next'
import React, { useCallback } from 'react'
import { useRouter } from 'next/router';
import { Pagination } from '@material-ui/lab';

const DynamicPage: NextPage = ({ contents }) =&gt; {
  const router = useRouter();
  const offset = router.query.offset
    ? Number.parseInt(String(router.query.offset), 10)
    : 1;

  const handleChangePage = useCallback(
    (_: React.ChangeEvent&lt;unknown&gt;, page: number) =&gt; {
      void router.push(`/page/${page}`);  
    },
    [router],
  );
  
  return (
    &lt;div&gt;
      &lt;h1&gt;{router.query.offset}&lt;/h1&gt;
      &lt;Pagination
        count={Math.ceil(contents.totalCount / contents.limit)}
        variant="outlined"
        shape="rounded"
        color="secondary"
        page={offset}
        onChange={handleChangePage}
      /&gt;
    &lt;/div&gt;
  )
}

export const getStaticPaths: GetStaticPaths = async () =&gt; {

  const key = {
    headers: { 'X-API-KEY': process.env.API_KEY ?? '' },
  };
  const contents = await fetch(
    `https://jun-dev.microcms.io/api/v1/contents?offset=0&amp;limit=3`,
    key,
  )
    .then((res) =&gt; res.json())
    .catch(() =&gt; null);

  const paths = [...Array(Math.ceil(contents.totalCount / contents.limit))]
    .map((_, i) =&gt; i + 1)
    .map((offset) =&gt; `/page/${offset}`);

  return { paths, fallback: false };
}

export const getStaticProps: GetStaticProps = async ({ params }) =&gt; {
  const offset = params?.offset ? String(params?.offset) : '0';

  const query = {
    offset: String(Math.ceil(Number.parseInt(offset, 10) - 1) * 3),
    limit: '3',
  };

  const key = {
    headers: { 'X-API-KEY': process.env.API_KEY ?? '' },
  };
  const contents = await fetch(
    `https://your-service.microcms.io/api/v1/contents?offset=${query.offset}&amp;limit=${query.limit}`,
    key,
  )
    .then((res) =&gt; res.json())
    .catch(() =&gt; null);

  return {
    props: {
      contents
    },
  }
}

export default DynamicPage</code></pre><p><br>getStaticPathsでは microCMS で <code>totalCount</code> と <code>limit</code> を返してくれるのでこれを元にpathsを生成しています。</p><pre><code>  const paths = [...Array(Math.ceil(contents.totalCount / contents.limit))]
    .map((_, i) =&gt; i + 1)
    .map((offset) =&gt; `/page/${offset}`);</code></pre><p><br>getStaticPropsではgetStaticPathsで生成したoffsetを元にqueryを生成し、ページ単位でコンテンツを何件目から取得するかを指定しています。</p><pre><code>  const offset = params?.offset ? String(params?.offset) : '0';

  const query = {
    offset: String(Math.ceil(Number.parseInt(offset, 10) - 1) * 3),
    limit: '3',
  };</code></pre><p><br>Pagination コンポーネントも <code>totalCount</code> と <code>limit</code> を元にcount（何ページ目か） を指定してあげています。</p><pre><code>&lt;Pagination
   count={Math.ceil(contents.totalCount / contents.limit)}
   variant="outlined"
   shape="rounded"
   color="secondary"
   page={offset}
   onChange={handleChangePage}
/&gt;</code></pre><p><br>これで以上です。お疲れ様でした。<br><br></p><h2 id="h1afe451c43">さいごに</h2><p><span style="color:#24292e">Next.js × microCMS&nbsp;で ページングを実装してみました。一覧ページを実装したけど、ページングがよくわからんって方に参考となれば幸いです。</span></p>

Next.js × microCMS におけるページングの実装方法

<p><span style="color:#24292e">おはこんにちばんは。今回は </span>Next.js × microCMS&nbsp;で 人気記事一覧を Google Analytics Reporting API v4 を利用し表示してみました！<br><br>よくブログとかで人気記事一覧とか目にしますよね。<span style="color:#383838">WordPress の場合はプラグインを利用すれば比較的簡単に出来そうですが、自作ブログだとどうすべきか悩みました。</span><br><br>そこで今回は、Google Analytics Reporting API v4  を利用して人気記事一覧を表示する方法を紹介していきます。<br></p><h2 id="hfe5a8eaaf7"><span style="color:#24292e">実行環境</span></h2><ul><li>Next.js 10.0.4</li><li>React 17.0.0</li></ul><p><br></p><h2 id="h30a538611a">Google APIs を有効にする</h2><h3 id="h702d09d558">プロジェクトを作成</h3><p><a href="https://console.developers.google.com/" target="_blank" rel="noopener noreferrer">Google APIs</a> にアクセスし、プロジェクトの選択 をクリックし、新しいプロジェクト をクリックします。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/new-project.png" alt=""><br><br>プロジェクト名に任意の名前をつけてプロジェクトを作成します。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/new-project-2.png" alt=""><br></p><h3 id="hc2f5e80d22">Google Analytics API の有効化</h3><p>APIとサービスの有効化 をクリックして Google Analytics API を有効化します。<br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/new-project3.png" alt=""><br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/new-project4.png" alt=""><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/new-project5.png" alt=""><br><br>これで有効化されました。続いて認証情報を作成します。<br></p><h3 id="hf09298624a">認証情報の作成</h3><p>認証情報を作成 をクリックします。<br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/new-project6.png" alt=""><br><br>下記の情報を選択します。必要な認証情報 をクリックします。</p><ul><li>使用するAPI：Analytics Reporting API</li><li>APIを呼び出す場所：ウェブサーバー（node.js, Tomcat など）</li><li>アクセスするデータの種類：アプリケーションデータ</li></ul><p><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/new-project7.png" alt=""><br><br>下記の情報を選択します。次へ をクリックします。</p><ul><li>サービスアカウント名：任意</li><li>ロール：閲覧者</li><li>キータイプ：JSON</li></ul><p><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/new-project8.png" alt=""><br><br>自動的にjsonがダウンロードされます。このjsonは後ほど利用するので、適切に保管しておきます。<br></p><h3 id="h0a84e474da">Google Analytics の閲覧権限を付与</h3><p>Google Analyticsの設定を行っていきます。<br><a href="https://analytics.google.com/analytics/web/" target="_blank" rel="noopener noreferrer">Google Analytics</a> を開き、左下の歯車マーク から ビューの設定 をクリックします。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/new-project9.png" alt=""><br><br>ビューIDを後ほど利用するのでメモっておいてください。<br><br>次にユーザ管理をクリックし、+ ボタンを押してユーザを追加します。<br>ユーザのメールアドレスには、先程ダウンロードしたjsonファイルに記載されている <code>client_email</code> の値を入れて、ユーザを追加します。<br><br><img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/new-project10.png" alt=""><br><br>これでgoogle APIs周りの設定は完了です。<br></p><h2 id="hc6c80635a9">パッケージの追加</h2><p>それでは実装を進めていきます。今回は、Node.js用のライブラリである&nbsp;<code>google-api-nodejs-client</code>&nbsp;を利用します。</p><pre><code>$ yarn add googleapis</code></pre><p><br></p><h2 id="h936a1bbd78">ページビュー上位を取得する処理</h2><p>人気記事一覧を表示したいので、ページビューが上位の3位のパスを取得するコートを書いていきます。</p><pre><code>import { analyticsreporting_v4, google } from 'googleapis';
import { isEmpty } from 'lodash';

const getTopArticle = async (): Promise&lt;analyticsreporting_v4.Schema$GetReportsResponse&gt; =&gt; {
  const client = await google.auth.getClient({
    scopes: 'https://www.googleapis.com/auth/analytics.readonly',
    credentials: {
      client_email: process.env.GOOGLE_APPLICATION_CLIENT_EMAIL,
      private_key: (process.env.GOOGLE_APPLICATION_PRIVATE_KEY ?? '').replace(
        /\\n/gm,
        '\n',
      ),
    },
  });

  const analyticsreporting = google.analyticsreporting({
    version: 'v4',
    auth: client,
  });

  const res = await analyticsreporting.reports.batchGet({
    requestBody: {
      reportRequests: [
        {
          viewId:  process.env.GOOGLE_ANALYTICS_VIEW_ID,
          dateRanges: [
            {
              startDate: '30daysAgo',
              endDate: '1daysAgo',
            },
          ],
          dimensions: [
            {
              name: 'ga:pagePath',
            },
          ],
          metrics: [
            {
              expression: 'ga:pageviews',
            },
          ],
          orderBys: [
            {
              fieldName: 'ga:pageviews',
              sortOrder: 'DESCENDING',
            },
          ],
          pageSize: 3,
          dimensionFilterClauses: [
            {
              filters: [
                {
                  dimensionName: 'ga:pagePath',
                  operator: 'REGEXP',
                  expressions: ['^/blogs/[0-9a-zA-Z\\-]+$'],
                },
              ],
            },
          ],
        },
      ],
    },
  });

  return res.data;
};

const getTopArticlePaths = async (): Promise&lt;string[]&gt; =&gt; {
  const topArticle = await getTopArticle();

  const ids: string[] = [];
  const rows = topArticle.reports
    ? topArticle.reports[0]?.data?.rows ?? []
    : [];

  rows.forEach((row) =&gt; {
    if (row.dimensions &amp;&amp; !isEmpty(row.dimensions)) {
      ids.push(row.dimensions[0].replace('/blogs/', ''));
    }
  });

  return ids;
};

export { getTopArticle, getTopArticlePaths };</code></pre><p><br>以下の環境変数は先ほどダウンロードしたjsonの <code>clientemail</code> と<code> privatekey</code> を利用します。<code>view_id</code> は先ほどメモしたやつです。</p><pre><code>process.env.GOOGLE_APPLICATION_CLIENT_EMAIL
process.env.GOOGLE_APPLICATION_PRIVATE_KEY
process.env.GOOGLE_ANALYTICS_VIEW_ID</code></pre><p><br>ブログのページビューのみを取得したいので、正規表現で <code>/blogs/英数字ハイフン</code> が含むのみを取得するようにしています。</p><pre><code>dimensionFilterClauses: [
{
  filters: [
    {
      dimensionName: 'ga:pagePath',
      operator: 'REGEXP',
      expressions: ['^/blogs/[0-9a-zA-Z\\-]+$'],
    },
  ],
}]</code></pre><p><br>次に以下のようにページビュー上位3位までの記事を取得します。</p><pre><code>export const getStaticProps: GetStaticProps = async (): Promise&lt;{
  props: Props;
}&gt; =&gt; {
  const ids = await getTopArticlePaths();
  const str = ids.join(',');

  const key = {
    headers: { 'X-API-KEY': process.env.API_KEY ?? '' },
  };
  const topBlogs = await fetch(
    `https://your-service.microcms.io/api/v1/blogs?ids=${str}`,
    key,
  )
    .then((res) =&gt; res.json())
    .catch(() =&gt; null);

  const topArticleBlogs = compact(
    ids.map((id) =&gt; topBlogs?.contents.find((b) =&gt; b.id === id)),
  );

  return {
    props: {
      topArticleBlogs,
    },
  };
};</code></pre><p><br>以下は&nbsp;microCMS が順番を作成順に変えてしまうので、Articleのid順に並び替えています。</p><pre><code>const topArticleBlogs = compact(
    ids.map((id) =&gt; topBlogs?.contents.find((b) =&gt; b.id === id)),
);</code></pre><p><br>これで人気記事を取得出来たはずなので、あとは良しなに表記するだけです。お疲れ様でした。<br></p><h2 id="h1afe451c43">さいごに</h2><p>今回は人気記事一覧を表示する方法についてご紹介しました！意外と調べても参考になる実装方法がなかったので誰かの参考になれば幸いです。<br>（microCMSのidsはidの順番に返して欲しいと思うこの頃。方法あるのかな？）</p>

【Next.js × microCMS】人気記事一覧を表示してみた

<p><span style="color:#24292e">おはこんにちばんは。</span><span style="color:#222222">もうすぐ2020年が終わりますねー！</span><br><span style="color:#222222">今回は今年の振り返りと来年に向けた話を書きます。</span><br></p><h2 id="hb34093dbec">2020年の振り返り</h2><p><br>良かったこと・悪かったこと<br></p><h3 id="hb52e6bbc10">仕事</h3><p>2020年も株式会社ケップルの開発部に所属し、FUNDBOARD というWEBサービスの新規機能の開発及び既存機能のエンハンスをフロントエンドとバックエンド問わず行っていました。<br><br>新規機能の開発に関しては、ライブラリ選定・設計・開発まで一通り行い、大きめの機能をリリース出来たのは良い経験でした。この辺りから設計の重要性を理解し、実装速度を落とさずにバグの頻度を減らせたことも良かったです。（「バグが減った」とCTOにドヤ顔で言ったその日にバグを仕込んだことはここだけの話）<br><br>2020年7月頃からは、本番環境の権限を持つこととなり障害対応や本番デプロイも行うようになりました。障害対応はフロントエンドとバックエンド（時々インフラ）の両面で知識が求められるので、学びが多くこちらも良い経験だったと思います。（眠れぬ日々になった気がするけど）<br><br>ただ、後半は余裕が出てきたのか80%くらいのパワーで仕事をこなしていた気がしたので、それは良くなかったなーっと考えています。<br></p><h3 id="h24a4d124d1">プライベート</h3><p>業務で扱わないライブラリやフレームワークを実際に手元で色々動かしたりしてました。特に Next.js に関しては、このブログ兼ポートフォリオを作るなどして多くのことを学べたなと思っています。やはり <strong>手を動かすこと</strong> が知識の執着には重要だと、改めて認識しました。<br><br>ブログも頻度は多くはないですが、定期的に投稿が出来ているので良かったです。<br><br>あ、でも勉強会などあまり参加出来なかったのは良くなかった気がします。（コロナとかあったのもあるけど）<br><br>筋トレに関しては、全くダメでした。（唐突）<br>まず健康のためにやっているのに腰を故障するという本末転倒なことをしてしまいました。今後は低重量でどれだけ効かせられるかを意識して生きていこうと思います。</p><h2 id="h717b42fb41"><br>2021年に向けて</h2><p><br>目標など<br></p><h3 id="hb52e6bbc10">仕事</h3><p>初心に戻り、命を削りながら120%のパワーで120%以上の結果を出せるよう開発していたいです。セルフマネジメントは大事なのでこれに尽きるかなっと思います。方法はやるしか無い状況を作って自分を追い込むだけ。（精神論）<br><br>あと、0 ⇨ 1の開発が出来ればしたい。（願望）<br></p><h3 id="h24a4d124d1">プライベート</h3><p>引き続き、ライブラリやフレームワークを実際に手元で色々動かしたりして、そこで培った知見などをブログなどで外部に発信していきたいと思います。<br><br>勉強会などにも参加して、出来れば外部との繋がりも増やしていきたいです。<br><br>あと、副業してみたかったけどNGの決まりになってしまったので、個人開発で1つアプリをリリースできるよう頑張ろうかなーっと考えています。（多分）<br></p><h2 id="h1afe451c43">さいごに</h2><p><span style="color:#000000">定性的な内容になってしまいましたが、実際に書き出すことで今後意識すべきことが明確になったので良かったです。</span><br><br><span style="color:#000000">今年も楽しい一年でした！来年もたくさん楽しみながら結果出せるように頑張りますー！</span></p>