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

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

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

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

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

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

&lt;button
 type=&quot;button&quot;
 onClick={handleClickChangeIcon}
&gt;</code></pre> 最後にプレビューのStateを選択された画像を更新するようにします。<code>e.currentTarget.value = &quot;&#x27;&#x27;</code>をしているのは、同じ画像を連続で選択された際、イベントが実行されないので、valueをリセットして再実行可能とするためです。<pre><code>.&#x2F;page&#x2F;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 = &#x27;&#x27;;
 },
 [],
);</code></pre> <h2 id="h0c81c97bfe">アイコンのプレビュー表示</h2>プレビューの表示では、<a href="https://github.com/reactjs/react-modal" target="_blank" rel="noopener noreferrer"><code>react-modal</code></a>を利用します。お手軽にモーダルが実装できるライブラリです。<pre><code>yarn add react-modal</code></pre> <code>previewIcon</code>に値がセットされたらモーダルが開くようにしています。<pre><code>.&#x2F;components&#x2F;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;&#x2F;div&gt;
&lt;&#x2F;Modal&gt;</code></pre> <h2 id="h6d0a8a7b52">アイコンのサイズ・切り取り範囲の変更</h2>画像のリサイズには<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>を利用します。 <pre><code>yarn add react-avater-editor rc-slider</code></pre> <code>AvatarEditor</code>ではrefを渡すことでリサイズした画像データを取得出来ます。scaleで画像の拡大が可能です。その調整は<code>rc-slider</code>を用いて行います。<pre><code>.&#x2F;components&#x2F;IconEditor.tsx

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

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

&lt;Slider
 onChange={handleChangeScale}
 min={1}
 max={1.5}
 step={0.01}
 value={scale}
&#x2F;&gt;</code></pre> ただ、<code>AvatarEditor</code>のwidthとheightがコンポーネントのサイズになるのですが、これが実際にリサイズされる画像の大きさになります。これを必ずしもそうしたくないケースがありますよね。そういった場合は、<a href="https://github.com/nodeca/pica" target="_blank" rel="noopener noreferrer"><code>pica</code></a>を利用します。<pre><code>yarn add pica</code></pre> <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> これで期待する画像にリサイズが出来ます。お疲れ様でした。 <h2 id="h1afe451c43">さいごに</h2>今回は、Next.jsでアイコンのリサイズ機能を実装する方法をご紹介しました！Reactは色々とライブラリがあって便利ですね。今回の記事が誰かの参考になれば幸いです。

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

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

import { createContext } from &#x27;react&#x27;;

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

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

import React, { useState } from &#x27;react&#x27;;
import { AppProps } from &#x27;next&#x2F;app&#x27;;

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

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

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

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

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(`&#x2F;blogs&#x2F;search&#x2F;?keyword=${search}`);
 }, [search, router]);

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

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

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

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

import { NextApiResponse, NextApiRequest } from &#x27;next&#x27;;

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

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

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

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

おはこんにちばんは。今回は Next.js × microCMS で ページングを実装してみました。その手順を紹介しようと思います！ <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> <h2 id="h559ffd8095">一覧画面の実装</h2>まずは雑に一覧画面を実装します。今回はUIライブラリにMaterial-UIを利用しています。構成しては以下になります。 ============= pages&#x2F; 　page&#x2F; 　　[offset].tsx ============= <pre><code>src&#x2F;pages&#x2F;page&#x2F;[offset].tsx

