Oracle Accessibility Conformance Report

The product was tested for:

• Images that convey information are embedded within standard user interface components and have a meaningful AccessibleName and/or AccessibleDescription
• Images that are decorative are embedded within standard user interface components and have neither an AccessibleName nor an AccessibleDescription
• Information shown in complex images such as charts is also available in an alternative textual form (e.g. a data table), or the containers of the complex images are filled with simple image children whose information is exposed via AccessibleName and/or AccessibleDescription
• Data tables include a summary or caption, programmatically connected with the table as the AccessibleTable's AccessibleSummary
• Controls have an AccessibleName, or a label control with an AccessibleName has been programmatically associated with it
• Time-based media is not used
• Non-text characters are not used
• CAPTCHAs are not used

Exceptions:

• Bug 25919240: Accessible JTables always reported as empty on macOS platform. In case to click or use the keyboard to navigate the table, VoiceOver says nothing.
• Bug 25961034: VoiceOver says nothing as a JTree tree is navigated, expanded/collapsed, selected.
• Bug 25961038: VoiceOver reads percentages rather than the actual values for sliders on macOS platform.
• Bug 25961113: When focus is gained on a non-editable combo box VoiceOver does not read the value on macOS platform. VoiceOver doesn't read the contents of the combo box. Suggested workaround: hover the mouse over the Combobox control and try to switch or select from the list then user could hear the value.
• Bug 25961164: VoiceOver announces spin box control as radio button on macOS platform.
• Bug 25961174: Checkbox toggles on Space press but is not spoken by VoiceOver. Suggested workaround: move focus away and back again.
• Bug 29992069: Can edit text cell correctly, but VoiceOver read nothing about edited text on macOS platform and on Windows platform.
• Bug 31309238: JAWS and VoiceOver do not always announce the value of JSliders in JColorChooser after Slider is moved on macOS platform and on Windows platform.

The documentation was tested for:

• Images that convey information have meaningful alternative text using ALT or longer descriptive text in a separate page
• Images that are decorative are marked up using ALT="" or CSS background images
• Information shown in complex images such as charts is also available in an alternative textual form (e.g. a data table)
• Controls have an associated name
• Time-based media is not used
• Non-text characters are not used
• CAPTCHAs are not used

The product was tested for:

• User interface component labels are associated with the fields they are labeling via the LabelFor and LabeledBy relations
• Headings are marked as such with a Group relation from the header to the items beneath the header
• Groups of components are marked as such, with a Group relation from the header of the group to the members of the group
• Style sheets are used only to change the layout and presentation on the screen
• Lists are contained within a List component
• Tables are contained within a Table component, implement the AccessibleTable interface, provide an AccessibleSummary, and contain include row and column headers where appropriate

The documentation was tested for:

• Headings are encoded with HTML heading tags
• List markup is used for marking up lists
• Table markup is used for marking up data tables, including row and column headers and table captions/summaries where appropriate
• Data tables specify SUMMARY or CAPTION
• Layout tables use appropriate markup

The product was tested for:

• The accessibility hierarchy is logical

The documentation was tested for:

• The sequence of elements in the DOM matches a logical reading sequence

The product was tested for:

• Instructions provided do not refer to things solely based on their sensory characteristics such as shape, size, visual location, orientation, color, or sound

The documentation was tested for:

• Instructions provided do not refer to things solely based on their sensory characteristics such as shape, size, visual location, orientation, color, or sound

The product was tested for:

• Text is displayed in both device orientations without loss of functionality or visibility of the text.
• The view and operation are an application function allowed by Operating System. Java UI Toolkit (Swing) neither enable nor prevent an application supporting this.

The documentation was tested for:

• Text is displayed in both device orientations without loss of functionality or visibility of the text.
• Javadoc is working in a browser - if orientation works for the browser, it works for Javadoc.

The product was tested for:

• Text fields which collect information about the user contain the appropriate autocomplete content attribute.
• Input Purpose identification and Auto-complete are an application function allowed by Operating System. Java UI Toolkit (Swing) neither enable nor prevent an application supporting this.

The documentation was tested for:

• Text fields which collect information about the user contain the appropriate autocomplete content attribute.
• Javadoc itself doesn’t have any Input box, just links

The product was tested for:

• Information conveyed by color is available in alternative formats, such as shape, text, font weight
• Information conveyed by color has a contrast ratio of at least 3:1

The documentation was tested for:

• Information conveyed by color is available in text

The product was testing for:

• Large-scale text and images of large-scale text have a contrast ratio of at least 3:1
• Other text and images of text have a contrast ratio of at least 4.5:1

