これはクソアプリ2アドベントカレンダー11日目の記事です。
今回、9月に正式リリースされたVue3を使ってとてつもなくシンプルなクソアプリを作ったので、その制作について話をします。

作ったアプリ

URL：https://wyn.whyk.dev/
リポジトリ：https://github.com/windchime-yk/whats-your-name

このアプリのクソポイント

UIがクソ
- ろくすっぽスタイルがあたってません（そもそも要素が少ないというのもある）
機能がクソ
- 機能は、入力された名前にランダム文字列を追加してAPIに投げ、画像を取得して表示するだけです

このアプリの制作趣意

今回は、Vite Appを使い、Vue3とTypeScriptで、以下を学ぶことを目標としていました。

Composition API
Provide/Inject

制作過程

環境構築

まず、Vite AppでVue3環境を構築します。
TypeScriptを使いたいので、--templateフラグを利用してTypeScriptのテンプレートを利用します。

$ npm init vite-app <project-name> -- --template vue-ts
# or
$ yarn create vite-app <project-name> --template vue-ts

この時点でのディレクトリ構造はこちら

.
├── index.html
├── package.json
├── public
│   └── favicon.ico
├── src
│   ├── App.vue
│   ├── assets
│   │   └── logo.png
│   ├── components
│   │   └── HelloWorld.vue
│   ├── index.css
│   ├── main.ts
│   └── vue-app-env.d.ts
├── tsconfig.json
└── yarn.lock

ここからこねこねして、最終的に以下のディレクトリ構造になりました

.
├── README.md
├── index.html
├── package.json
├── src
│   ├── App.vue
│   ├── assets
│   │   └── style
│   ├── components
│   │   ├── AnswerBtn.vue
│   │   ├── InputName.vue
│   │   ├── ResetBtn.vue
│   │   ├── SwichingView.vue
│   │   └── UserImage.vue
│   ├── main.ts
│   ├── store
│   │   └── useState
│   │       ├── model.ts
│   │       └── provider.ts
│   └── vue-app-env.d.ts
├── tsconfig.json
└── yarn.lock

親コンポーネントにProvideを設置

前述の通り、今回のアプリの状態管理にはProvide/Injectを採用してます。これは親コンポーネントの状態を子コンポーネントに状態を受け渡すことができる仕組みで、Propsと違って子コンポーネントであればどこまでも受け渡すことができるので、Propsのようなバケツリレーをすることがありません。
正直、今回の構成だとPropsで問題ないんですが、これを試すのが目的なので、使っています。

まず親コンポーネントで、受け渡す値をuseStateという関数にまとめて別ファイルで変数に格納します。

export const useState = () => {
  const state = reactive({
    name: 'whyk',
    newname: '',
    answered: false,
    clicked: false,
  })

  const updateName = (newname: string) => {
    const randString = Math.random().toString(32).substring(2)
    state.name = `${newname}_${randString}`
  }
  const updateAnswered = () => {
    state.answered = !state.answered
  }
  const updateClicked = () => {
    state.clicked = true
  }
  const resetState = () => {
    state.name = 'whyk'
    state.newname = ''
    state.answered = false
    state.clicked = false
  }

  return {
    state,
    updateName,
    updateAnswered,
    updateClicked,
    resetState,
  }
}

また、この関数を識別するキーとして、シンボル化した値を変数に格納します。
型については、InjectionKeyはProvide/Injectのキーとして利用される型定義、型変数にはStateStoreという、また別の場所で作成された上記関数の返り値を型として利用できるようにしたものになります。

export const StateKey: InjectionKey<StateStore> = Symbol('StateStore')

これらを親コンポーネントであるsrc/App.vueで読み込みます。

import { defineComponent, provide } from 'vue'
import { useState, StateKey } from './store/useState/provider'

export default defineComponent({
  setup() {
    provide(StateKey, useState())
    return {}
  },
})

これで、子コンポーネントへの状態の受け渡しの準備が整いました。

子コンポーネントにInjectを設置

次に、子コンポーネントを作成し、親コンポーネントから状態を受け取ります。

import { defineComponent, inject } from 'vue'
import type { StateStore } from '../store/useState/model'
import { StateKey } from '../store/useState/provider'

export default defineComponent({
  setup() {
    const { state } = inject(StateKey) as StateStore

    return {
      state,
    }
  },
})

Vueから提供されているinjectにProvide/Injectのキーを渡し、型アサーションで型をuseStateの返り値で上書きします。
これで親コンポーネントから状態が受け取れるようになりました。

そのあと

Provide/Injectを使う関係で、すべての要素を子コンポーネントにする必要があります。
そのため、最終的な親コンポーネントは以下のようになっています。

<template>
  <user-image />
  <h1>Whats Your Name?</h1>
  <switching-view>
    <template #question>
      <input-name />
      <answer-btn />
    </template>
    <template #answer>
      <p>Hahaha!! Very suitable!!!!</p>
      <reset-btn />
    </template>
  </switching-view>
</template>

<script lang="ts">
import { defineComponent, provide } from 'vue'
import SwitchingView from './components/SwichingView.vue'
import UserImage from './components/UserImage.vue'
import InputName from './components/InputName.vue'
import AnswerBtn from './components/AnswerBtn.vue'
import ResetBtn from './components/ResetBtn.vue'
import { useState, StateKey } from './store/useState/provider'

export default defineComponent({
  components: {
    SwitchingView,
    UserImage,
    InputName,
    AnswerBtn,
    ResetBtn,
  },
  setup() {
    provide(StateKey, useState())
    return {}
  },
})
</script>

最後に

Advent Calendar初参加でしたが、本来出すはずのクソアプリが完成せず、急きょ別のクソアプリで記事を書きました。
ここに出すはずだったクソアプリを作るプランも並行して考えているので、また違うフレームワークで作ってみたいところです。