跳至主要内容

Context Results

在 ChatGPT 中打开

当您从用户界面将数据写入模型时，BindingContext 的 write 方法会触发验证。验证结果决定数据是否可接受。

处理验证结果​

您可以处理验证结果以向用户提供反馈。如果验证失败，您可以阻止模型中的数据更新，并显示与每个失败验证关联的错误消息。

ValidationResult result = context.write(hero);
if (!result.isValid()) {
    displayErrors(result.getMessages());
} else {
    proceedWithUpdate();
}

上下文验证状态​

每当上下文验证组件时，它会触发 BindingContextValidateEvent。该事件传递所有同时更改绑定的 ValidationResult。您可以使用这些结果触发操作并做出适当响应，例如根据整体表单有效性启用或禁用提交按钮。

BindingContext<User> context = new BindingContext<>(User.class);

// 监听在每次用户交互时触发的 BindingContextValidateEvent。
context.addValidateListener(event -> {
    submit.setEnabled(event.isValid());
});

自动聚焦违规​

在处理需要跨多个字段验证的表单时，自动聚焦第一个出错字段可以显著改善用户体验。此功能帮助用户立即识别和纠正错误，简化表单填写过程。

BindingContext 简化了在第一个验证错误的组件上设置自动聚焦的过程。通过使用 setAutoFocusFirstViolation 方法，您可以用最少的代码启用此功能，确保用户界面更直观且对输入错误更具响应能力。

BindingContext<User> context = new BindingContext<>(User.class);
context.setAutoFocusFirstViolation(true);
关注焦点

此功能仅适用于实现 FocusAcceptorAware 关注点的组件。