The documentation was tested for:

• Text and images of text have a contrast ratio of at least 4.5:1

The product was tested for:

• Text resizes up to 200% using the platform's Large Print or enlarged font setting
• Text (and application) resizes up to 200% using the platform's built-in magnifier or zoom feature

The documentation was tested for:

• Text can be resized up to 200% without loss of content or functionality

The product was tested for:

• Images have meaningful alternative text and repeated images and icons have a consistent alternate text.

The documentation was tested for:

• Images of text are only used when the technology can't create the desired visual presentation, the image can be customized or the particular image is essential

The product and documentation were tested for:

• Text information reflows so that only one direction of scrolling is required while at 400% zoom.
• Content that requires two-dimensional layout only presents scroll bars in the component used to present the two-dimensional content.
• Javadoc is an HTML web page - there may be scrolling necessary if the content of the page doesn’t completely fit in the viewing area

The product was tested for:

• The visual presentation of the User Interface Components and Graphical Objects have a contrast ratio of at least 3:1

The Documentation was tested for:

• The visual presentation of the User Interface Components and Graphical Objects have a contrast ratio of at least 3:1

The product was tested for:

• The product does not have content implemented using markup languages that support editing the text style properties in this criteria
• Java2D and Swing provides enough APIs for an application to support this by doing its own text layout, but there's no high level UI components that do it, it means the application defines the mark up language then the application is on the hook for this

The documentation was tested for:

• Line height (line spacing) to at least 1.5 times the font size
• Spacing following paragraphs to at least 2 times the font size
• Letter spacing (tracking) to at least 0.12 times the font size
• Word spacing to at least 0.16 times the font size

The product was tested for:

• Dismissable -The content can be dismissed without moving the pointer or keyboard focus
• Hoverable - When pointer hover triggers additional content, the pointer can be moved over the additional content without the additional content disappearing
• Persistent - The additional content remains visible until the hover or focus trigger is removed, the user dismisses it, or its information is no longer valid
• There is no content that appears on hover or focus

Not applicable for documentation

The product was tested for:

• The GUIs can be navigated by keyboard only.

Exceptions:

• Bug 25919248: Alt doesn’t move to menubar; Alt + aKey doesn’t activate menu. Suggested workaround: F10 can be used to move to the menubar.
• Bug 25961312: VoiceOver cursor doesn't track Swing keyboard focus on macOS. When using the menu system the VoiceOver cursor starts off on the first menu item but doesn't track focus when the arrow keys are used to move within a menu.

The documentation was tested for:

• Ability to perform functions from the keyboard only, and without requiring specific timings for individual keystrokes
• Proper operation of unique keystrokes and access keys
• The ability to use the product with OS keyboard aids: StickyKeys and FilterKeys (feature names may be different on different platforms)

The product was tested for:

• Movement of focus through each control only using the keyboard, with no "keyboard trap" that prevents focus from moving away from any control

The documentation was tested for:

• Movement of focus through each control only using the keyboard, with no "keyboard trap" that prevents focus from moving away from any control

The product was tested for:

• Single character keyboard shortcuts can be turned off
• Single character keyboard shortcuts can be remapped
• Single character keyboard shortcuts are only active when that component has focus

Not applicable for documentation

The product was tested for:

• Time limits are not used

The documentation was tested for:

• Time limits are not used

The product was tested for:

• Moving, blinking, scrolling information can be paused.

The documentation was tested for:

• There is no moving, blinking or scrolling content

The product was tested for:

• No portion of the screen flickers or flashes with a frequency between 2 Hz and 55 Hz

The documentation was tested for:

• No portion of the screen flickers or flashes with a frequency between 2 Hz and 55 Hz

Oracle non-Web software products, including bundles and suites of software, do not behave as a set of software programs  as the term is defined. Therefore this guideline does not apply.

The documentation was tested for:

• A ‘Skip to Main Content’ link is provided to skip repetitive navigation links at the top of the page.
• Structure and hierarchy is marked up with Header elements outside of repetitive navigation links.

The product was tested for:

• The name of the software application is meaningful.

The documentation was tested for:

• Pages have a meaningful title specified in the TITLE element

The product was tested for:

• Logical movement through the focusable components using only the keyboard, in an order that follows a meaningful sequence.

The documentation was tested for:

• Logical movement through the focusable components using only the keyboard, in an order that follows a meaningful sequence.

The product was tested for:

• The text of links and their surrounding paragraph, list, table cell (with marked up table headers) is sufficient to describe their purpose.

