FAQ JavaFXConsultez toutes les FAQ

Pour créer un champ d’édition textuel sur une seule ligne, vous devez créer une instance de la classe javafx.scene.control.TextField.

Par exemple :

final TextField textField = new TextField();

Pour créer un champ d’édition de mot de passe sur une seule ligne, vous devez créer une instance de la classe javafx.scene.control.PasswordField. Les chaines de texte saisies dans cet éditeur seront masquées par un caractère unique.

Par exemple :

final PasswordField textField = new PasswordField();

Pour créer une zone d’édition sur de multiples lignes, vous devez créer une instance de la classe javafx.scene.control.TextArea.

Par exemple :

final TextArea textArea = new TextArea();

Pour savoir si le contenu d'un champ d’édition a été modifié, il suffit de placer un écouteur de type InvalidationListener ou ChangeListener sur sa propriété text.

Par exemple :

textField.textProperty().addListener(observable -> System.out.println("Champ d'édition modifié !"));

Il est possible de modifier le texte dans un champ d’édition via plusieurs méthodes d’édition prêtes à l'emploi :

• clear() - supprime tout le texte ;
• deleteNextChar() - cette méthode supprime le caractère situé après le curseur de saisie ;
• deletePreviousChart() - cette méthode supprime le caractère situé avant le curseur de saisie ;
• deleteText() - cette méthode supprime le texte contenu entre les indices ou l'IndexRange passés en paramètre ;
• insertText() - cette méthode permet d’insérer du texte contenu à l'indice passé en paramètre ;
• replaceSelection() - cette méthode remplace la sélection actuelle par un nouveau contenu ;
• replaceText() - cette méthode permet de remplacer le texte contenu entre les indices ou l'IndexRange passés en paramètre.
  

Pour savoir si la sélection dans un champ d’édition a été modifiée, il suffit de placer un écouteur de type InvalidationListener ou ChangeListener sur sa propriété en lecture seule selection.

Par exemple :

textField.selectionProperty().addListener(observable -> System.out.println("Sélection modifiée dans le champ d'édition !"));

Il existe plusieurs méthodes prêtes à l'emploi pour modifier la sélection dans un champ d’édition :

• deselect() - supprime toute sélection ;
• selectAll() - sélectionne tout le texte ;
• selectBackward() - sélectionne un caractère en arrière en déplaçant le curseur de saisie (suivant la position du curseur de saisie par rapport à la sélection actuelle, peut désélectionner un caractère) ;
• selectEnd() - sélectionne depuis la position actuelle jusqu’à la fin du texte tout en déplaçant le curseur de saisie ;
• selectEndOfNextWord() - sélectionne depuis la position actuelle jusqu’à la fin du prochain mot tout en déplaçant le curseur de saisie ;
• selectForward() - sélectionne un caractère en avant en déplaçant le curseur de saisie (suivant la position du curseur de saisie par rapport à la sélection actuelle, peut désélectionner un caractère) ;
• selectHome() - sélectionne depuis la position actuelle jusqu’au début du texte sans en déplacer le curseur de saisie ;
• selectNextWord() - sélectionne depuis la position actuelle jusqu’au début du prochain mot tout en déplaçant le curseur de saisie ;
• selectPositionCaret() - sélectionne depuis le point actuel et positionne le curseur de saisie à l'endroit indiqué ;
• selectPreviousWord() - sélectionne depuis la position actuelle jusqu’au début du mot précédent tout sans déplacer le curseur de saisie ;
• selectRange() - sélectionne l'intervalle spécifié et déplace le curseur de saisie à la fin de cet intervalle.
  

Pour copier la sélection actuelle d'un champ d’édition dans le presse-papier, il suffit d'appeler la méthode copy() du champ d’édition.

Par exemple :

textField.copy();

Pour couper la sélection actuelle d'un champ d’édition (c'est-à-dire copier sa valeur dans le presse-papier, puis effacer la sélection), il suffit d'appeler la méthode cut() du champ d’édition.

Par exemple :

textField.cut();

Pour coller le contenu du presse-papier dans un champ d’édition, il suffit d'appeler la méthode paste() du champ d’édition. Ceci remplacera la sélection actuelle s'il y en a une, sinon le nouveau contenu sera inséré à l'emplacement du curseur de saisie.

