Help us understand the problem. What is going on with this article?

Nuxt.jsのlayoutに変数を渡し、共通ヘッダーのタイトルを動的に変える方法

「Nuxt.jsのlayoutに各pageから変数を渡す」

とても簡単そうなことですが、調べてもあまり情報がなくて意外に時間をかかったので紹介します。

やりたいこと

下記ディレクトリ構成で、layoutに全ページ共通のヘッダーを設置し、ヘッダーに表示するタイトルを、ページごとに設定をしたかったです。
調べたところEventListenerを使う方法(*1)、Vuexを使う方法などがありましたが、どちらも理想の使いやすさではなかったので、Vue Routerで行う方法を考えました。

ディレクトリ構成

layouts
  |- default.vue
components
  |- organisms
      |- CommonHeader.vue
pages
  |- index.vue 

layouts/default.vue

<template>
  <div>
    <common-header title="タイトル" />
    <nuxt />
  </div>
</template>
<script>
import CommonHeader from '@/components/organisms/CommonHeader'
export default {
  components: { CommonHeader },
}
</script>

components/organisms/CommonHeader.vue

organismsというフォルダ名はAtomic Designを採用した構成です。 (*2)

<template>
  <header class="header">
    <div class="header-leftSide">ロゴ画像</div>
    <h1 class="header-title">{{ title }}</h1>
    <div class="header-rightSide">メニュー</div>
  </header>
</template>

<script>
export default {
  props: {
    title: { type: String, default: '' },
  },
}
</script>

<style lang="scss" scoped>
.header {
  display: flex;
  justify-content: space-between;
  // ...省略
}
</style>

pages/index.vue

<template>
  <div>省略</div>
</template>

<script>
export default {
  head() {
    return {
      title: 'TOPページ',
    }
  },
}
</script>

解決方法

Vue Routerでマッチしたコンポーネントを取得し、コンポーネント内で定義した変数を取得します。

<!-- layouts/default.vue -->
<template>
  <div>
    <common-header title="title" />
    <nuxt />
  </div>
</template>
<script>
import CommonHeader from '@/components/organisms/CommonHeader'
export default {
  components: { CommonHeader },
  computed: {
    title() {
      const matchedRoute = this.$route.matched[0] // マッチしたrouteを取得
      const headInfo = matchedRoute.components.default.options.head() // 該当routeのdefault componentのhead情報を取得
      return headInfo ? headInfo.title : ''
    },
}
</script>

注意点

  • ネストされたルートの場合、複数のルートにマッチする(親コンポネントが最初にマッチされる)ので、上記のコードを少し変更する必要があります。

終わりに

この方法で「理解しやすさ」と「使いやすさ」の目標を達成したと思いますが、もっといい方法があるかな?
他にいい方法がありましたら、ぜひコメントしてください。

参考文献

  1. https://qiita.com/yama-t/items/b051cd9ea802f69da118
  2. https://design.dena.com/design/atomic-design-%E3%82%92%E5%88%86%E3%81%8B%E3%81%A3%E3%81%9F%E3%81%A4%E3%82%82%E3%82%8A%E3%81%AB%E3%81%AA%E3%82%8B/
  3. https://router.vuejs.org/ja/guide/#javascript
  4. https://github.com/nuxt/nuxt.js/issues/319
Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
Comments
No comments
Sign up for free and join this conversation.
If you already have a Qiita account
Why do not you register as a user and use Qiita more conveniently?
You need to log in to use this function. Qiita can be used more conveniently after logging in.
You seem to be reading articles frequently this month. Qiita can be used more conveniently after logging in.
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
ユーザーは見つかりませんでした