フォームの入力体験を向上させる各種パターン。検証・連動・自動計算・既定値・キー操作などをスクリプトと宣言の組み合わせで実現します。
フィールドの IsRequired: true で必須入力、OnValidateInput スクリプトで独自検証を追加。検証 NG なら SetError(message) を呼んで赤枠 + エラーメッセージを表示。Submit 時は CLB が自動で全フィールドの検証を走らせる。
標準パターン集の対応: サイドバー 入力UX/入力検証 → ValidationSample``
SelectField / RadioGroupField の選択値に応じて、別フィールドの候補が動的に切り替わるパターン。スクリプトで親の OnDataChanged を契機に子の Candidates を組み立てる。
標準パターン集の対応: サイドバー 入力UX/連動入力 → CascadeInput``
SelectField.SearchCondition に FieldVariableMatchCondition で「親フィールドの値で絞り込む」を宣言的に書ける (スクリプト不要)。マスタテーブルから動的に候補を引くケースに最適。
標準パターン集の対応: サイドバー 入力UX/連動入力 (検索条件) → CascadeInputBySearch``
あるフィールドの OnDataChanged スクリプトで別フィールドの値を計算更新するパターン。数量 × 単価 = 小計、開始日 + 期間 = 終了日 などの典型ケース。
標準パターン集の対応: サイドバー 入力UX/計算 → CalcSample``
新規作成時に OnAfterInitialization で Field.Value = DateTime.Now / CurrentUser.Id.Value などを入れる。または DefaultValueAttribute 系で宣言的に。CLB の予約名 Creator / CreatedAt は CLB 自動セットなので別途代入不要。
標準パターン集の対応: サイドバー 入力UX/既定値 → DefaultValueSample``
GridLayout.OnKeyDown スクリプトでキー入力 (Alt+S 保存、Ctrl+Enter 送信、Esc クリア等) を受け取って、対応するアクションを実行。マウス操作なしで業務処理を完結させたい現場向け。
標準パターン集の対応: サイドバー 入力UX/ショートカット → ShortcutSample``
FileField でレコードに任意のファイルを添付。サーバー側 appsettings.json の TemporaryFileTableInfo + 一時ファイルテーブル + FileStorages の 3 点セット設定が必要 (JSON だけでは動かない)。
標準パターン集の対応: サイドバー 入力UX/添付 → AttachmentSample``
ImageField (= 画像専用 FileField) で画像のアップロードとサムネプレビュー表示を組み合わせる。商品画像・プロフィール写真などに。
標準パターン集の対応: サイドバー 入力UX/画像 → ImageUploadSample``
- アプリ作成パターン一覧 ─ 全パターンのインデックス
- モジュール定義の全体構造
- Field リファレンス