メソッドリファレンス

目次

• MTAppJSONTable

  JSON を値に持つ textarea を表形式の入力 UI（テーブル）に変換する jQuery プラグイン。行・列の追加/削除・並べ替え・セル結合に対応し、保存時に内容を JSON へ書き戻す。値は HTML エスケープして表示。

• MTAppListing

  テキスト欄を PowerCMS/MT のアセット選択ダイアログで扱えるフィールドにし、選択アセットの情報（id/ファイル名/URL/サムネ）を JSON 保存する jQuery プラグイン。P7 最適化版。

• MTAppApplyTinyMCE

  概要欄や複数行テキストのカスタムフィールド（textarea）を MT.EditorManager でリッチテキストエディタ（TinyMCE）化する静的メソッド。記事編集画面専用。公開時にエディタ内容を textarea へ書き戻す。

• MTAppDynamicSelect

  テキスト入力欄を、選択肢から選ぶセレクトボックスに置き換える。dynamic で利用者がその場で項目を追加でき、選んだ値は元のテキスト欄に書き戻される。

• MTAppMakeWidget

  右サイドバーに置くウィジェットのHTML文字列を生成して返すヘルパーメソッド。canClose を指定するとヘッダーのアイコンで開閉できるウィジェットになる。

• MTAppMaxLength

  テキスト入力欄に最大文字数を設定し、残り文字数カウンタの表示と超過警告を行う jQuery プラグイン。送信時に超過欄があれば alert で知らせて送信を止める。

• MTAppNumChecker

  数値入力欄の値を blur 時に整形（全角→半角・余分な文字除去）し、最小値・最大値を外れたら警告メッセージを表示する jQuery プラグイン。

• MTAppTaxAssist

  数値欄の直後に「税込み」「税抜き」ボタンを付与し、税率に応じて金額を変換して書き戻す jQuery プラグイン。

• MTAppDateAssist

  テキスト欄の直後に「今日」「明日」「明後日」ボタンを付与し、クリックでその日付を入力する jQuery プラグイン。gengo オプションで元号表記（元号は日付から自動判定）。

• MTAppLineBreakField

  「1項目ごとに改行」式のテキストエリアを、項目ごとの入力欄＋追加・削除・並べ替え GUI に置き換える jQuery プラグイン。値は改行区切りで元の欄へ書き戻す。

• MTAppMakeField

  メインカラムのフィールド（ラベル・コンテンツ・ヒント）の HTML 文字列を生成して返す静的ヘルパー。append/prepend で独自項目を差し込む。

• MTAppMoveToWidget

  指定フィールドを新しいサイドバーウィジェットへまとめる、または既存要素へ移動する静的メソッド。実 DOM ノード移動で値・ハンドラを保持。記事/ページ編集画面専用。

• MTAppAssetsGallery

  MTAppJSONTable と MTAppAssetFields を組み合わせ、アセットをテーブル形式で管理するギャラリー UI を生成する jQuery プラグイン。一括選択アップロード欄付き。

• MTAppAssetFields

  テキスト欄を PowerCMS/MT のアセット選択ダイアログで扱えるフィールドにし、選択アセットの情報（id/ファイル名/URL/サムネ）を JSON 保存する jQuery プラグイン。P7 最適化版。

• MTAppShowListEntries

  テキスト欄を PowerCMS/MT のアセット選択ダイアログで扱えるフィールドにし、選択アセットの情報（id/ファイル名/URL/サムネ）を JSON 保存する jQuery プラグイン。P7 最適化版。

• MTAppMultiFileUpload

  テキスト欄を PowerCMS/MT のアセット選択ダイアログで扱えるフィールドにし、選択アセットの情報（id/ファイル名/URL/サムネ）を JSON 保存する jQuery プラグイン。P7 最適化版。

• MTAppBatchEditCategory

  テキスト欄を PowerCMS/MT のアセット選択ダイアログで扱えるフィールドにし、選択アセットの情報（id/ファイル名/URL/サムネ）を JSON 保存する jQuery プラグイン。P7 最適化版。

• MTAppGoogleMapFields

  記事編集画面で Google マップを表示し中心座標をフィールドへ保存する静的メソッド。住所欄連携でジオコーディング検索。最新の importLibrary＋AdvancedMarkerElement を使用。

• MTAppRemoveVal

  入力欄に×のクリアボタンを付けるメソッド。$.fn（個別の欄に付ける）と静的メソッド（記事/ページ編集のメインカラムへ一括適用）の2つがある。ボタンを押すと値が空になる。

• MTAppTabSpace

  textarea で Tab キーを押したときに文字列（既定は半角スペース4つ）を挿入する jQuery プラグイン。Tab のフォーカス移動を抑止し字下げにできる。選択範囲があれば置換する。

• MTAppInlineEdit

  入力欄をインラインエディットにする jQuery プラグイン。ふだんは値を表示用テキストで見せ、「編集」ボタンで入力欄を表示する。always オプションで空欄でも常に表示。表示値はテキストとして安全に挿入。

