Context Results

Ouvrir dans ChatGPT

Lorsque vous écrivez des données de l'UI vers le modèle, la méthode write du BindingContext déclenche les validations. Les résultats de validation déterminent si les données sont acceptables.

Traitement des résultats de validation

Vous pouvez traiter les résultats de validation pour fournir un retour à l'utilisateur. Si une validation échoue, vous pouvez empêcher la mise à jour des données dans le modèle et afficher des messages d'erreur associés à chaque validation échouée.

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

État de validation du contexte

Chaque fois que le contexte valide les composants, il déclenche un BindingContextValidateEvent. Cet événement fournit le ValidationResult pour tous les bindings qui ont changé simultanément. Vous pouvez utiliser ces résultats pour déclencher des actions et répondre de manière appropriée, par exemple en activant ou désactivant le bouton de soumission en fonction de la validité globale du formulaire.

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

// Écoutez le BindingContextValidateEvent qui est déclenché à chaque interaction de l'utilisateur.
context.addValidateListener(event -> {
  submit.setEnabled(event.isValid());
});

Violation de mise au point automatique

Lorsqu'il s'agit de formulaires nécessitant une validation sur plusieurs champs, le fait de mettre automatiquement le premier champ contenant une erreur en focus peut considérablement améliorer l'expérience utilisateur. Cette fonctionnalité aide les utilisateurs à identifier et à corriger immédiatement les erreurs, facilitant ainsi le processus de complétion du formulaire.

Le BindingContext simplifie le processus de configuration du focus automatique sur le premier composant avec une erreur de validation. En utilisant la méthode setAutoFocusFirstViolation, vous pouvez activer cette fonctionnalité avec un code minimal, garantissant que l'interface utilisateur devient plus intuitive et réactive aux erreurs de saisie.

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

Attention au focus

Cette fonctionnalité fonctionne uniquement pour les composants qui implémentent la préoccupation FocusAcceptorAware.