フィールド編集可/不可切替
概要
指定したフィールドIDに対応する入力要素の編集可/不可を切り替えます。
構文
atPocket.app.record.setFieldDisabled(fieldId, isDisabled, rowIndex);
引数
| 引数名 | 型 | 説明 |
|---|---|---|
| fieldId | string | フィールドのID。明細（SubTable）の場合は列のUID |
| isDisabled | boolean | 編集不可にするかどうか（省略時は編集可） |
| rowIndex | number | 明細の行インデックス（0始まり・任意）。省略して列UIDのみを指定した場合はその列の全行が対象 |
戻り値
| 対象 | 型 | 説明 |
|---|---|---|
| 通常のフィールド | なし | 同期的に適用されます |
| 明細のセル・列 | Promise<void> | 適用の完了を待つ場合は await してください |
使用可能画面
- レコード詳細画面
- レコード作成画面
- レコード編集画面
使用例
// フィールドを編集不可にする
atPocket.app.record.setFieldDisabled("field_123", true);
// フィールドを編集可能にする
atPocket.app.record.setFieldDisabled("field_123", false);
// フィールドを編集可能にする（デフォルト動作）
atPocket.app.record.setFieldDisabled("field_123");
明細（SubTable）のセル・列を対象にする
// 1行目のセルだけを編集不可にする
await atPocket.app.record.setFieldDisabled('field-6_1', true, 0);
// 列の全行を編集不可にする
await atPocket.app.record.setFieldDisabled('field-6_2', true);
明細（SubTable）に適用する場合の注意
行の追加・コピー・削除・並び替えを行うと、適用した編集可否は解除されます。行操作の change イベントで再適用してください（明細（SubTable）の操作）。
注意
計算フィールド（Calc）には対応していません。