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);