技術記事

micomia株式会社の井上です。今回はCreate Documentについて解説していきます。

初心者にも分かりやすく解説していくのでぜひご一読ください。

1. Create Documentとは

Create Documentとは、データベースに新しいコレクションを作成するアクションのことを指します。例えばプロフィール情報の入力時や投稿作成時に使われることが多いです。

2. Create Documentの使い方

Create Documentは何かデータがないと意味がないので今回は以下のようにtextfieldとButtonを使って、投稿(post)に関するデータを作成します。

データベースには、以下のようなコレクションを作成しています。今回はText Fieldに詳細文を入力してdescriptionとして保存できるようにしていきます。

3. Create Documentの実装

Create DocumentはActionの1つなので、通常通りAdd ActionでButtonにFirestoreのCreate Documentを追加します。

実装できたらコレクションを選択する箇所が出てくるので、postを選択します。

すると、フィールドを選択する箇所があるので、今回はText Fieldに入力するdescriptionとcreated_by(作成者)とcreated_at(作成日時)を残します。

次にそのフィールドの変数の設定をしていきます。まずcreated_byは、この投稿を作っているユーザーの情報を入れる必要があるのでAuthenticated UserのUser Referenceを入れます。

次に、descriptionはText Fieldに入力した内容を入れたいのでValue SourceはFrom VariableでWidget Stateから先ほどのText Fieldをセットします。

created_atは作成日時なのでFirestore Server Timestampを使用します。

これでCreate Documentは完成です。これだけでも実装としては特に問題ありませんが、UXの観点から投稿が作成できたことがユーザーにわかりやすいようにsnack barやダイアログを使用して伝えるActionもあるとより良いアプリになります。

4. さいごに

今回はCreate Documentについて解説していきました。アプリの要となる投稿作成やユーザー情報の作成時に必要になる機能なのでぜひ本記事を参考に実装してみてください。

本記事の内容を動画で観たい方は以下をご覧ください。