The documentation was tested for:

• The text of links and their surrounding paragraph, list, table cell (with marked up table headers) is sufficient to describe their purpose.

The JavaDoc was tested for:

• Page contains controls that enable reaching all pages

This guideline does not apply for the non-Web portion of the product. 

The documentation was tested for:

• Pages can be found using the provided "search" function
• Pages are in a site table of contents

The product was tested for:

• Headers describe the topic or purpose of the content below them
• Labels describe the purpose of the associated field

The documentation was tested for:

• Headers describe the topic or purpose of the content below them
• Labels are not used

The product was tested for:

• Visual indication of the location of the focus

Exceptions:

• Bug 28896104: The focus disappears after pressing Return to close the popped up input dialog on macOS.

The documentation was tested for:

• Visual indication of the location of the focus

The product was tested for:

• Multipoint or path-based gesture actions can be completed using a different input modality.
• The multipoint or path-based gestures for operation and pointer actions are an application function allowed by Operating System. Java UI Toolkit (Swing) neither enable nor prevent an application supporting this.

Not applicable for documentation:

• There are no multipoint or path-based gesture actions.

The product was tested for:

• When an operation uses a single pointer, the down-event of the pointer is not used to execute any part of the function
• When an operation uses a single pointer, completion of the function is on the up-event, and a mechanism is available to abort the function before completion or undo the function after completion
• When an operation uses a single pointer, the up-event reverses any outcome of the preceding down-event
• The pointer actions using a single pointer are an application function allowed by Operating System. Java UI Toolkit (Swing itself) neither enable nor prevent an application supporting this

Not applicable for documentation:

• The pointer actions using a single pointer are an application function supported by Operating System, not a Toolkit one. We neither enable nor prevent an application supporting this

The product was tested for:

• User interface components that include text or images of text and have a label, have a name that contains the text that is presented visually

The documentation was tested for:

• User interface components with labels that include text or images of text, the name contains the text that is presented visually

The product and documentation were tested for:

• There are no functions that require motion of the device.

The product was tested for:

• Properly set locale/language

The documentation was tested for:

• Properly set lang attribute for each page

The product was tested for:

• Properly set locale/language for text passages that are in a different language than that of the software

The documentation was tested for:

• Proper use of the lang attribute for text passages that are in a different language than that of the page.

The product was tested for:

• When an element receives focus, it does not result in a substantial change to the user interface of the software, an additional change of keyboard focus, or the spawning of a new window

The documentation was tested for:

• When an element receives focus, it does not result in a substantial change to the page, an additional change of keyboard focus, or the spawning of a pop-up window

The product was tested for:

• Changes in the value of user interface components does not result in a substantial change to the user interface of the software, an additional change of keyboard focus, or the spawning of a new window

The documentation was tested for:

• User interface components are not used

The JavaDoc was tested for:

• Pages that are grouped together into sets with a common navigation mechanism utilize that navigation mechanism in the same fashion, with navigation elements appearing in the same relative order each time
• There are no navigational mechanisms that are repeated

Oracle non-Web software products, including bundles and suites of software, do not behave as a set of software programs  as the term is defined. Therefore this guideline does not apply.

The documentation was tested for:

• Pages that are grouped together into sets with a common navigation mechanism utilize that navigation mechanism in the same fashion, with navigation elements appearing in the same relative order each time

The product was tested for:

• Images and controls are used and identified consistently throughout the product

The documentation was tested for:

• Images and controls are used and identified consistently throughout the product

The product was tested for:

• When input errors are detected, they are described to the user in text, including identifying the item where the error occurred

The documentation was tested for:

• The documentation does not have input fields, except for the Search field.

The product was tested for:

• Labels or instructions are provided when the product requires user input

The documentation was tested for:

• Labels or instructions are provided when the product requires user input

The product was tested for:

• Where suggestions for fixing an input error are known, they are provided to the user

The documentation was tested for:

• The documentation does not have input fields, except for the Search field.

The product was tested for:

• Submissions are generally reversible, and if they are complicated to reverse, Oracle JDK asks for confirmation from user before submission.

The documentation was tested for:

• The documentation does not allow for changes to data.

The product was tested for:

• Markup elements have complete start and end tags, are properly nested, do not contain duplicate attributes, and have unique Ids
• Markup content validate to the appropriate markup specification(s)
• Markup languages aren't used to generate the user interface

The Java API documentation is generated by the javadoc tool using the Java source files as input. The tool produces accessible HTML if the input is well-formed.

The documentation was tested for:

