コンポーネント間の雙方向のデータ バインディングを?qū)g裝する Vue.js の v-model ディレクティブについては誰(shuí)もがよく知っています。ただし、カスタム コンポーネントの v-model を手動(dòng)で実裝すると、通常、いくつかの問(wèn)題が発生します。

通常のアプローチは次のとおりです:

const props = defineProps(['modelValue']);
const emit = defineEmits(['update:modelValue']);
<template></template>

コンポーネント內(nèi)の modelValue プロパティの値は変更しないことに注意してください。代わりに、更新された値を emit メソッド経由で親コンポーネントに返し、親コンポーネントが実際の変更を行います。その理由は次のとおりです。子コンポーネントは親コンポーネントの狀態(tài)に影響を與えるべきではありません。これにより、データ フローが複雑になり、デバッグが困難になります。

Vue のドキュメントに記載されているように、props は子コンポーネント內(nèi)で変更すべきではありません。これを行うと、Vue はコンソールに警告を出します。

対象者の調(diào)子はどうですか?

JavaScript のオブジェクトと配列は參照によって渡されるため、特殊なケースです。これは、コンポーネントがオブジェクト プロパティのネストされたプロパティを直接変更できることを意味します。ただし、Vue は、ネストされたオブジェクトのプロパティの変更について警告しません (これらの変更を追跡すると、パフォーマンスが低下します)。したがって、このような予期しない変更により、アプリケーションで検出やデバッグが困難な問(wèn)題が発生する可能性があります。

ほとんどの場(chǎng)合、基本値を v-model として使用します。ただし、フォームコンポーネントを構(gòu)築する場(chǎng)合など、場(chǎng)合によっては、オブジェクトを処理できるカスタム v-model が必要になる場(chǎng)合があります。これは重要な疑問(wèn)につながります:

上記の落とし穴を回避しながらオブジェクトを処理するカスタム v-model を?qū)g裝するにはどうすればよいですか?

ディスカッションの質(zhì)問(wèn)

1 つの方法は、書(shū)き込み可能な計(jì)算プロパティまたは defineModelヘルパー関數(shù)を使用することです。ただし、どちらのソリューションにも重大な欠點(diǎn)があります。元のオブジェクトを直接変更するため、明確なデータ フローを維持するという目的が損なわれます。

この問(wèn)題を説明するために、「フォーム」コンポーネントの例を見(jiàn)てみましょう。このコンポーネントは、フォーム內(nèi)の値が変更されたときに、オブジェクトの更新されたコピーを親コンポーネントに返すように設(shè)計(jì)されています。書(shū)き込み可能な計(jì)算プロパティを使用してこれを?qū)g現(xiàn)しようとします。

この例では、書(shū)き込み可能な計(jì)算プロパティによって元のオブジェクトが変更されます。

import { computed } from 'vue';
import { cloneDeep } from 'lodash-es';

type Props = {
  modelValue: { name: string; email: string; };
};

const props = withDefaults(defineProps<Props>(), {
  modelValue: () => ({ name: '', email: '' }),
});

const emit = defineEmits<{
  'update:modelValue': [value: Props['modelValue']];
}>();


const formData = computed({
  // 返回的getter對(duì)象仍然是可變的
  get() {
    return props.modelValue;
  },
  // 注釋掉setter仍然會(huì)修改prop
  set(newValue) {
    emit('update:modelValue', cloneDeep(newValue));
  },
});

ゲッターから返されたオブジェクトはまだ 変更可能であるため、これは 機(jī)能しません。元のオブジェクトが予期せず変更されてしまいます。

defineModel 同じことです。 update:modelValue はコンポーネントから出力されないため、オブジェクトのプロパティは警告なしに変更されます。

解決策

この狀況に対処する「Vue の方法」は、內(nèi)部リアクティブ値を使用してオブジェクトを表し、2 つのオブザーバーを?qū)g裝することです。

1. オブザーバーは、modelValue プロパティの変更を監(jiān)視し、內(nèi)部値を更新します。これにより、內(nèi)部狀態(tài)が親コンポーネントによって渡された最新の prop 値を反映するようになります。
2. オブザーバーは內(nèi)部値の変化を観察します。內(nèi)部値が更新されると、元のオブジェクトが直接変更されるのを避けるために、オブジェクトの新しいクローン バージョンが親コンポーネントに出力されます。

これら 2 つのオブザーバー間の無(wú)限のフィードバック ループを防ぐには、modelValue プロパティの更新によって內(nèi)部値のオブザーバーが誤って再トリガーされないようにする必要があります。

const props = defineProps(['modelValue']);
const emit = defineEmits(['update:modelValue']);
<template></template>

「これはやりすぎだ!」と思っていることはわかります。さらに簡(jiǎn)素化する方法を見(jiàn)てみましょう。

VueUse でソリューションを簡(jiǎn)素化します

このロジックを再利用可能な合成関數(shù)に抽出することは、プロセスを簡(jiǎn)素化する優(yōu)れた方法です。しかし良いニュースは、その必要さえないということです。 VueUse の useVModel 結(jié)合関數(shù)は、この問(wèn)題に対処するのに役立ちます。

VueUse は強(qiáng)力な Vue ユーティリティ ライブラリであり、複合ユーティリティの「スイス アーミー ナイフ」とも呼ばれます。完全にツリーシェイク可能なので、パッケージのサイズが大きくなる心配がなく、必要な部分だけを使用できます。

useVModel を使用してリファクタリングする前の例は次のとおりです:

import { computed } from 'vue';
import { cloneDeep } from 'lodash-es';

type Props = {
  modelValue: { name: string; email: string; };
};

const props = withDefaults(defineProps<Props>(), {
  modelValue: () => ({ name: '', email: '' }),
});

const emit = defineEmits<{
  'update:modelValue': [value: Props['modelValue']];
}>();


const formData = computed({
  // 返回的getter對(duì)象仍然是可變的
  get() {
    return props.modelValue;
  },
  // 注釋掉setter仍然會(huì)修改prop
  set(newValue) {
    emit('update:modelValue', cloneDeep(newValue));
  },
});

はるかに簡(jiǎn)単です!

それだけです！子コンポーネントから直接変更せずに、Vue で v-model を含むオブジェクトを適切に使用する方法を検討してきました。オブザーバーを使用したり、VueUse の useVModel のような構(gòu)成関數(shù)を活用したりすることで、アプリケーション內(nèi)で明確で予測(cè)可能な狀態(tài)管理を維持できます。

この記事のすべての例を含む Stackblitz リンクは次のとおりです。自由に探索して実験してください。

読んでいただきありがとうございます。コーディングを楽しんでください!

以上がVue で v-model でオブジェクトを使用する方法の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。