FAQ JavaFXConsultez toutes les FAQ

Oui, JavaFX supporte l'accessibilité depuis sa version 8_40.

Depuis cette version, la classe Node dispose de nouvelles propriétés permettant à un assistant d'accessibilité, par exemple une liseuse d’écran, de récupérer les descriptions, attributs et actions disponibles sur un nœud quelconque et d’interagir avec lui. Cela signifie qu'il est désormais possible de rendre accessible n'importe quel nœud graphique qui est affiché dans une scène.

Les contrôles existants de l'API SceneGraph ont également été mis à jour pour supporter ces nouvelles fonctionnalités. Les Q/R suivantes vous sont destinées si vous devez être amenés à implémenter l’accessibilité dans vos nœuds et contrôles customisés.

Pour savoir si le support de l'accessibilité est activé, vous pouvez vérifier la valeur de la propriété statique en lecture seule accessibilityActive de la classe javafx.application.Platform. Cette propriété est mise à la valeur true lorsqu'un assistant d'accessibilité, tel qu'une liseuse d’écran, tente d’accéder à une fenêtre ou un nœud JavaFX pour la première fois.

Par exemple :

final boolean accessibilityActive = Platform.isAccessibilityActive();

Pour spécifier l'aide d'accessibilité d'un nœud, vous devez fournir une chaine de caractères dans la propriété accessibleText de ce nœud. Cette valeur permet de spécifier une description courte du nœud ou du contrôle.

validadeButton.setAccessibleText("Bouton de validation");

Pour spécifier l'aide d'accessibilité d'un nœud, vous devez fournir une chaine de caractères dans la propriété accessibleHelp de ce nœud. Cette valeur permet de spécifier une description longue du nœud ou du contrôle et ainsi que de son fonctionnement.

Par exemple :

validadeButton.setAccessibleHelp("Ce bouton sert à valider cet écran de paramètres avant de lancer le calcul. Cliquer sur ce bouton refermera cette boite de dialogue.");

Pour spécifier le rôle d'accessibilité d'un nœud, vous devez modifier la valeur de sa propriété accessibleRole et lui fournir une instance de l’énumération javafx.scene.AccessibleRole.

Le rôle permettra de mieux décrire le nœud à un assistant d'accessibilité. De plus, ce dernier pourra alors attendre en retour la présence de certains attributs et la possibilité de faire certaines actions sur ce nœud.

Par exemple, si nous créons un nouveau contrôle, nous pouvons indiquer que ce dernier se comporte en fait comme un bouton :

myControl.setAccessibleRole(AccessibleRole.BUTTON);

• AccessibleRole.BUTTON - le nœud est considéré comme étant un bouton.
  L'assistant d'accessibilité s'attend donc à trouver les attributs suivants :
  
  • AccessibleAttribute.TEXT - contient le texte du bouton.
    
  
  L'assistant d'accessibilité s'attend à pouvoir effectuer les actions suivantes :
  
  • AccessibleAction.FIRE - active le bouton.
    
• AccessibleRole.COMBO_BOX - le nœud est considéré comme étant une boite déroulante.
  L'assistant d'accessibilité s'attend donc à trouver les attributs suivants :
  
  • AccessibleAttribute.TEXT - contient le texte de la valeur sélectionnée dans la boite déroulante.
  • AccessibleAttribute.EXPANDED - indique si le menu surgissant de la boite déroulante est affiché.
  • AccessibleAttribute.EDITABLE - indique si la boite déroulante est éditable.
    
  
  L'assistant d'accessibilité s'attend à pouvoir effectuer les actions suivantes :
  
  • AccessibleAction.EXPAND - affiche le menu surgissant de la boite déroulante.
  • AccessibleAction.COLLAPSE - cache le menu surgissant de la boite déroulante.
    
  
  

1
2
3
4
5
6
7
8
9
@Override 
public Object queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters) { 
    if (attribute == AccessibleAttribute.TEXT) { 
        // Retourner le texte de notre faux bouton. 
        [...] 
    } else { 
        return super.queryAccessibleAttribute(attribute, parameters); 
    } 
}

1
2
3
4
5
6
7
8
9
@Override 
public void executeAccessibleAction(AccessibleAction action, Object... parameters) { 
    if (action == AccessibleAction.FIRE) { 
        // Activer notre faux bouton. 
        [...] 
    } else { 
        super.executeAccessibleAction(action, parameters); 
    } 
}

Pour spécifier la description du rôle d'accessibilité d'un nœud, vous devez fournir une chaine de caractères dans la propriété accessibleRoleDescription de ce nœud. En effet, l'assistant d'accessibilité utilise généralement des descriptions prédéfinies pour les divers rôles possibles, cette valeur permet de spécifier une description du rôle customisée plutôt que d'utiliser celle par défaut.

Par exemple :

validadeButton.setAccessibleRoleDescription("Bouton principal");

Lorsque vous modifiez la valeur d'une propriété d'un nœud associée à un attribut d'accessibilité, vous devez notifier l'assistant d'accessibilité que la valeur de cet attribut a été modifiée. Vous pouvez le faire en invoquant la méthode notifyAccessibleAttributeChanged() de la classe Node et en lui passant en paramètre l'attribut dont la valeur a changé.

Par exemple :

myControl.notifyAccessibleAttributeChanged(AccessibleAttribute.TEXT);