前回レイアウトを再現していい感じになりました。
https://herohoro.com/blog/blog-learn-layout_start
今回はこのレイアウトにAPI機能を追加してツヨツヨにするべく、
APIで頻出の「req」や「res」についてのモヤモヤと向き合いながら、
公式learnのサンプルを実装や、
Blog learn用に作ってきたレイアウトへの追加をしていきます。
Notion API前夜的な位置づけでお送りいたします🕺🏻🕺🏻🕺🏻🕺🏻🕺🏻🕺🏻🕺🏻🕺🏻🕺🏻🕺🏻
今まで果敢に攻めようとAPIの解説記事を読みあさったこともありましたが.......
reqとresの意味がチンプンカンプンでした。
図解があってもワカラナイ........
丁寧な解説動画を見てもワカラナイ.......
requestとresponseなんて言われたってもっとワカラナイ.....
reqが要求でres応答って訳されたってワカラナイ.......
これは私の国語力の低さが影響しているのかもしれない.....
ということに気づき、
とにかく作ってみることにしました。
作ってうまく行かなければ捨てればいい。
エラーにハマったら迷わず作り直せばいい....。
やり直しをすぐにできるようになるべく数行で実装できて、
コードの内容もシンプルなものを選びました🙆🏻♀️
👉指定された注文に対して反応すること
イメージできないので
とりあえずNext.js learnにあるサンプルを実装してみることにしました。
👉反応(表示)したまま
https://nextjs.org/learn/basics/api-routes/creating-api-routes
export default function handler(req, res) {
res.status(200).json({ text: 'Hello' })
}
手入力でapi/hello
をURLに追加してあげないと表示されないってことを理解。
何かをクリックするとパンって飛んでこの画面が表示されることはない。
入力してどうこうすることもない。。。。
それがres っていう役割か.......(´・ω・`)
Next.js docにreq/resをつかったformサンプルが紹介されていたので、
入力フォームを作ってみることにしました。
https://nextjs.org/docs/guides/building-forms
完全写経ではなく、使いたい部分のみ実装してます。m(_ _)m
apiフォルダのuser.tsxへsubmitするんだよっていうform
blogページ(index.tsx)でsubmitされたデータをres(表示)してねっていう注文
reqからresへ注文が入ることで待ちぼうけしないですむってことだね\(^o^)/
少しずつ難しくなってきましたが、
req/resがわかればこっちのもの。
↓
Choose a verseによって内容が切り替わります⭐
https://codesandbox.io/embed/fetch-learn-yw6d60?fontsize=14&hidenavigation=1&theme=dark
👆code sandboxのリンクへ飛ぶとverseを選んで表示の確認操作を試せますよ——👯
このサンプルは、mdn web docsというサイトの解説で扱われていました⭐
実際のアプリケーションでは、PHP や Python、Node のようなサーバサイド言語を使ってデータベースから取り出したデータをリクエストする場合が多いでしょう。ですがここでは簡単にしておき、クライアント側のパートに集中します。
外部データをverse1.txtとverse2.txtとして、
実際組み立てるのはindex.htmlのみ!!
※ 今回verse3, verse4は省略しています.....
▼ ファイル構成
<script>
const verseChoose = document.querySelector("select");
const poemDisplay = document.querySelector("pre");
verseChoose.onchange = function () {
const verse = verseChoose.value;
updateDisplay(verse);
};
function updateDisplay(verse) {
verse = verse.replace(" ", "");
verse = verse.toLowerCase();
let url = verse + ".txt";
let request = new XMLHttpRequest();
request.open("GET", url);
request.responseType = "text";
request.onload = function () {
poemDisplay.textContent = request.response;
};
request.send();
}
updateDisplay("Verse 1");
verseChoose.value = "Verse 1";
</script>
script部分のコードの解説が詳しく載っていてreqにするまでの前処理の工程が勉強になりました。
解説の中でコードリンクがあるのですが......少し注意点を発見。
https://github.com/mdn/learning-area/tree/main/javascript/apis/fetching-data
部分的に?な要素があっても参照リンクが埋め込まれていて効率よく学ぶことができました(*^^*)
document.querySelector("pre").textContent
に書き換えれば納得!
▶ https://developer.mozilla.org/ja/docs/Web/API/Node/textContent
request.response
はリクエストの内容を表示する
▶ https://developer.mozilla.org/ja/docs/Web/API/XMLHttpRequest/response
Next.js learnではmdファイルからデータを取り出して表示していました。
ファイル構成(関係あるファイルのみ抜粋)
---
title: "Two Forms of Pre-rendering"
date: "2020-01-01"
---
Next.js has two forms of pre-rendering: **Static Generation** and **Server-side Rendering**. The difference is in **when** it generates the HTML for a page.
- **Static Generation** is the pre-rendering method that generates the HTML at **build time**. The pre-rendered HTML is then _reused_ on each request.
- **Server-side Rendering** is the pre-rendering method that generates the HTML on **each request**.
Importantly, Next.js lets you **choose** which pre-rendering form to use for each page. You can create a "hybrid" Next.js app by using Static Generation for most pages and using Server-side Rendering for others.
import fs from "fs";
import path from "path";
import matter from "gray-matter";
//current working directory
const postsDirectory = path.join(process.cwd(), "posts");
export function getSortedPostsData() {
// Get file names under /posts
const fileNames = fs.readdirSync(postsDirectory);
const allPostsData = fileNames.map((fileName) => {
// Remove ".md" from file name to get id
const id = fileName.replace(/\.md$/, "");
// Read markdown file as string
const fullPath = path.join(postsDirectory, fileName);
const fileContents = fs.readFileSync(fullPath, "utf8");
// Use gray-matter to parse the post metadata section
// テキストデータ内上部にある「 ---」で囲まれた部分をdataとして位置づけて取得する
const matterResult = matter(fileContents);
// Combine the data with the id
// Combine the data【---で囲まれた部分】 with the id【拡張子無しファイル名】
return {
id,
...(matterResult.data as { date: string; title: string })
};
});
// Sort posts by date
return allPostsData.sort((a, b) => {
if (a.date < b.date) {
return 1;
} else {
return -1;
}
});
}
import { getSortedPostsData } from "../lib/posts";
import { GetStaticProps } from "next";
export const getStaticProps: GetStaticProps = async () => {
const allPostsData = getSortedPostsData();
return {
props: {
allPostsData
}
};
};
export default function RenderPage({
allPostsData
}: {
allPostsData: {
date: string;
title: string;
id: string;
}[];
}) {
return (
<div className={styles.container}>
<div>
//省略
</div>
<section>
<h3>verse data</h3> //正確にはverseではなくNext.jsのレンダリングについての内容でした....
<ul>
{allPostsData.map(({ id, date, title }) => (
<li key={id}>
{title}
<br />
{id}
<br />
{date}
</li>
))}
</ul>
</section>
</div>
);
}
reqで注文して、
resで反応する。
それがAPI routingと言われている動き。
外部からデータを持ってきて表示することを
data fetchingと言われていて、
表示させるために下準備をしておいて、
propsを使って差し替えながら使い回す。
こんな感じの動きをしていることが分かってきた\(^o^)/\(^o^)/
No. | branch | description | リンク | PR |
---|---|---|---|---|
7 | rseo19 | API routing _入力フォーム | https://github.com/herohoro/Blog_learn/pull/9 | #9 |
8 | rw064k | Data fetching _収納したディレクトリからテキストデータを表示_lib | https://github.com/herohoro/Blog_learn/pull/10 | #10 |
https://github.com/herohoro/Blog_learn/wiki
easy-notion-blogはNotionからデータを取ってくるので、
Notion APIの知識も必要そう.......
ってことで次回はいよいよNotion APIと戯れます\(^o^)/
▼ この記事に興味があったら同じタグから関連記事をのぞいてみてね
RSSリーダーにatomのリンクを登録すると通知が行くよ🐌
https://herohoro.com/atom
やってみてね(*´ω`*)(*´ω`*)
フォロー大歓迎\(^o^)/
フォロー大歓迎\(^o^)/