• MTAppCreateLink

  画面名（ユーザーダッシュボード／ダッシュボード）から対応する管理画面の URL 文字列を生成して返す静的メソッド。該当しない場合は空文字を返す。MTAppUserMenuWidget のメニュー URL 生成などに使う。

• MTAppDebug

  管理画面のデバッグを補助する静的メソッド。body の id/class と mtappVars のダンプ、フィールドのベースネーム一覧、各種一覧画面での ID 表示・下書き行の強調などを行う。動作は表示中の画面によって変わる。開発者向け。

• MTAppOtherTypeCategories

  記事編集画面のカテゴリ選択 UI をラジオボタンまたはドロップダウンに置き換える静的メソッド。単一選択 UI に変換し、selected/disabled/hidden/nest/add などのオプションを持つ。記事カテゴリが 1 つ以上必要。記事編集画面（edit-entry）専用。

• MTAppCategorySwitch

  選択中のカテゴリに応じて記事編集画面のフィールドの表示／非表示を切り替える静的メソッド。カテゴリを選択した時点で即時に切り替わる。selector（CSS セレクタ）または basename（ベースネーム）で指定する。記事編集画面（edit-entry）専用。

• MTAppDialogMsg

  jQuery UI の dialog を使い、メッセージをダイアログ（ポップアップ）で表示する静的メソッド。タイトル・本文・モーダル表示・閉じる時のエフェクトやコールバックを指定できる。本文（content）は HTML として描画される。

• MTAppMsg

  管理画面上部に MT 標準スタイルの通知メッセージを表示する。info/success/error、閉じるボタン、一定時間後の自動非表示に対応。

• MTAppTabs

  編集画面の複数フィールドを jQuery UI のタブ表示にまとめる。{ basename: タブ名 } で指定（カスタムは cf_ 接頭辞）。MTAppFieldSort と対象を重ねないこと。

• MTAppSortDisabled

  メインカラムのフィールドの D&D 並べ替えを無効化する（#sortable の jQuery UI sortable を disable）。v3 の mtapp.sortDisabled() 相当。

• MTAppFieldSort

  編集画面メインカラムのフィールドを指定順に並べ替える。コア欄とカスタム欄（c: 接頭辞）を混在可。指定外を隠すオプションあり。ウィジェットは非対応。

• MTAppSetLabel

  [セレクタ, 旧テキスト, 新テキスト] の配列で、ページ内の要素テキスト（ラベル等）をまとめて書き換える。MTAppGetLabel の出力を編集して使う。

• MTAppGetLabel

  セレクタに一致する要素を走査し、[セレクタ, ラベル, ラベル] の配列表記を MTAppMsg で一覧表示する開発支援。MTAppSetLabel の定義作りに使う。

• MTAppCustomize

  編集画面のフィールドをまとめてカスタマイズする。ラベル変更・クラス追加・表示制御・ヒント表示・折りたたみ化を basename 指定で行う。

• MTAppSuggest

  テキスト入力欄にカンマ区切りの入力補完（サジェスト）を付与する。部分一致候補をクリック・Enter・上下キーで補完。タグ等の入力向け。

• MTAppTooltip

  対象要素にマウスを乗せている間、カーソルに追随するツールチップを表示する。文言は html／title／alt の優先順位で決定。

• MTAppshowHint

  対象要素にマウスを乗せると、その上に吹き出しスタイルでヒントを表示する。フィールドラベルの補足説明をホバーで見せる用途。

• MTAppFieldSplit

  1つの入力欄を区切り文字で複数の入力欄に分割する。各欄の値は区切り文字で連結して元の欄へ書き戻すため、保存値は通常のテキストフィールドと同じ。

• MTAppNoScrollRightSidebar

  記事編集画面の右サイドバー(#related-content)をスクロールに追随(固定)させる。ウィジェットの開閉は PowerCMS 7 ネイティブに委譲し、本メソッドは追随のみ。

• MTAppGetCategoryName

  カテゴリ／フォルダの配列から、指定した id に一致する項目のラベルやベースネームを取り出して返すヘルパー。DOM は操作せず値を返すだけ。見つからない/不正引数は undefined。

• MTAppMultiCheckbox

  テキスト入力欄をチェックボックス群に置き換え、チェックした値を区切り文字で連結して保存する。標準のタグ欄に適用すると、決めた語彙をクリックで入力でき、表記ゆれを防げる。

• MTAppMultiForm

  指定した要素を、チェックボックス・ラジオボタン・ドロップダウンのいずれかに置き換えるメソッドです。選択された値はカンマ区切りで元のフィールドへ書き戻されます。P7 では本体から削除しており、互換コードを掲載しています。

• MTAppHasCategory

  記事・ウェブページの保存時に、必要な数のカテゴリ、または指定した ID のカテゴリが選択されているかをチェックするメソッドです。条件を満たさない場合はエラーダイアログを表示し、保存を中断します。P7 では本体から削除しており、互換コードを掲載しています。