基礎指南
表單與驗證
在表單中追蹤已修改欄位、錯誤訊息與非同步驗證流程。
註冊表單欄位
使用 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),執行非同步檢查後,帶著相同的 token 呼叫 completeValidation(key, token, valid, message)。若使用者期間再次編輯,來自舊 token 的結果會自動忽略。