import { GetStaticPaths, GetStaticProps, NextPage } from &#x27;next&#x27;
import React, { useCallback } from &#x27;react&#x27;
import { useRouter } from &#x27;next&#x2F;router&#x27;;
import { Pagination } from &#x27;@material-ui&#x2F;lab&#x27;;

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(`&#x2F;page&#x2F;${page}`); 
 },
 [router],
 );
 
 return (
 &lt;div&gt;
 &lt;h1&gt;{router.query.offset}&lt;&#x2F;h1&gt;
 &lt;Pagination
 count={PAGE}
 variant=&quot;outlined&quot;
 shape=&quot;rounded&quot;
 color=&quot;secondary&quot;
 page={offset}
 onChange={handleChangePage}
 &#x2F;&gt;
 &lt;&#x2F;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> Material-UI の <a href="https://material-ui.com/api/pagination/" target="_blank" rel="noopener noreferrer">Pagination</a> を使っています。ハンドラーの第二引数に次の page が取れるのでそれを元に次のページに遷移させています。こんな感じになるはずです。 <img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/3011efc1f05f61b9fafe77ea24f8726b.gif" alt> <h2 id="h2ec9ff6b44">microCMS で取得したコンテンツを利用</h2> microCMS で取得したコンテンツを元にページングしていきます。今回は1ページ 3つまでコンテンツを取得するようにしています。 <pre><code>import { GetStaticPaths, GetStaticProps, NextPage } from &#x27;next&#x27;
import React, { useCallback } from &#x27;react&#x27;
import { useRouter } from &#x27;next&#x2F;router&#x27;;
import { Pagination } from &#x27;@material-ui&#x2F;lab&#x27;;

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(`&#x2F;page&#x2F;${page}`); 
 },
 [router],
 );
 
 return (
 &lt;div&gt;
 &lt;h1&gt;{router.query.offset}&lt;&#x2F;h1&gt;
 &lt;Pagination
 count={Math.ceil(contents.totalCount &#x2F; contents.limit)}
 variant=&quot;outlined&quot;
 shape=&quot;rounded&quot;
 color=&quot;secondary&quot;
 page={offset}
 onChange={handleChangePage}
 &#x2F;&gt;
 &lt;&#x2F;div&gt;
 )
}

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

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

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

 return { paths, fallback: false };
}

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

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

 const key = {
 headers: { &#x27;X-API-KEY&#x27;: process.env.API_KEY ?? &#x27;&#x27; },
 };
 const contents = await fetch(
 `https:&#x2F;&#x2F;your-service.microcms.io&#x2F;api&#x2F;v1&#x2F;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> getStaticPathsでは microCMS で <code>totalCount</code> と <code>limit</code> を返してくれるのでこれを元にpathsを生成しています。<pre><code> const paths = [...Array(Math.ceil(contents.totalCount &#x2F; contents.limit))]
 .map((_, i) =&gt; i + 1)
 .map((offset) =&gt; `&#x2F;page&#x2F;${offset}`);</code></pre> getStaticPropsではgetStaticPathsで生成したoffsetを元にqueryを生成し、ページ単位でコンテンツを何件目から取得するかを指定しています。<pre><code> const offset = params?.offset ? String(params?.offset) : &#x27;0&#x27;;

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

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

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

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

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

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

 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(&#x27;&#x2F;blogs&#x2F;&#x27;, &#x27;&#x27;));
 }
 });

 return ids;
};

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

 const key = {
 headers: { &#x27;X-API-KEY&#x27;: process.env.API_KEY ?? &#x27;&#x27; },
 };
 const topBlogs = await fetch(
 `https:&#x2F;&#x2F;your-service.microcms.io&#x2F;api&#x2F;v1&#x2F;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> 以下は microCMS が順番を作成順に変えてしまうので、Articleのid順に並び替えています。<pre><code>const topArticleBlogs = compact(
 ids.map((id) =&gt; topBlogs?.contents.find((b) =&gt; b.id === id)),
);</code></pre> これで人気記事を取得出来たはずなので、あとは良しなに表記するだけです。お疲れ様でした。 <h2 id="h1afe451c43">さいごに</h2>今回は人気記事一覧を表示する方法についてご紹介しました！意外と調べても参考になる実装方法がなかったので誰かの参考になれば幸いです。 （microCMSのidsはidの順番に返して欲しいと思うこの頃。方法あるのかな？）

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

【Next.js × Vercel】OGP画像を動的生成してみた

おはこんにちばんは。Next.jsにAdobe Fontsに対応してみました。 Adobe fontsで日本語（東アジアの言語）を含むフォントを選択した場合、スクリプトの埋め込みを求められるので、その対応手順になります。 <a style="color:#0366d6" href="https://github.com/IshinoJun/sample-next-adobe-web-font" target="_blank" rel="noopener noreferrer">サンプルコードはこちら</a>。 <h2 id="hfe5a8eaaf7">実行環境</h2><ul><li>Next.js 10.0.0</li><li>React 17.0.1</li></ul> <h2 id="h1c68c77870">AdobeFontsのプロジェクトIDを環境変数に定義</h2>まずはAdobeFontsでプロジェクトIDを取得してください。 それをルート配下の .env.local に以下のように定義してあげてください。<pre><code>NEXT_PUBLIC_KID_ID=&lt;PROJECT_ID&gt;</code></pre> <h2 id="h6fffc0d37f">フォントを読み込むスクリプトを定義</h2>これはAdobeFonts公式のサンプルをそのまま利用します。kitIdの部分は環境変数に書き換えています。 サンプルはルート配下にそのスクリプトを作成します。<pre><code>.&#x2F;adobeLoader

const adobeLoader = (d) =&gt; {
 var config = {
 kitId: process.env.NEXT_PUBLIC_KID_ID,
 scriptTimeout: 3000,
 async: true,
 },
 h = d.documentElement,
 t = setTimeout(function () {
 h.className = h.className.replace(&#x2F;\bwf-loading\b&#x2F;g, &quot;&quot;) + &quot; wf-inactive&quot;;
 }, config.scriptTimeout),
 tk = d.createElement(&quot;script&quot;),
 f = false,
 s = d.getElementsByTagName(&quot;script&quot;)[0],
 a;
 h.className += &quot; wf-loading&quot;;
 tk.src = &quot;https:&#x2F;&#x2F;use.typekit.net&#x2F;&quot; + config.kitId + &quot;.js&quot;;
 tk.async = true;
 tk.onload = tk.onreadystatechange = function () {
 a = this.readyState;
 if (f || (a &amp;&amp; a != &quot;complete&quot; &amp;&amp; a != &quot;loaded&quot;)) return;
 f = true;
 clearTimeout(t);
 try {
 Typekit.load(config);
 } catch (e) {}
 };
 s.parentNode.insertBefore(tk, s);
};

export default adobeLoader;</code></pre> <h2 id="hf051d4c4f3">AdobeFontsのスクリプトを読み込む</h2>次にブラウザ側の処理で1度AobeFontsのスクリプトを読み込む必要があるので、_app.tsx のuseEffect で一度実行するようにします。 サーバーサイド側で実行してしまうと、documentが無くて落ちるので注意しましょう。<pre><code>.&#x2F;pages&#x2F;_app.tsx

import adobeLoader from &quot;..&#x2F;adobeLoader&quot;;

useEffect(() =&gt; {
 if (process.browser) adobeLoader(document);
}, [])</code></pre> <h2 id="h6c094c4b4b">CSSのフォント指定</h2>最後はCSSを指定するだけです。今回はグローバルに以下のCSSを指定しています。<pre><code>font-family: &#x27;fot-tsukuardgothic-std&#x27;, sans-serif;
font-style: normal;
font-weight: 400;</code></pre> <h2 id="hab0ca1fc2c">チラつき対応</h2>そうなんです。実はこのままだとAobeFontsをロードする前に1度デフォルトのフォントが表示されてしまい、以下のように一瞬チラつきます。 <img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/1030c1223966ddc2597064470df5a125.gif" alt> この対策にはAobeFontsの読み込み完了後、htmlタグに.wf-activeというclassが挿入されるので、以下のように対応すると改善されます。<pre><code>html {
 visibility: hidden;
}
html.wf-active {
 visibility: visible;
}</code></pre> これで終了です。お疲れ様でした。 <h2 id="h1afe451c43">さいごに</h2>今回は知り合いに相談されて色々調べてみましたが、あまり参考となる情報がなかったので取り敢えずで対応してみました。 もっといい方法ある気がするw <h2 id="h3de35099b3">参考</h2><a href="https://qiita.com/hirossyi73/items/6551bc32f0d8c2e56092" target="_blank" rel="noopener noreferrer">https:&#x2F;&#x2F;qiita.com&#x2F;hirossyi73&#x2F;items&#x2F;6551bc32f0d8c2e56092</a>

【Next.js】Adobe Fontsに対応してみた

おはこんにちばんは。Next.jsで実装した静的サイトのサイトマップを生成してみました。 その手順を記載します。<a style="color:#24292e" href="https://github.com/IshinoJun/sample-sitemap" target="_blank" rel="noopener noreferrer">サンプルコードはこちら</a>。 <h2 id="hfe5a8eaaf7">実行環境</h2><ul><li>Next.js 10.0.0</li><li>React 17.0.1</li></ul> <h2 id="h0909947c4e">プロジェクトの設定</h2>まずは、雑に静的ページを生成します。<pre><code>.&#x2F;pages &#x2F; [dynamic] &#x2F;index.js

import { GetStaticPaths, GetStaticProps, NextPage } from &#x27;next&#x27;
import React from &#x27;react&#x27;
import { useRouter } from &#x27;next&#x2F;router&#x27;;

const DynamicPage: NextPage = () =&gt; {
 const router = useRouter();
 return (
 &lt;div&gt;
 &lt;h1&gt;{router.query.dynamic}&lt;&#x2F;h1&gt;
 &lt;&#x2F;div&gt;
 )
}

export const getStaticPaths: GetStaticPaths = async () =&gt; {
 const paths = [...Array(10)].map((_, index) =&gt; ({
 params: {
 dynamic: `${index}`,
 },
 }))
 
 return { paths, fallback: false };
}

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

export default DynamicPage</code></pre> <h2 id="hc2e1b5db24">packageを追加</h2>今回は <code>next-sitemap</code> というpackageを利用します。<pre><code>yarn add next-sitemap -D</code></pre> 次にルート配下に <code>next-sitemap.js</code> という設定ファイルを作成します。<pre><code>module.exports = {
 siteUrl: &quot;https:&#x2F;&#x2F;www.example.com&quot;,
 generateRobotsTxt: true,
};</code></pre> 最後にプロジェクトがビルドされるたびにサイトマップ生成をするようにするため、<code>package.json</code>の<code>script</code>に以下を追加します。<pre><code>&quot;postbuild&quot;: &quot;next-sitemap&quot;</code></pre> <h2 id="ha166e75e87">プロジェクトをビルドする</h2><pre><code>yarn build</code></pre> そうするとpublic配下に以下のような<code>robots.txt</code>と<code>sitemap.xml</code>に生成されたかと思います。サイトマップにはすべての静的ページが記載されています。 <pre><code>.&#x2F;public&#x2F;robots.txt

User-agent: *
Allow: &#x2F;
Host: https:&#x2F;&#x2F;www.example.com
Sitemap: https:&#x2F;&#x2F;www.example.com&#x2F;sitemap.xml</code></pre> <pre><code>.&#x2F;public&#x2F;sitemap.xml

&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;urlset xmlns=&quot;http:&#x2F;&#x2F;www.sitemaps.org&#x2F;schemas&#x2F;sitemap&#x2F;0.9&quot; xmlns:news=&quot;http:&#x2F;&#x2F;www.google.com&#x2F;schemas&#x2F;sitemap-news&#x2F;0.9&quot; xmlns:xhtml=&quot;http:&#x2F;&#x2F;www.w3.org&#x2F;1999&#x2F;xhtml&quot; xmlns:mobile=&quot;http:&#x2F;&#x2F;www.google.com&#x2F;schemas&#x2F;sitemap-mobile&#x2F;1.0&quot; xmlns:image=&quot;http:&#x2F;&#x2F;www.google.com&#x2F;schemas&#x2F;sitemap-image&#x2F;1.1&quot; xmlns:video=&quot;http:&#x2F;&#x2F;www.google.com&#x2F;schemas&#x2F;sitemap-video&#x2F;1.1&quot;&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;0&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;1&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;2&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;3&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;4&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;5&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;6&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;7&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;8&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;url&gt;&lt;loc&gt;https:&#x2F;&#x2F;www.example.com&#x2F;9&lt;&#x2F;loc&gt;&lt;changefreq&gt;daily&lt;&#x2F;changefreq&gt;&lt;priority&gt;0.7&lt;&#x2F;priority&gt;&lt;lastmod&gt;2020-11-03T07:56:27.537Z&lt;&#x2F;lastmod&gt;&lt;&#x2F;url&gt;
&lt;&#x2F;urlset&gt;</code></pre> <h2 id="h7005ec096e">Google Serch Consoleからサイトマップを登録する</h2>あとは、Google Serch Consoleの管理画面からサイトマップを追加します。https:&#x2F;&#x2F;www.example.com&#x2F;sitemap.xml で登録可能です。 正しく実装出来ていれば、以下のようにURLを検出してインデックスされるはずです。お疲れ様でした。 <img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/sitemap.png" alt> <h2 id="h1afe451c43">さいごに</h2>このブログ自体のサイトマップを作成していなかったので、実装してみました。とても簡単ですね。 <h2 id="h3de35099b3">参考</h2><a href="https://www.iamvishnusankar.com/blogs/how-to-generate-sitemap-for-nextjs-projects/" target="_blank" rel="noopener noreferrer">https:&#x2F;&#x2F;www.iamvishnusankar.com&#x2F;blogs&#x2F;how-to-generate-sitemap-for-nextjs-projects&#x2F;</a>

【Next.js】静的サイトのサイトマップを生成してみた

おはこんにちばんは。<a href="https://github.com/IshinoJun/nextjs-storybook" target="_blank" rel="noopener noreferrer">Next.jsにStorybookを導入</a>してみました。その手順を記載します。 <h2 id="hfe5a8eaaf7">実行環境</h2><ul><li>Next.js 9.5.3</li><li>React 16.13.1</li><li>Storybook&#x2F;react 6.0.12</li><li>Node.js 12.18.0</li></ul> <h2 id="hc2e1b5db24">packageを追加</h2>いくつか便利なアドオンも追加しています。 <pre><code>yarn add -D @storybook&#x2F;react @storybook&#x2F;addons @storybook&#x2F;addon-a11y @storybook&#x2F;addon-actions @storybook&#x2F;addon-info @storybook&#x2F;addon-knobs @storybook&#x2F;addon-links @storybook&#x2F;addon-storyshots @types&#x2F;storybook__addon-info @types&#x2F;storybook__addon-storyshots @types&#x2F;storybook__react</code></pre> <h2 id="hfa896f3411">設定ファイルを追加</h2>以下、必要な設定を追加します。 <pre><code>.storybook&#x2F;main.js

const path = require(&quot;path&quot;);
const SRC_PATH = path.join(__dirname, &#x27;..&#x2F;src&#x27;);

module.exports = {
 stories: [&#x27;..&#x2F;src&#x2F;**&#x2F;*.stories.tsx&#x27;],
 addons: [
 &#x27;@storybook&#x2F;addon-a11y&#x27;,
 &#x27;@storybook&#x2F;addon-actions&#x27;,
 &#x27;@storybook&#x2F;addon-knobs&#x27;,
 &#x27;@storybook&#x2F;addon-links&#x27;,
 ],
 webpackFinal: async(config, {configType}) =&gt; {
 config.module.rules.push({
 test: &#x2F;\.(ts|tsx)$&#x2F;,
 include: [SRC_PATH],
 use: [
 {
 loader: require.resolve(&#x27;babel-loader&#x27;),
 options: {
 presets: [[&#x27;react-app&#x27;, { flow: false, typescript: true }]],
 }
 },
 { loader: require.resolve(&#x27;react-docgen-typescript-loader&#x27;) }
 ]
 });
 config.resolve.extensions.push(&#x27;.ts&#x27;, &#x27;.tsx&#x27;);
 return config;
 }
};</code></pre> <pre><code>.storybook&#x2F;preview.js

import { addDecorator } from &#x27;@storybook&#x2F;react&#x27;;
import { withInfo } from &#x27;@storybook&#x2F;addon-info&#x27;;
import { withKnobs } from &#x27;@storybook&#x2F;addon-knobs&#x27;;
import { withA11y } from &#x27;@storybook&#x2F;addon-a11y&#x27;;

addDecorator(withInfo);
addDecorator(withKnobs);
addDecorator(withA11y);</code></pre> <h2 id="hc389788d77">コンポーネントとStroyを追加</h2>簡単なコンポーネントとStoryを以下の通り追加します。 Stroyの命名は、<code>Component名 + .stories.tsx</code> になります。 <pre><code>src&#x2F;components&#x2F;Button.tsx

import * as React from &quot;react&quot;;

interface Props {
 text:string;
}

type ButtonProps = React.ButtonHTMLAttributes&lt;HTMLButtonElement&gt; &amp; Props;

const Button: React.FC&lt;ButtonProps&gt; = (props:ButtonProps) =&gt; {
 const { text } = props;

 return (
 &lt;button {...props}&gt;{text}&lt;&#x2F;button&gt;
 );
};

export default Button;</code></pre> <pre><code>src&#x2F;components&#x2F;Button.stories.tsx

import { Meta } from &quot;@storybook&#x2F;react&#x2F;types-6-0&quot;;
import React from &quot;react&quot;;
import Button from &quot;.&#x2F;Button&quot;;

export default {
 title: &quot;Button&quot;,
 component: Button,
} as Meta;

export const Default = (): JSX.Element =&gt; &lt;Button text=&quot;test&quot; &#x2F;&gt;;</code></pre> <h2 id="hb047d44edf">Storybookを起動</h2>packageに以下を追加して起動できるようにします。 <pre><code>package.json

&quot;scripts&quot;: {
 &quot;storybook&quot;: &quot;start-storybook -p 6006&quot;,
 &quot;build:storybook&quot;: &quot;build-storybook -o build&#x2F;storybook&quot;
 }</code></pre> yarn storybook  で起動し、<a style="color:#6200ac" href="http://localhost:6006/" target="_blank" rel="noopener noreferrer">http:&#x2F;&#x2F;localhost:6006</a> にアクセス出来たら成功です。以下のような画面が出るはずです。お疲れ様でした。 <img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/storybook.png" alt> <h2 id="h1afe451c43">さいごに</h2>たまたま触る気があったのでまとめてみました。調べると意外と古い情報が記事が多くありました。 例えば、Storybookの5系から推奨されるCFSで書かれていなかったり、設定ファイルが7系で消えるconfig.jsやaddons.jsを利用しているなど。移り変わりが早いですね... なので、今回は2020&#x2F;9&#x2F;20時点で推奨される記法で書いたつもりです。 また良き情報があれば発信したいと思います。 以上です。最後まで読んで頂きありがとうございます。

【Next.js】Storybookを導入してみた

おはこんにちばんは。<a href="https://github.com/IshinoJun/nextjs-microcms-contact" target="_blank" rel="noopener noreferrer">Next.js + microCMSで問い合わせ機能</a>を実装してみました。 <h2 id="h8d027c8ed3">はじめに</h2><ul><li>実装方法について触れています。特にAPIキーを隠蔽せずに実装している記事が見受けられてたので、その辺は注意して触れていきます。</li><li>Next.js や microCMSとは？っといった概要には触れません。</li></ul> <h2 id="h38c8766536">microCMSの設定</h2>この辺は他のサイトで触れてるところがあったので雑に説明します。 <h3 id="h2c9414f5a4">コンテンツ（API）の追加</h3>API名とエンドポイントを入力し、コンテンツ（API）を追加します。 <img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/%E5%95%8F%E3%81%84%E5%90%88%E3%82%8F%E3%81%9B1.png" alt> 続いて、POSTが使えるリスト形式を選択します。 <img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/%E5%95%8F%E3%81%84%E5%90%88%E3%82%8F%E3%81%9B2.png" alt> 必要なAPIスキーマーを設定すれば終了です。 <img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/%E5%95%8F%E3%81%84%E5%90%88%E3%82%8F%E3%81%9B3.png" alt> なお、以下も忘れずに実施ください。<ol><li>POSTリクエストを有効にする（API設定 &gt; HTTPメソッド設定）</li><li>APIリファレンスからX-WRITE-API-KEYを作成して控えておく</li></ol> <h2 id="h131d3691cd">Next.jsで問い合わせ機能を実装</h2>フォーム機能を実装していきます。 <h3 id="h2ce7c28a66">問い合わせ用の関数を作成</h3>Next.jsにはサーバーレス関数を起動できるAPI Routes機能があります。 その機能を利用し、サーバサイド経由でAPIキーを隠蔽してリクエストを送るようにします。 まず、環境変数を利用するために.env.localを作成し、先ほどメモしたX-WRITE-API-KEYを記載します。 NEXT_PUBLIC_を変数の前にを付けるとフロント側にも公開されてしまうので、APIキーなどでは付けない方が良さそうですね。<pre><code>WRITE_API_KEY=&quot;メモしたX-WRITE-API-KEY&quot;</code></pre> 次に以下のような関数とクエリをチェックするタイプガード を用意します。 詳しくはリンクのコード見てもられば！ <a href="https://github.com/IshinoJun/nextjs-microcms-contact/blob/master/src/pages/api/contact.ts" target="_blank" rel="noopener noreferrer">&#x2F;</a><a style="color:#454545" href="https://github.com/IshinoJun/nextjs-microcms-contact/blob/master/src/pages/api/contact.ts" target="_blank" rel="noopener noreferrer">pages&#x2F;api&#x2F;</a><a href="https://github.com/IshinoJun/nextjs-microcms-contact/blob/master/src/pages/api/contact.ts" target="_blank" rel="noopener noreferrer">contact.ts</a><pre><code> &#x2F;&#x2F; クエリとAPIキーのチェック
 if (!isContact(req.body) || typeof WRITE_API_KEY === &quot;undefined&quot;) {
 return res.status(404).end();
 }

 const content = await fetch(`https:&#x2F;&#x2F;xxxxxx.microcms.io&#x2F;api&#x2F;v1&#x2F;contacts&#x2F;`, {
 headers: { &quot;X-WRITE-API-KEY&quot;: WRITE_API_KEY },
 body: JSON.stringify(req.body),
 })
 .then(() =&gt; &quot;Created&quot;)
 .catch(() =&gt; null);

 &#x2F;&#x2F; CMS側で正しく作成されたかチェック
 if (content !== &quot;Created&quot;) {
 return res.status(401).json({ message: &quot;Unauthorized&quot; });
 }

 res.status(200).json({ message: &quot;OK&quot; });

 res.end(&quot;Contact enabled&quot;);
};</code></pre> <a href="https://github.com/IshinoJun/nextjs-microcms-contact/blob/master/src/utils/TypeGuardUtils.ts" target="_blank" rel="noopener noreferrer">&#x2F;utils&#x2F;TypeGuardUtils.ts</a><pre><code>const isContact = (item: unknown): item is Contact =&gt; {
 const target = item as Contact;

 return (
 &quot;name&quot; in target &amp;&amp;
 typeof target.name === &quot;string&quot; &amp;&amp;
 !!target.name &amp;&amp;
 &quot;email&quot; in target &amp;&amp;
 typeof target.email === &quot;string&quot; &amp;&amp;
 !!target.email &amp;&amp;
 &quot;body&quot; in target &amp;&amp;
 typeof target.body === &quot;string&quot; &amp;&amp;
 !!target.body
 );
};

