MTAppjQuery v2 から v3 へのアップグレード

最終更新日：2024.09.23 公開日：2023.11.17

MTAppjQuery v2 から v3 へアップグレードする際に注意すべき点をまとめました。

user.js、user.css のインストールディレクトリの変更

MTAppjQuery v2 までは、デフォルトの user.js と user.css が mt-static/plugins/MTAppjQuery/user-files/ ディレクトリの中にありましたが、MTAppjQuery v3 ではこの二つのファイルを mt-static/support/MTAppjQuery/ ディレクトリに移動しました。したがって、 mt-static/plugins/MTAppjQuery/user-files/ ディレクトリの中の user.js と user.css をカスタマイズしてご利用の場合は、それらのファイルを mt-static/support/MTAppjQuery/ 配下に移動してください。

【移動前】

mt-static/plugins/MTAppjQuery/user-files/user.js
mt-static/plugins/MTAppjQuery/user-files/user.css

【移動後】

mt-static/support/MTAppjQuery/user.js
mt-static/support/MTAppjQuery/user.css

defer 属性の追加

MTAppjQuery v3 から MTAppjQuery 等の読み込みタグに defer 属性が追加されました。そのため、自由テキスト欄を利用して script タグで user.js やその他の JavaScript ファイルを読み込んでいる場合は、下記のように script タグに defer 属性を付けてください。

<script defer type="text/javascript" src="/PATH_TO/filename.js"></script>

インラインの JavaScript で処理を書いている場合は下記のように DOMContentLoaded にイベントをセットする形で定義してください。

<script>
    window.addEventListener('DOMContentLoaded', function(){
      // 処理
    });
</script>

また、上記のインラインの処理の中で jQuery を使う場合は下記のようにしてください。

<script>
    window.addEventListener('DOMContentLoaded', function(){
        (function($) {
            // 処理
        })(jQuery);
    });
</script>

mtapp.multiField（マルチフィールド）に関するアップグレードの注意点

MTAppjQuery v2 から v3.1.0 以降へのアップグレードする場合は「MTAppjQuery v3.0.x から v3.1.0 へのアップグレード」をご確認ください。

MTAppjQuery v2 から v3.0.7 へのアップグレードする場合は「mtapp.multiField（マルチフィールド）v2 から v3 へのアップグレード」をご確認ください。

旧バージョンのメソッド

MTAppjQuery v2 まで存在した「旧バージョンのメソッド」の設定は v3.0.1 で廃止されました。旧バージョンのメソッドの中の MTAppJSONTable、MTAppListing は本体の MTAppjQuery.js に統合されましたのでそのままお使いいただけます。

その他のメソッドをご利用の場合は、メソッドのソースコードを user.js の先頭にコピーアンドペーストしてご利用ください。それらのソースコードについては追って当サイトに掲載します。お急ぎの方は support@bit-part.net までお問い合わせください。

オプションプラグイン MTAppCSVEditor の本体への統合

MTAppjQuery v2 までオプションプラグインとして販売していた「MTAppCSVEditor」プラグインが、MTAppjQuery v3 において本体に統合され、メソッド名が .mtapp('csvEditor') に変更されました。

それに伴い、下記の通り .MTAppCSVEditor() メソッドを .mtapp('csvEditor') に置き換えてください。基本的には「.MTAppCSVEditor(」を「.mtapp('csvEditor',」に一括置換していただければ問題ありません。

// 変更前
$('セレクタ').MTAppCSVEditor({
  オプション設定
});

// 変更後
$('セレクタ').mtapp('csvEditor', {
  オプション設定
});

その他の変更等

コンテンツデータフィールドのオブジェクト mtappVars.contentDataFields の値が参照する要素が jQuery オブジェクトからHTMLElementオブジェクトに変更されました。
コンテンツデータフィールドのIDと名前の配列 mtappVars.contentDataFieldsArray の id プロパティの値が文字列から数値になりました。
mtappVars.content_type.fields が正しく取得できていなかったのを修正

削除された機能・メソッド等

mtapp.templateListCustomize() が削除されました。