データコンテナ配列のコールバック関数
コールバック関数はイベントのディスパッチャーのパターンに基づいています。特定のイベントに1つ以上のコールバックを登録でき、イベントが置きるとコールバック関数を実行します。コールバックによって、Contaoのコアのエンジンのプログラムの流れをカスタマイズできます。
全体的なコールバック
| コールバック | 説明 |
|---|---|
| onload_callback | データコンテナオブジェクトを初期化するときに実行します。例えば、権限を確認したり、データコンテナ配列を実行時に変更するといったことができます。 |
| onsubmit_callback | バックエンドのフォームを提出したときに実行します。例えば、フォームのデータをデータベースに書き込む前に変更することができます。(カレンダー機能拡張で期間の計算に使用) |
| ondelete_callback | データベースからレコードを削除する前に実行します。 |
| oncut_callback | 新しい位置にレコードを移動した後に実行します。バージョン2.8.2で追加しました。 |
| oncopy_callback | レコードを複製した後で実行します。バージョン2.8.2で追加しました。 |
リストのコールバック
| コールバック | 説明 |
|---|---|
| paste_button_callback | 個々の張り付けボタンに使用できます。例えば、サイト構造でユーザーの権限に応じてボタンを無効にするために使用しています。(load_callbackによる追加のコマンドの検査が必要です。) |
| child_record_callback | 「ペアレントビュー」で子の要素を表示する方法を指定します。 |
| group_callback | 一覧の個々のグループヘッダーで使用できます。 |
| label_callback | 一覧の個々のラベルに使用できます。例えば、ユーザーモジュールは状態のアイコンの表示に使用しています。 |
操作のコールバック
| コールバック | 説明 |
|---|---|
| button_callback | 個々のナビゲーションアイコンで使用できます。例えば、サイト構造でユーザーの権限に応じてボタンを無効にするために使用しています。(load_callbackによる追加のコマンドの検査が必要です。) |
フィールドのコールバック
| コールバック | 説明 |
|---|---|
| options_callback | ドロップダウンメニューやチェックボックスのリストにデータを読み込む個々の関数を定義できます。例えば、条件付きの外部キー関係のために便利です。 |
| input_field_callback | 個々のフィールドの作成に使用できます。例えば、「個人データ」のバックエンドモジュールで「データの消去」のウィジェットの生成に使用しています。 注意: このフィールドは自動的に保存しません! |
| load_callback | フォームのフィールドを初期化するときに実行します。例えば、デフォルトの値を読み込むのに使用できます。 |
| save_callback | フィールドを提出したときに実行します。例えば、個々の検証処理の追加に使用できます。 |