Par exemple :

textField.paste();

Pour savoir si la position du curseur de saisie d'un champ d'édition a été modifiée, il suffit de placer un écouteur de type InvalidationListener ou ChangeListener sur sa propriété en lecture seule caretPosition.

Par exemple :

textField.caretPositionProperty().addListener(observable -> System.out.println("Position du curseur d’édition modifiée dans le champ d'édition !"));

Outre les diverses méthodes qui permettent de changer la sélection dans un champ d’édition, il est possible de spécifier la position du curseur de saisie en appelant la méthode positionCaret() et en lui passant un nouvel indice en paramètre.

Par exemple :

textField.positionCaret(10);

Pour désactiver la saisie sur un contrôle de saisie, vous devez mettre sa propriété editable à la valeur false.

Par exemple :

textField.setEditable(false);

Pour afficher un texte par défaut ou une invite sur un contrôle de saisie, vous devez spécifier une valeur sur sa propriété promptText.

Par exemple :

loginField.setPromptText("Nom d'utilisateur");

Pour procéder à une validation lorsque l'utilisateur appuie sur la touche « Entrée » après avoir saisi son mot de passe, vous devez fournir un callback de type EventHandler<ActionEvent> dans la propriété onAction du champ de saisie de mots de passe.

Par exemple :

1
2
3
4
5
6
7
8
9
10
final PasswordField passwordField = new PasswordField(); 
passwordField.setPromptText("Mot de passe"); 
passwordField.setOnAction(new EventHandler<ActionEvent>() { 
    @Override public void handle(ActionEvent e) { 
        // Validation du mot de passe. 
        // Réaction en cas de mot de passe valide. 
        // Réaction en cas de mot de passe non valide. 
        passwordField.clear(); 
    } 
});

1
2
3
4
5
6
7
8
final PasswordField passwordField = new PasswordField(); 
passwordField.setPromptText("Mot de passe"); 
passwordField.setOnAction(actionEvent -> { 
    // Validation du mot de passe. 
    // Réaction en cas de mot de passe valide. 
    // Réaction en cas de mot de passe non valide. 
    passwordField.clear(); 
});

Pour forcer le retour à la ligne dans une instance de TextArea, vous devez modifier la valeur de sa propriété wrapText et la mettre à la valeur true.

Par exemple :

textArea.setWrapText(true);

JavaFX met à disposition un clavier virtuel pour les champs de saisie lorsqu'une application s’exécute sur une plateforme embarquée.

Il est possible d'activer le clavier virtuel sur un ordinateur de bureau en utilisant le paramètre suivant de la JVM :

-Dcom.sun.javafx.virtualKeyboard=javafx

Il est possible de spécifier le type de clavier virtuel à utiliser sur un contrôle de saisie en modifiant la valeur attachée à la clé "vkType" dans les propriétés du contrôle de saisie. À l'heure actuelle, les valeurs suivantes sont admises :

• "numeric" - un clavier numérique ne contenant que des chiffres ;
• "url" - un clavier destiné à saisir des URL web ;
• "email" - un clavier destiné à saisir des adresses mél ;
• "text" - le clavier par défaut.
  

1
2
3
final TextField emailField = new TextFiel(); 
emailField.setPromptText("Adresse mél"); 
emailField.getProperties().put("vkType", "email");

À partir du JDK8_40, vous pouvez restreindre l’édition sur un contrôle de saisie en spécifiant une valeur de type javafx.scene.control.TextFormatter<V> dans sa propriété textFormatter.

Par exemple :

textField.setTextFormatter(integerOnlyFormatter);

• le filtrage des modifications apportées au contenu du contrôle de saisie (ex. : éviter la saisie de certains caractères) ;
• convertir le texte saisi dans le contrôle par l'utilisateur en une valeur de type V qui sera contenue dans la propriété value du formateur. Dans le cas où le programmeur modifie la propriété value du formateur, celui-ci convertira alors la valeur en texte à afficher dans le contrôle de saisie.
  

