There are 2 gray areas that must be clarified with respect to node's focusability -
1. A node will not gain focus unless key listener attributes are defined for it. This is not explicitly clarified in the API documentation and also the 'Focusable' attribute is true by default. So one may assume that the node is by default focusable. This has to be clarified explicitly.
2. SwingComponents handle keyevents by themselves and hence do not have the above requirement. But from FX Standpoint, SwingComponent is just another node but still does not follow the node's notion of focusability given above. So this is an exception and this exception should be documented appropriately. Otherwise, one may think that it is a bug that a non-swing node is not gaining focus while a swing counterpart does.
There are also other concerns on the 'Focusable' attribute not reflecting the true focusable state of the node. More details can be found in the dicussion given under 'Comments' section.
1. A node will not gain focus unless key listener attributes are defined for it. This is not explicitly clarified in the API documentation and also the 'Focusable' attribute is true by default. So one may assume that the node is by default focusable. This has to be clarified explicitly.
2. SwingComponents handle keyevents by themselves and hence do not have the above requirement. But from FX Standpoint, SwingComponent is just another node but still does not follow the node's notion of focusability given above. So this is an exception and this exception should be documented appropriately. Otherwise, one may think that it is a bug that a non-swing node is not gaining focus while a swing counterpart does.
There are also other concerns on the 'Focusable' attribute not reflecting the true focusable state of the node. More details can be found in the dicussion given under 'Comments' section.