フォーム入力画面イベント

フォーム入力画面（公開フォームの入力画面）で利用可能なイベントについて説明します。

表示イベント

form.show

フォーム入力画面を開いた際に実行されるイベントです。

フォームに自動計算パーツが含まれる場合、初回の自動計算処理が完了してから発火します。

記述例

collaboform.events.on('form.show', function(data) {
    // フォーム入力画面を開いた際に実行されます
    console.dir(data);
});

パーツ値変更イベント

form.<パーツID>.change

フォーム内のパーツ値が変更された場合に実行されるイベントです。

パーツIDはコラボフローのフォーム編集画面で確認できます。

記述例

collaboform.events.on('form.fid1.change', function(data) {
    // fid1 の値が変更された際に実行されます
    console.dir(data);
});

注意点

• 明細に配置したパーツも同様の記述をおこないます。
• 明細に配置したパーツの変更イベントでは、行インデックス（data.row_index）・テーブルID（data.table_id）を取得することができます。テーブルIDは「tbl_1」固定です。

確認ボタン押下イベント

form.confirm

「確認」ボタンがクリックされた際に実行されるイベントです。

記述例

collaboform.events.on('form.confirm', function(data) {
    if (data.parts.fidUserType.value === '顧客'
    && data.parts.fidCustomerName.value === '') {
        alert('顧客名は必須です。');
        // false を返すと入力確認画面への遷移を中止します
        return false;
    }
    // true を返すか、何も返さないと続行します
    return true;
});

注意点

• 「false」をreturnすることで、入力確認画面への遷移を中止することができます。
• 「collaboform.proxy.call」などでPromiseオブジェクトをreturnした場合は、非同期処理をおこなってから処理されます。

補足

その他のイベント処理の詳細、イベントデータや注意事項に関しては「イベントの記述方法」をご確認ください。