本文へジャンプ

グローバル API: 汎用

version

Vue の現在のバージョンを公開します。

  • 型: string

  • js
    import { version } from 'vue'
    
    console.log(version)

nextTick()

次の DOM 更新処理を待つためのユーティリティーです。

  • ts
    function nextTick(callback?: () => void): Promise<void>
  • 詳細

    Vue でリアクティブな状態を変更したとき、その結果の DOM 更新は同期的に適用されません。その代わり、Vue は「次の tick」まで更新をバッファリングし、どれだけ状態を変更しても各コンポーネントの更新が一度だけであることを保証します。

    状態を変更した直後に nextTick() を使用すると、DOM 更新が完了するのを待つことができます。引数としてコールバックを渡すか、戻り値の Promise を使用できます。

  • vue
    <script setup>
    import { ref, nextTick } from 'vue'
    
    const count = ref(0)
    
    async function increment() {
      count.value++
    
      // DOM はまだ更新されていない
      console.log(document.getElementById('counter').textContent) // 0
    
      await nextTick()
      // ここでは DOM が更新されている
      console.log(document.getElementById('counter').textContent) // 1
    }
    </script>
    
    <template>
      <button id="counter" @click="increment">{{ count }}</button>
    </template>
    vue
    <script>
    import { nextTick } from 'vue'
    
    export default {
      data() {
        return {
          count: 0
        }
      },
      methods: {
        async increment() {
          this.count++
    
          // DOM はまだ更新されていない
          console.log(document.getElementById('counter').textContent) // 0
    
          await nextTick()
          // ここでは DOM が更新されている
          console.log(document.getElementById('counter').textContent) // 1
        }
      }
    }
    </script>
    
    <template>
      <button id="counter" @click="increment">{{ count }}</button>
    </template>
  • 参照 this.$nextTick()

defineComponent()

型推論つきの Vue コンポーネントを定義するための型ヘルパー。

  • ts
    // オプション構文
    function defineComponent(
      component: ComponentOptions
    ): ComponentConstructor
    
    // 関数構文(3.3 以上が必要)
    function defineComponent(
      setup: ComponentOptions['setup'],
      extraOptions?: ComponentOptions
    ): () => any

    読みやすくするため、型は単純化されています。

  • 詳細

    最初の引数には、コンポーネントオプションのオブジェクトを指定します。この関数は基本的に型推論のためだけに実行されるものなので、戻り値は同じオプションオブジェクトになります。

    戻り値の型は少し特殊で、オプションに基づいて推測されたコンポーネントのインスタンス型を持つコンストラクタ型になることに注意してください。これは、返された型が TSX のタグとして使われるときに型推論に使われます。

    次のように、defineComponent() の戻り値の型からコンポーネントのインスタンス型(オプションの this の型に相当)を抽出することができます:

    ts
    const Foo = defineComponent(/* ... */)
    
    type FooInstance = InstanceType<typeof Foo>

    関数シグネチャー

  • 3.3 以上でのみサポートされています

    defineComponent() には、Composition API とレンダー関数か JSX で使うための代替シグネチャーもあります。

    オプションオブジェクトを渡す代わりに、関数を受け取ります。この関数は、Composition API の setup() 関数と同じ働きをします: つまり props と setup コンテキストを受け取ります。戻り値はレンダー関数であるべきで、h() と JSX の両方がサポートされています:

    js
    import { ref, h } from 'vue'
    
    const Comp = defineComponent(
      (props) => {
        // ここでは <script setup> 内と同じように Composition API を使用します
        const count = ref(0)
    
        return () => {
          // レンダー関数か JSX
          return h('div', count.value)
        }
      },
      // 追加のオプション(例: props や emits の宣言など)
      {
        props: {
          /* ... */
        }
      }
    )

    このシグネチャーの主なユースケースは、ジェネリックをサポートしているため、TypeScript(特に TSX)での使用です:

    tsx
    const Comp = defineComponent(
      <T extends string | number>(props: { msg: T; list: T[] }) => {
        // ここでは <script setup> 内と同じように Composition API を使用します
        const count = ref(0)
    
        return () => {
          // レンダー関数か JSX
          return <div>{count.value}</div>
        }
      },
      // 現在のところ、手動によるランタイム props 宣言はまだ必要です。
      {
        props: ['msg', 'list']
      }
    )

    将来的には、ランタイム props を自動的に推論して注入する Babel プラグインを提供し(SFC の defineProps のように)、ランタイム props 宣言を省略できるようにする予定です。

    webpack のツリーシェイキングに関する注意

    defineComponent() は関数呼び出しなので、webpack などのビルドツールでは副作用が発生するように見えるかもしれません。これは、コンポーネントが一度も使われていないときでも、コンポーネントがツリーシェイクされるのを防ぐことができます。

    この関数呼び出しがツリーシェイクされても安全であることを webpack に伝えるには、関数呼び出しの前に /*#__PURE__*/ のコメント表記を追加します:

    js
    export default /*#__PURE__*/ defineComponent(/* ... */)

    これは Vite を使っている場合には必要ないことに注意してください。Rollup(Vite が使用するプロダクションのバンドラー)は賢いので、手動でアノテーションを付けなくても defineComponent() が実際には副作用がないことを判断できます。

  • 参照 ガイド - TypeScript で Vue を使用する

defineAsyncComponent()

レンダリング時にのみ遅延読み込みされる非同期コンポーネントを定義します。引数にはローダー関数か、読み込み動作をより詳細に制御するためのオプションオブジェクトを指定します。

  • ts
    function defineAsyncComponent(
      source: AsyncComponentLoader | AsyncComponentOptions
    ): Component
    
    type AsyncComponentLoader = () => Promise<Component>
    
    interface AsyncComponentOptions {
      loader: AsyncComponentLoader
      loadingComponent?: Component
      errorComponent?: Component
      delay?: number
      timeout?: number
      suspensible?: boolean
      onError?: (
        error: Error,
        retry: () => void,
        fail: () => void,
        attempts: number
      ) => any
    }
  • 参照 ガイド - 非同期コンポーネント

グローバル API: 汎用が読み込まれました