useDeleteDoc(ドキュメントの削除)
Firestore 上のドキュメントを削除するのに用います。
const [deleteFn, deleting, called, error] = useDeleteDoc(path, options);
Hooks の戻り値
deleteFn:
() => voidドキュメントを削除するための関数です。
deleting:
booleanドキュメントを削除しているかを表します。
called:
booleandeleteFnが呼び出されたかどうかを表します。error:
Errorデータ書き込みの際にエラーが発生した場合エラー内容が入力されます。初期値には
nullが代入されています。
Hooks の引数
path:
string書き込み対象のドキュメントの Firestore 上のパスです。
optional options:
objectデータを取得する際のオプションです。
options の内容
optional callback:
() => voidデータを削除する際に実行される関数を指定することができます。
Example
const [deleteAdams, deleting, called, error] = useDeleteDoc("/users/Adams");
次を実行することでドキュメントを削除できます。
deleteAdams();
View でのステータス表示
deletingとcalledを組み合わせることで、削除に関するステータスを表現することができます。
return (
<>
{!called && <div>Before call deleteFn</div>}
{deleting && <div>Deleting...</div>}
{error !== null && <div>Error</div>}
{!deleting && called && error === null && <div>Completed</div>}
</>
);