MTAppjQuery v3.0.x から v3.1.0 へのアップグレード

mtapp.multiField は v3.1.0 で Vue.js から Svelte での実装に変更されました。そのため MTAppjQuery v3.0.x から v3.1.0 にアップグレードする際の注意点をまとめました。

Vue.js の同梱終了と Svelte への移行

MTAppjQuery v3.0.x までの mtapp.multiField v1 と mtapp.multiField v2 は Vue 2 をベースに構築されています。
2023年12月31日に Vue 2 のサポートが終了（EOL）したことを受け、MTAppjQuery v3.1.0 では Vue.js を Svelte に置き換え、Vue.js 本体の同梱を終了しました。

この変更に伴い、下記の1、2の条件の両方に当てはまる場合は 「v3.1.0用の対応」が必要となり、1の条件だけに当てはまる場合は 「mtapp.multiField v2 から v3 への対応確認」が必要となります。

1. mtapp.multiField v2 を利用している
2. オリジナルフィールド（独自の Vue コンポーネント）を利用している

multiFieldのバージョン確認方法と対応の要否

ご利用中の mtapp.multiField() が mtapp.multiField v1 、mtapp.multiField v2 、mtapp.multiField v3 のいずれに該当するかは、mtapp.multiField() の version オプションの値で判定できます。

// mtapp.multiField v1 を利用しているフィールド → 対応不要
mtapp.multiField({
    version: 1,
    ...以下省略
});

// mtapp.multiField v2 を利用しているフィールド
// → オリジナルフィールドを利用している場合 → v3.1.0用の対応が必要
// → オリジナルフィールドを利用していない場合 → mtapp.multiField v2 から v3 への対応確認が必要
mtapp.multiField({
    version: 2,
    ...以下省略
});

// mtapp.multiField v3 を利用しているフィールド → 対応不要
mtapp.multiField({
    version: 3,
    ...以下省略
});

// mtapp.multiField v3 を利用しているフィールド → 対応不要
mtapp.multiField({
    ...以下省略（version オプションの指定なし）
});

v3.1.0用の対応

mtapp.multiField v2 でオリジナルフィールド（独自の Vue コンポーネント）を利用していて、引き続きオリジナルフィールドを利用する場合、Vue 2 ベースの mtapp.multiField v2 を利用する必要があります。

そのためには、下記の2つの設定が必要となります。

1. プラグインの設定変更

システムまたは各サイトのMTAppjQueryプラグインの設定の「利用データの設定」セクションの中の「Vue 2 版の mtapp.multiField」のドロップダウンリストから「有効」を選びます。

すると、Vue.js の URL を入力する欄が表示されるので、そこにURLを入力して保存してください。URL の初期値は Vue 2 の CDN のURL になっています。

2. user.js の mtapp.multiField() に useVueJs:true を追加

プラグインの設定を変更した後、該当するフィールドの mtapp.multiField() のオプションに useVueJs: true を追加してください。

// Vue 2 版の mtapp.multiField v2 を利用する
mtapp.multiField({
    version: 2,
    useVueJs: true, // プラグイン設定を変更後、この行を追加します
    ...以下省略
});

mtapp.multiField v2 から v3 への対応確認

mtapp.multiField v2 の利用状況によってはテンプレートの修正などの対応が必要になる場合があります。詳細は以下のドキュメントをご確認ください。

• mtapp.multiField（マルチフィールド）v2 から v3 へのアップグレード

将来的な削除予定

Vue 2 版のマルチフィールド機能は、将来のバージョンで削除される予定です。

mtapp.multiField v2 でオリジナルフィールドをご利用の場合は、mtapp.multiField v3 の「汎用フィールド」への置き換え等を検討していただく必要があります。オリジナルフィールドをご利用になっている場合は support@bit-part.net までご連絡ください。