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),執行非同步檢查後,帶著相同的 token 呼叫 completeValidation(key, token, valid, message)。若使用者期間再次編輯,來自舊 token 的結果會自動忽略。

API 參考