</code></pre> これで  `&#x2F;api&#x2F;contact` でこの関数を起動できるようになりました。 処理としては、以下のチェックをし、問題無ければ200を返すようにしています。問題があればエラーを返します。<ol><li>クエリとして渡されるオブジェクトが期待通りのオブジェクトか</li><li>実際にmicroCMSのAPIを呼び出して正しく作成されたか</li></ol> microCMSのAPIの呼び出し処理はラッパーなりを用意した方が無難かもですね。keyの設定なりを毎回しなくてはいけないので。 <h3 id="h782dc6ea91">ページ側の作成</h3>今回はフォームバリデーションライブラリの <a href="https://github.com/react-hook-form/react-hook-form" target="_blank" rel="noopener noreferrer">react-hook-form</a>（<a href="https://github.com/jquense/yup" target="_blank" rel="noopener noreferrer">yup</a>）とUIライブラリの<a href="https://material-ui.com/" target="_blank" rel="noopener noreferrer">Material-UI</a>を利用しています。 上記ライブラリについて詳しくは触れませんが、react-hook-formは公式に記載通り以下の点で優秀だなっと思った最近この頃。 <ul><li>再レンダリングが最小に抑えられている</li><li>コードの記述量が少ない</li><li>外部 UI コンポーネントライブラリとの統合が容易</li></ul> ページとしては以下の３つを作成します。量が多いので必要なとこだけ説明します。 <a style="color:#454545" href="https://github.com/IshinoJun/nextjs-microcms-contact/blob/master/src/pages/contact/index.tsx" target="_blank" rel="noopener noreferrer">pages&#x2F;conatct&#x2F;index.tsx</a><pre><code> const onSubmit = async (contact: Contact): Promise&lt;void&gt; =&gt; {
 try {
 await fetch(baseUrl + &quot;&#x2F;api&#x2F;contact&quot;, {
 method: &quot;POST&quot;,
 headers: {
 &quot;Content-Type&quot;: &quot;application&#x2F;json; charset=utf-8&quot;,
 },
 body: JSON.stringify(contact),
 }).then((res) =&gt; {
 if (!res.ok) {
 throw Error(`${res.status} ${res.statusText}`);
 }
 });

 void router.push(&quot;&#x2F;contact&#x2F;success&quot;);
 } catch (err) {
 void router.push(&quot;&#x2F;contact&#x2F;error&quot;);
 }
 };</code></pre> フロント側から上記のように叩くことで先ほど作成した問い合わせ用の関数を起動させています。 これでサーバサイド経由でAPIキーを隠蔽し、リクエストを送るよう出来ました。 「何故フロントからだとAPIキーが隠蔽されないのか」は<a href="https://microcms.io/blog/nuxt-secure-api-key/" target="_blank" rel="noopener noreferrer">このサイト</a>で詳しく解説されておりました。 <a style="color:#454545" href="https://github.com/IshinoJun/nextjs-microcms-contact/blob/master/src/pages/contact/success/index.tsx" target="_blank" rel="noopener noreferrer">pages&#x2F;success&#x2F;index.tsx</a> <a style="color:#454545" href="https://github.com/IshinoJun/nextjs-microcms-contact/blob/master/src/pages/contact/error/index.tsx" target="_blank" rel="noopener noreferrer">pages&#x2F;error&#x2F;index.tsx</a> 上記は、問い合わせの成功時と失敗時の画面です！ これで実装としては完了です。 実装後に作成したフォームで送信してみて、microCMSでその結果が表示出来ていれば完成です！！！ <img src="https://images.microcms-assets.io/protected/ap-northeast-1:136b87b4-3e31-4ee2-8359-d4d4f86f4885/service/jun-dev/media/%E5%95%8F%E3%81%84%E5%90%88%E3%82%8F%E3%81%9B5.png" alt> 最後に通知が必要な方は、Webpack &gt; API設定でSlackやメール通知などが可能なので設定しておくと良いでしょう。 <h2 id="ha214098e44">まとめ</h2>Next.js と microCMS を問い合わせ機能しました。APIキー周りの管理は基本的に自己責任となるので注意が必要ですね。（てかブログ書くの大変）

TypeScript