基礎ガイド
フォームと検証
フォーム内の変更済みフィールド、エラーメッセージ、非同期バリデーションを管理します。
フィールドの登録
各入力ウィジェットを layout::Field でラップし、FormController::addField() で登録します(非所有)。コントローラーは変更済み・操作済み・検証中・有効の各状態を追跡し、Field のエラーテキストを自動更新します。入力が変化した際は markFieldChanged() を呼び出してください。
#include <FluentQt/Foundation.h>
#include <FluentQt/Layout.h>
auto* form = new fluent::FormController(this);
form->addField("email", emailField); // emailField: fluent::layout::Field*
QObject::connect(emailEdit, &QLineEdit::textChanged, form, [form] {
form->markFieldChanged("email");
});import fluentqt
form = fluentqt.FormController(window)
form.addField("email", email_field)
email_edit.textChanged.connect(lambda _: form.markFieldChanged("email"))非同期バリデーション
validationRequested(key, token) を処理して非同期チェックを実行し、同じトークンを使って completeValidation(key, token, valid, message) を呼び出します。ユーザーが途中で再編集した場合、古いトークンの結果は自動的に無視されます。