Braille Layout Mode
This is a "spec in progress" (see Bug 400732)
Orca should provide two primary modes of braille presentation. The default is logical mode which is a braille mode consisting of the item with focus as well as relevant contextual information. The second will be called window layout mode. This mode will accurately convey the actual layout of the screen. Wherever possible the information presented while navigating the screen with the braille display should match what is displayed while focus tracking. See the current implementation of braille support for examples on logical mode.
Window layout mode should where ever possible attempt to accurately present each line of the display. Except for a few cases documented below Orca will not append contextual or extra role information to the braille display.
Presentation by Role
The following examples will show how various pieces of information should be presented on the braille display by Orca in this mode. The following apply to GTK, Java, OpenOffice, and web applications:
Checkboxes should be indicated by the braille checkbox marker for checked partially checked, and "< >" for not checked. This marker should be followed by the label.
Combobox labels and entries should be presented wherever they appear. Depending on user feedback we may have to suffix this with the role but lets not do this unless many users ask for it.
Frame and Panel Labels
Frame and panel labels should be presented in relation to what they are labeling. For example the label for a panel should be above the controls in the panel.
Icon groups such as the desktop should appear as they are presented on the screen. For example, if three icons appear next to each other on the desktop Orca should attempt to place them on the braille display. Orca should make sure that at least the icon with focus is on the braille display.
Menus should simply present the text of each menu item on the braille display as it is encountered. If a user presses a cursor routing key over one of the items that item should be activated.
Menu bars should simply present the text of the menu bar across the braille display. If a user presses a cursor routing key over one of the items that item should be activated.
Radio button group labels should be presented in relation to what they are labeling. For example the label for a button group should be above the actual radio buttons.
Radio buttons should be indicated by the radio button braille marker for selected and for not selected. This marker should be followed by the label if one exists.
Sliders and Scrollbars
Sliders and Scrollbars should be presented as the value followed by the role name. This is an exception to our normal screen mode presentation because if we present just the value the user may have trouble inferring the context. Vertical scrollbars should be presented at the top of the window on which ever side of the window they appear.
Text should be presented honoring the actual layout as much as possible. If space is present it should be accurately displayed on the braille display. It is OK to continue using the tab character to show the location of tabs. Presentation of attributes will be handled in a separate RFE. If text is selected or attributes are requested in the braille preferences of the Orca configuration UI they should also be shown according to the user's preference.
Even though the window title information is not always visible on the screen and can not be focused the title should be presented at the top of the window.
These modes can be switched by the use of a radio button group in the braille section of the Orca configuration UI. The group will be called "braille layout" and the buttons will be: "window layout" and "logical layout"