Pour placer un filtre sur un formateur, vous devez, lors de son initialisation, lui fournir une instance de l'interface java.util.function.UnaryOperator<TextFormatter.Change> dans un de ses constructeurs. Vous devez implémenter la méthode apply() de l’opérateur unaire pour implémenter le filtrage.

Dans le corps de cette méthode, vous pouvez tester les caractères saisis dans le champ d’édition et valider ou non la modification en fonction de l'objet change reçu en paramètre de la méthode. Si la modification doit être invalidée, il vous suffit de retourner la valeur null. Dans le cas contraire, si la modification doit être validée, vous pouvez retourner l'objet change directement.

Par exemple :

1
2
3
4
5
6
7
8
9
final UnaryOperator<TextFormatter.Change> integerOnlyFilter = new UnaryOperator<TextFormatter.Change>() { 
  
    @Override 
    public TextFormatter.Change apply(TextFormatter.Change change) { 
        final String text = change.getText(); 
        return (text.isEmpty() || text .matches("[0-9]")) ? change : null; 
    } 
}; 
final TextFormatter<Integer> integerOnlyFormatter = new TextFormatter(integerOnlyFilter);

1
2
3
4
5
final UnaryOperator<TextFormatter.Change> integerOnlyFilter = change -> { 
    final String text = change.getText(); 
    return (text.isEmpty() || text .matches("[0-9]")) ? change : null; 
}; 
final TextFormatter<Integer> integerOnlyFormatter = new TextFormatter(integerOnlyFilter);

Pour placer un convertisseur sur un formateur, vous devez, lors de son initialisation, lui fournir une instance de la classe abstraite javafx.util.StringConverter<T> dans un de ses constructeurs. Vous devez implémenter les méthodes fromString() et toString() de la classe pour convertir une chaine de caractères provenant du contrôle de saisie en objet de type T ou un objet de type T en texte à afficher dans le contrôle de saisie.

Par exemple :

1
2
3
4
5
6
7
8
9
10
11
12
13
final StringConverter<Integer> integerConverter = new StringConverter<Integer>() { 
  
    @Override 
    public String toString(Integer value) { 
        return (value == null) ? null : value.toString(); 
    }   
  
    @Override 
    public Integer fromString(String text) { 
        return (text == null || text.trim().isEmpty()) ? null : Integer.parseInt(text.trim()); 
    } 
}; 
final TextFormatter<Integer> integerOnlyFormatter = new TextFormatter(integerConverter, 0, integerOnlyFilter);

À partir du JDK8_40, pour créer un bouton fléché (spinner en anglais), il vous faut créer une instance de la classe javafx.scene.control.Spinner<T>. Ici, T est le type des instances contenues dans le spinner.

Par exemple :

final Spinner spinner = new Spinner();

spinner.setEditable(true);

Pour peupler un bouton fléché, vous pouvez l'initialiser en lui passant une liste de valeurs potentielles lors de sa création :

• il est possible de passer au constructeur une ObservableList<T> contenant les instances des valeurs légales pour le spinner.
  
  Par exemple :
  
  

  Code Java :

  Sélectionner tout

  final Spinner<String> spinner = new Spinner(FXCollections.observableArrayList("Fabrice", "John", "Pierre"));

  
  Ici, le bouton fléché contient des chaines de caractères prédéfinies et sa valeur initiale est « Fabrice ». Il est possible d'utiliser les flèches haut et bas pour naviguer entre les valeurs.
  
  Attention : si le bouton est éditable, il est possible de saisir de nouvelles valeurs, cependant celles-ci ne seront pas automatiquement rajoutées dans la liste des valeurs prédéfinies.
