Fluent-Qt

基礎ガイド

フォームと検証

フォーム内の変更済みフィールド、エラーメッセージ、非同期バリデーションを管理します。

フィールドの登録

各入力ウィジェットを 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");
});

非同期バリデーション

validationRequested(key, token) を処理して非同期チェックを実行し、同じトークンを使って completeValidation(key, token, valid, message) を呼び出します。ユーザーが途中で再編集した場合、古いトークンの結果は自動的に無視されます。

API リファレンス