Introduction to Accessible ADF Faces Pages

22-4 Web User Interface Developers Guide for Oracle Application Development Framework The same access key can be bound to several components. If the same access key appears in multiple locations in the same page, the rendering agent will cycle among the components accessed by the same key. That is, each time the access key is pressed, the focus will move from component to component. When the last component is reached, the focus will return to the first component. Using access keys on af:goButton and af:goLink components may immediately activate them in some browsers. Depending on the browser, if the same access key is assigned to two or more go components on a page, the browser may activate the first component instead of cycling through the components that are accessed by the same key. To develop accessible page and navigation structures follow the additional accessibility guidelines described in Section 22.4, Creating Accessible Pages.

22.3.1 ADF Faces Component Accessibility Guidelines

To develop accessible ADF Faces components, follow the guidelines described in Table 22–1 . Components not listed do not have accessibility guidelines. Note: Access keys are not displayed if the accessibility mode is set to screenReader mode. For more information, see Section 22.2, Exposing Accessibility Preferences. Note: In cases where the label property is referenced in the accessibility guidelines, the labelAndAccessKey property may be used where available, and is the preferred option. Unless noted otherwise, you can also label ADF Faces input and select controls by: ■ Specifying the for property in an af:outputLabel component ■ Specifying the for property in an af:panelLabelAndMessage component Table 22–1 ADF Faces Components Accessibility Guidelines Component Guidelines af:chooseColor For every af:chooseColor component, there must be at least one af:inputColor component with a chooseId property which points to the af:chooseColor component. af:chooseDate For every af:chooseDate component, there must be at least one af:inputDate component with a chooseId property which points to the af:chooseDate component af:commandButton One of the following properties must be specified: text, textAndAccessKey, or shortDesc. The text should specify the action to be taken and make sense when read out of context. For example use go to index instead of click here. Developing Accessible ADF Faces Pages 22-5 af:commandLink Specify the text property. The text should specify where the link will take the user and make sense when read out of context. For example use go to index instead of click here. Multiple links that go to the same location must use the same text and unique links must have unique text. af:commandMenuItem af:commandNavigationItem af:comandToolbarButton One of the following properties must be specified: text, textAndAccessKey, or shortDesc. af:dialog af:document Specify the title property. af:goButton One of the following properties must be specified: text, textAndAccessKey, or shortDesc. The text should specify the action to be taken and make sense when read out of context. For example use go to index instead of click here. af:goLink Specify the text property. The text should specify where the link will take the user and make sense when read out of context. For example use go to index instead of click here. Multiple links that go to the same location must use the same text and unique links must have unique text. af:image Specify the shortDesc property. If the image is only present for decorative purposes and communicates no information, set shortDesc to the empty string. Use the longDescURL property for images where a complex explanation is necessary. For example, charts and graphs require a description file that includes all details that make up the chart. af:inlineFrame Specify the shortDesc property. af:inputColor af:inputComboboxListOfVal ues af:inputDate af:inputFile af:inputListOfValues af:inputNumberSlider af:inputNumberSpinbox af:inputRangeSlider af:inputText Specify the label property. For af:inputComboboxListOfValues and af:inputListOfValues components, the searchDesc must also be specified. af:outputFormatted The value property must specify valid HTML. af:outputLabel When using this component to label an ADF Faces input or select control, the for property must be specified. af:panelBox af:panelHeader Specify the text property. af:panelLabelAndMessage When using this component to label an ADF Faces input or select control, the for property must be specified. af:panelSplitter af:panelStretchLayout Refer to Section 22.4.4, How to Use Page Structures and Navigation. Table 22–1 Cont. ADF Faces Components Accessibility Guidelines Component Guidelines