• Dans le cas de nombres entiers ou de nombres flottants, il est possible de spécifier une plage de valeurs légales.
  
  Par exemple :
  
  

  Code Java :

  Sélectionner tout

  final Spinner<Integer> spinner = new Spinner(0, 10, 5);

  
  Ou encore :
  
  

  Code Java :

  Sélectionner tout

  final Spinner<Double> spinner = new Spinner(0d, 10d, 5d);

  
  Ici, le bouton fléché contient la valeur initiale 5 et permet de naviguer dans une plage de valeurs comprises entre 0 et 10 par incrément de 1.
  
  Il est cependant possible de spécifier le pas d’incrément dans le constructeur :
  
  Par exemple :
  
  

  Code Java :

  Sélectionner tout

  final Spinner<Integer> spinner = new Spinner(0, 10, 5, 2);

  
  Ou encore :
  
  

  Code Java :

  Sélectionner tout

  final Spinner<Double> spinner = new Spinner(0d, 10d, 5d, 2d);

  
  Ici, le bouton fléché contient la valeur initiale 5 et permet de naviguer dans une plage de valeurs comprises entre 0 et 10 par incrément de 2.
  
  Attention : si le bouton est éditable, il est possible de saisir de nouvelles valeurs, y compris des valeurs qui ne sont pas des nombres ou qui sont en dehors de la plage de nombres indiquée.
• Enfin, il est possible de spécifier une usine à valeurs (value factory en anglais) en passant en paramètre du constructeur une instance de la classe javafx.scene.control.SpinnerValueFactory<T>. Il est également possible de spécifier une usine à valeurs en modifiant la valeur de la propriété valueFactory du bouton fléché.
  
  Il vous suffit alors de surcharger les méthodes decrement() et increment() de cette classe de manière à modifier le contenu sa propriété value ce qui modifiera la valeur contenue dans le spinner.
  
  Par exemple :
  
  

  Code Java :

  Sélectionner tout

  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  final Spinner<Integer> spinner = new Spinner(new SpinnerValueFactory() { 
    
      @Override 
      public void decrement(int steps) { 
          // Décrémenter la valeur ici. 
          final Integer value = (Integer)getValue(); 
          final int val = (value == null) ? 0 : value; 
          setValue(val - steps); 
      } 
    
      @Override 
      public void increment(int steps) { 
          // Incrementer la valeur ici. 
          final Integer value = (Integer)getValue(); 
          final int val = (value == null) ? 0 : value; 
          setValue(val + steps); 
      } 
  });

  
  Ici, nous créons une fabrique à valeurs entières. Cependant, comme nous n'avons pas spécifié de valeur initiale, le bouton fléché est initialement vide. Pour pallier ce problème, il nous faudrait également surcharger le constructeur de la classe anonyme.
  
  Par exemple :
  
  

  Code Java :

  Sélectionner tout

  1
  2
  3
  4
  5
  6
  7
  final Spinner<Integer> spinner = new Spinner(new SpinnerValueFactory() { 
      { 
          setValue(5); 
      } 
    
      [...] 
  });

  
  Ici, le bouton fléché est initialisé à la valeur 5.
  
  Utiliser une telle fabrique permet par exemple de faire un spinner permettant de naviguer à travers un ensemble infini de valeurs numériques, d'avoir un pas d’incrément non linéaire (ex. : passé une certaine valeur on saute de 10 en 10, puis de 100 en 100, etc.) ou encore de récupérer des valeurs en effectuant une requête web ou auprès d'une base de données.
  
  La classe SpinnerValueFactory dispose de plusieurs implémentations/classes filles statiques prêtes à l'emploi telles que IntegerSpinnerValueFactory, etc.
  
  Attention : une fois de plus, si le bouton fléché est éditable, il peut accepter n'importe quelle valeur, même celles qui ne sont pas générées par l'usine à valeurs.
  

Pour récupérer la valeur d'un bouton fléché, vous pouvez accéder à sa propriété en lecture seule value.

Par exemple :

final Integer value = spinner.getValue();

Vous ne pouvez pas directement modifier la valeur d'un bouton fléché. Cependant, vous pouvez invoquer ses méthodes increment() et decrement() pour que le bouton interroge son usine à valeurs de manière à produire une nouvelle valeur qui sera alors appliquée au bouton. Il est possible de fournir un pas lorsqu'on invoque une de ces méthodes.

Par exemple :

spinner.increment();

spinner.decrement(10);

spinner.getValueFactory().setValue(5);

Pour restreindre l'édition sur un bouton fléché, vous devez spécifier un formateur dans la propriété textFormatter de l’éditeur du bouton fléché.

Par exemple :

spinner.getEditor().setTextFormatter(integerOnlyFormatter);