• Elements in HTML content have complete start and end tags, are properly nested, do not contain duplicate attributes, and have unique IDs
• Pages validate to the HTML specification

Exceptions: there are some HTML4 issues in the JavaDocs:

Bug 29264790 and Bug 29264761: The Java API documentation is generated by the javadoc tool using the Java source files as input. The tool produces accessible HTML if the input is well-formed. When the Java class files include documentation that are not well-formed and thus making the output not accessible for AT

The product was tested for:

• User interface components have a programmatically associated AccessibleName and AccessibleRole as defined by the Java Accessibility API
• State information, properties, and values are programmatically exposed for user interface components
• Event notification of changes to names, states, properties, and values is available to assistive technologies

The documentation was tested for:

• HTML controls have a programmatically associated name, derived from the appropriate HTML elements and attributes including LABEL, TITLE, SUMMARY, CAPTION, etc.

The product and documentation were tested for:

• There are no status messages.
• Java UI Toolkit (Swing itself) doesn't show mark up language features and Status messages as well

Platform software provides user control over platform features defined in platform documentation covers the Java SE JDK on the Windows and macOS platforms.

We recommend developers use Swing controls whenever possible to implement accessible UI for their applications. Applications written using AWT will not be accessible.

The product was tested for:

• Software does not disrupt platform features that are defined in the platform documentation as accessibility features.

The product was tested for:

• User interface components have a programmatically associated AccessibleName and AccessibleRole as defined by the Java Accessibility API
• State information, properties, and values are programmatically exposed for user interface components
• Event notification of changes to names, states, properties, and values is available to assistive technologies

The product was tested for:

• State information, properties, and values are programmatically exposed for user interface components
• Event notification of changes to names, states, properties, and values is available to assistive technologies

The product was tested for:

• User interface component labels are associated with the fields they are labeling via the LabelFor and LabeledBy relations
• Headings are marked as such with a Group relation from the header to the items beneath the header
• Groups of components are marked as such, with a Group relation from the header of the group to the members of the group
• Style sheets are used only to change the layout and presentation on the screen
• Lists are contained within a List component
• Tables are contained within a Table component, implement the AccessibleTable interface, provide an AccessibleSummary, and contain include row and column headers where appropriate

The product was tested for:

• State information, properties, and values are programmatically exposed for user interface components
• Event notification of changes to names, states, properties, and values is available to assistive technologies

The product was tested for:

• Event notification of changes to names, states, properties, and values is available to assistive technologies

The product was tested for:

• User interface component labels are associated with the fields they are labeling via the LabelFor and LabeledBy relations

The product was tested for:

• The accessibility hierarchy is logical

The product was tested for: User interface components that display text either:

• Expose a copy of their text as the AccessibleName (e.g. the text of a JButton), and/or
• Expose their text via the AccessibleText interface.

The product was tested for: User interface components that display text either:

• Expose a copy of their text as the AccessibleName (e.g. the text of a JButton), and/or
• Expose their text via the AccessibleText interface.

The product was tested for:

• Properly execute a list of actions

The product was tested for:

• Properly execute available actions on objects

The product was tested for:

• Visual indication of the location of the focus cursor, focus tracking, text insertion point and selection attributes
• User interface components have a programmatically associated AccessibleName and AccessibleRole as defined by the Java Accessibility API
• State information, properties, and values are programmatically exposed for user interface components
• Event notification of changes to names, states, properties, and values is available to assistive technologies

Exception:

• Bug 25961312: VoiceOver cursor doesn't track Swing keyboard focus on macOS. When using the menu system the VoiceOver cursor starts off on the first menu item but doesn't track focus when the arrow keys are used to move within a menu.
• Bug 28896104: The focus disappears after pressing Return to close the popped up input dialog on macOS.

The product was tested for:

• Visual indication of the location of the focus modification

The product was tested for:

• Event notification of changes to names, states, properties, descriptions, boundaries and values is available to assistive technologies

The product was tested for:

• No automatically playing audio is used
• No Pre-recorded audio-only content is being used
• No live audio content is being used
• Enable sequential entry of multiple (chorded) keystrokes
• Provide adjustment of delay before key acceptance
• Provide adjustment of same-key double-strike acceptance

The product was tested for:

• Responds to platform settings for color, contrast, font type, font size, and focus cursor

JDK 8 provides Java Access Bridge and Java Accessibility API (JAAPI) that enable you to create accessible applications. See the Java Accessibility Guide for more information:

https://docs.oracle.com/javase/8/docs/technotes/guides/access/index.html

Product documentation is in electronic format.